Is this Google's Place Details API?

No. It returns the public Google Maps listing a logged-out visitor sees, parsed as JSON. There's no Google Cloud account and no per-field pricing: 1 credit per place.

Where do I get a place ID?

From the Google Maps or Places API: every result includes place_id, cid and fid. Any one of them works here.

How do I tell if a place is open now?

Use weekly_hours with timezone: each day lists local {open, close} times. "24:00" is midnight, next_day: true marks an interval that ends after midnight, and an empty list means closed that day.

Does it work in other languages?

Yes. The address, categories, hours text and description follow language, Russian included (language="ru" gives "Ресторан" and "24 часа в сутки"). weekly_hours, country and timezone don't change with the language.

What if the ID is wrong?

If no place has that identifier, results is empty and the call isn't billed.

POST /v1/place

Google Place Details API

Look up one place by place ID, CID or feature ID and get its full Google Maps listing: address, country, coordinates, time zone, opening hours as text and as structured data, phones, website, rating, description and photos.

Get a free API key Try in playground

1 credit per place 2,500 free credits, no card Failed calls are free

Overview

What the Google Place Details API does

The Place Details API returns the public Google Maps listing of one place. Identify it with place_id, cid or fid (all three come back from the Maps and Places APIs). The address, categories, hours text and description come in language.

Opening hours come twice: opening_hours as Google displays them, and weekly_hours as local 24-hour intervals per weekday, with the place's IANA timezone, so you can tell whether a place is open now without parsing text. Up to 10 photos come with public URLs you can fetch server-side.

One place costs 1 credit, with no per-field SKUs. An identifier that matches no place returns empty results and isn't billed.

What you get

results[0] object: title, address, country (ISO code), latitude, longitude, timezone (IANA), rating, rating_count, price_level, type, types, website, phone_number, international_phone_number, opening_hours, weekly_hours, description, photos, thumbnail_url, google_maps_url, place_id, cid, fid.
weekly_hours object: monday … sunday, each a list of {open, close} local times (HH:MM). Closed is [], open 24 hours is [{"open":"00:00","close":"24:00"}], and an interval past midnight has next_day: true.
photos[] array: Up to 10: url, width, height and source (business or visitor).
request object: Echo of the normalized request (endpoint, engine, q, country, language, page…), handy for logging.
meta object: request_id, credits_used, cached, engine, latency_ms, resolved_urls and parse_quality. parse_quality=empty means the call was not billed.

Request

POST /v1/place

cURL

Python

TypeScript

fetch

PHP

curl https://api.serpkite.com/v1/place \
  -H "Authorization: Bearer $SERPKITE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"place_id":"ChIJ94DTm1cDdkgRibmgxzXy2EQ","country":"gb"}'

Response (illustrative, placeholder domains)

200 OK · application/json (trimmed)

{
  "request": {
    "endpoint": "place",
    "engine": "google",
    "place_id": "ChIJ94DTm1cDdkgRibmgxzXy2EQ",
    "country": "gb",
    "language": "en"
  },
  "results": [
    {
      "title": "Monmouth Coffee Company",
      "address": "2 Park St, London SE1 9AB",
      "country": "GB",
      "latitude": 51.5055334,
      "longitude": -0.0914069,
      "timezone": "Europe/London",
      "rating": 4.5,
      "rating_count": 3039,
      "type": "Coffee shop",
      "types": [
        "Coffee shop",
        "Cafe"
      ],
      "website": "http://www.monmouthcoffee.co.uk/",
      "phone_number": "020 7232 3010",
      "international_phone_number": "+44 20 7232 3010",
      "description": "Fair-trade coffee & gourmet treats in the cafe & whole or freshly ground beans bagged to take home.",
      "opening_hours": {
        "Monday": "7:30 am–6 pm",
        "Sunday": "Closed"
      },
      "weekly_hours": {
        "monday": [
          {
            "open": "07:30",
            "close": "18:00"
          }
        ],
        "sunday": []
      },
      "photos": [
        {
          "url": "https://lh3.googleusercontent.com/…=w741-h472-k-no",
          "width": 741,
          "height": 472,
          "source": "business"
        }
      ],
      "google_maps_url": "https://maps.google.com/?cid=4960981302344989065",
      "place_id": "ChIJ94DTm1cDdkgRibmgxzXy2EQ",
      "cid": "4960981302344989065",
      "fid": "0x487603579bd380f7:0x44d8f235c7a0b989"
    }
  ],
  "meta": {
    "request_id": "req_01J8ZK4M6Q2V7",
    "credits_used": 1,
    "engine": "google",
    "cached": false,
    "latency_ms": 812,
    "resolved_urls": true,
    "parse_quality": "ok"
  }
}

Every response also carries X-Credits-Used, X-Credits-Remaining, X-Cache and X-Tokens-Estimate headers. Run this query in the playground

Reference

Parameters

The parameters /v1/place accepts, in the JSON body or the query string.

Google Place Details API parameters
Name	Type	Default	Description
`place_id` required	string	–	Google place ID ("ChIJ…"). Or pass cid or fid instead (one of the three is required).
`cid`	string	–	Google customer ID (CID) of the place.
`fid`	string	–	Google feature ID of the place ("0x…:0x…").
`country`	string	us	Country code (ISO 3166-1 alpha-2): Google's regional view of the listing.
`language`	string	en	Language of the address, categories, hours and description (en, ru, de…).
`format`	string	json	Response format. markdown is LLM-ready prose; compact is JSON with only the fields agents need. Values: json, compact, markdown.
`fields`	string	–	Comma-separated projection, e.g. results.title,results.link,knowledge_graph. Cuts tokens.
`max_age`	integer	–	Accept a cached result up to this many seconds old. Cache hits cost 50% of the credits.

Full reference, error codes and headers are in the /v1/place reference. Queue up to 100 requests at half price with POST /v1/batches.

Use cases

What people build with the Google Place Details API

Open-now checks

Answer "is it open right now?" from weekly_hours and the place's time zone, no text parsing.

Listing enrichment

Fill in address, country, phone, website and categories for places you already have IDs for.

Store locator checks

Verify that your locations' hours, phones and websites are right on Google.

Local agents

Let an assistant pick a place from a Maps search, then read its hours and description.

Pricing