Google Maps Place Detail — API reference

POST

Available

/google/maps/detail

Google Maps Place Detail

Look up one Google Maps place by its place ID. This complements Maps search and uses its own catalog request price.

type

maps_detail

result

place

Billing

3 credits

Look up one Google Maps place by its place ID. This complements Maps search and uses its own catalog request price.

Parameters

FieldTypeAvailabilityDescription

feature_id

required

string

required

Use the feature_id field returned by Maps Search place results. It is formatted like 0x...:0x....

hl

optional

string

optional

Language code. Defaults to en.

gl

optional

string

optional

Country code. Defaults to us.

id

sample

string

Catalog sample; the API validates required fields.

sample: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json

{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}

Open in Playground

Response fields

FieldTypeAvailabilityDescription

feature_id

required

string

required

Feature id resolved from the Maps detail request.

page

required

number

required

Always 1 for maps detail.

place

optional

MapsPlace

When place details are parsed.

Single place detail object.

MapsPlace Result item schema

FieldTypeAvailabilityDescription

position

optional

number

Maps Search only.

Place rank in the local result list.

name

required

string

required

Place name.

title

required

string

required

Alias for name.

feature_id

required

string

required

Google Maps feature id.

place_id

optional

string

When Google exposes it.

Google place id.

data_id

optional

string

Alias for feature_id.

Maps data id.

cid

optional

string

Derived from feature_id when possible.

Google CID.

kgmid

optional

string

When present in Maps payload.

Knowledge graph machine id.

google_maps_url

optional

string

When Google exposes a Maps URL.

Google Maps URL.

url

optional

string

google_maps_url or website fallback.

Primary place URL.

rating

optional

number

When rating is present.

Google rating.

types

optional

string[]

When categories are present.

Place type labels.

category

optional

object

When category block is parsed.

Structured category data.

address

optional

string

When address is present.

Formatted address.

address_components

optional

object

When components are present.

Street, city, postal code, country code.

plus_code

optional

object

When plus code is present.

Global and compound plus codes.

phone

optional

string

When phone is present.

Local phone number.

phone_international

optional

string

When present.

International phone number.

phone_uri

optional

string

When present.

Telephone URI.

website

optional

string

When website is present.

Business website.

website_domain

optional

string

When website domain is present.

Business website domain.

latitude

optional

number

When coordinates are present.

Latitude.

longitude

optional

number

When coordinates are present.

Longitude.

image

optional

string

When image is present.

Primary place image.

thumbnail

optional

string

Alias for image when available.

Primary image alias.

photos

optional

MapsPhoto[]

When photos are parsed.

Photo id, URL, size, and optional coordinates.

hours

optional

Record<string,string>

When hours are parsed.

Opening hours by day.

open_status

optional

object

When status is present.

Open status text and current hours.

attributes

optional

object[]

When attributes are parsed.

Grouped place attributes.

related_places

optional

object[]

When related places are present.

Related places from Maps payload.

short_description

optional

string

When description block is present.

Short place description.

description

optional

string

When description block is present.

Longer place description.

snippet

optional

string

short_description or description fallback.

Normalized text summary.

timezone

optional

string

When present.

Place timezone.

region

optional

string

When present.

Region label.

country_code

optional

string

When present.

Country code.

language

optional

string

When present.

Language code from Maps payload.

Code and response examples

bash

curl -X POST 'https://api.serpbase.dev/google/maps/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'

Existing Google request example

bash

curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'

Notes

Place enrichment, local CRM data, detail pages.

Use the feature_id field from a Maps Search place result to request a detail record. A well-formed but unknown feature_id returns status 1004.