Place Details API

Endpoint

GET /v1/places/details

Parameters

place_id *

Google place_id (e.g. ChIJifIePKtZwokRVZ-UdRGkZzs), as returned by Places Search

country

2-letter ISO 3166-1 alpha-2 region code (default: us)

language

2-letter ISO 639-1 language code (default: en)

Response fields

place

Full place object — same schema as items in Places Search, plus the four fields below

place.global_plus_code

Global Plus Code (e.g. 87G8Q237+V5). Populated for most places.

place.compound_plus_code

Compound Plus Code (e.g. Q237+V5 New York). Populated for most places.

place.menu_link

Menu URL if the place has one (rare — most places don't expose one)

place.emails_and_contacts

Scrape of the place's official website. Object with: emails (array), phone_numbers (array, raw national format — distinct from place.phone_number), and string|null fields for facebook, instagram, linkedin, twitter, tiktok, youtube, pinterest, snapchat, yelp, github. Always returned; empty arrays / nulls when scraping yields nothing

Example Request

curl "https://apidirect.io/v1/places/details?place_id=ChIJifIePKtZwokRVZ-UdRGkZzs" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/places/details",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={"place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs"}
)
print(response.json())

Example Response

{
  "place": {
    "place_id": "ChIJifIePKtZwokRVZ-UdRGkZzs",
    "name": "Joe's Pizza Broadway",
    "type": "Pizza restaurant",
    "subtypes": ["Pizza restaurant", "Pizza delivery", "Restaurant"],
    "phone_number": "+16465594878",
    "website": "https://www.joespizzanyc.com",
    "domain": "joespizzanyc.com",
    "rating": 4.5,
    "review_count": 25433,
    "reviews_per_rating": {"1": 753, "2": 604, "3": 2107, "4": 4946, "5": 17023},
    "price_level": "$10–20",
    "verified": true,
    "business_status": "OPEN",
    "opening_status": "Open · Closes 3 AM",
    "working_hours": {"Monday": ["10 AM–3 AM"]},
    "opening_date": null,
    "address": "1435 Broadway, New York, NY 10018",
    "street_address": "1435 Broadway",
    "district": "Manhattan",
    "city": "New York",
    "state": "New York",
    "zipcode": "10018",
    "country": "US",
    "latitude": 40.75468,
    "longitude": -73.98703,
    "timezone": "America/New_York",
    "summary": "Modern outpost of a longtime counter-serve pizza joint prepping New York-style slices and pies.",
    "about": {"summary": "Modern outpost...", "details": {"Accessibility": {"Wheelchair accessible entrance": true}}},
    "global_plus_code": "87G8Q237+V5",
    "compound_plus_code": "Q237+V5 New York",
    "photo_count": 22117,
    "photos_sample": [{"photo_id": "CIABIhA...", "type": "photo", "photo_url": "https://lh3.googleusercontent.com/...", "photo_url_large": "https://lh3.googleusercontent.com/...=w4280-h3407-k-no", "video_thumbnail_url": null, "latitude": 40.7546469, "longitude": -73.9868158, "photo_datetime_utc": "2026-05-30T00:00:00.000Z", "photo_timestamp": 1780099200}],
    "place_link": "https://www.google.com/maps/place/...",
    "reviews_link": "https://search.google.com/local/reviews?placeid=ChIJifIePKtZwokRVZ-UdRGkZzs",
    "booking_link": "https://www.google.com/searchviewer/42?...",
    "reservations_link": "https://www.fooddiscoveryapp.com/new-york-city/joes-pizza",
    "menu_link": null,
    "order_link": "https://www.google.com/searchviewer/42?...",
    "owner_name": "Joe's Pizza Broadway",
    "owner_link": "https://maps.google.com/maps/contrib/103877821925204408966",
    "cid": "4280570365733019477",
    "google_mid": "/g/11bw4ws2mt",
    "emails_and_contacts": {
      "emails": [],
      "phone_numbers": ["2123661182", "7183882216"],
      "facebook": null,
      "instagram": "https://www.instagram.com/joespizzanyc",
      "linkedin": null,
      "twitter": null,
      "tiktok": null,
      "youtube": null,
      "pinterest": null,
      "snapchat": null,
      "yelp": null,
      "github": null
    }
  }
}

Frequently asked questions

Where do I get the place_id?

From the Places Search endpoint — each result includes a place_id. It's Google's standard ChIJ... identifier.

What's actually different vs Places Search?

Place Details returns the same place object as Search, plus four extras: global_plus_code, compound_plus_code, menu_link, and emails_and_contacts (a scrape of the place's website for emails, phones and social profile URLs across 10 platforms).

Why is Place Details slower than Search?

Every Place Details call performs a synchronous scrape of the place's official website to populate emails_and_contacts. This adds about 0.5-1s. The scrape is best-effort — empty arrays and null social links are normal for places without good public websites.

What if the place_id doesn't exist?

You get a 404 with code: "not_found". You are not charged for not_found responses.

How does pricing work?

You only pay for successful requests. The Place Details API costs $0.003 per request. There are no monthly fees or commitments. You get 50 free requests per endpoint every month.

Do I need a credit card to start?

No. You can sign up and use the free tier (50 requests/endpoint/month) without adding a payment method. You only need to add a card when you want to exceed the free tier.

Are there rate limits?

Yes, there's a concurrency limit of 3 simultaneous requests per endpoint per user. If you need more, just get in touch.