Google Maps places API

Searches Google's local results for a keyword in a location and delivers de-duplicated place records with contact and geo fields. Paginates automatically until max_results is reached or Google runs out. Use the returned data_id with the Place reviews collector.

$0.001 per delivered place, up to 100 places per run. Nothing delivered means nothing charged.

Inputs

• query (string, required) — Business type or keyword, e.g. "pizza restaurants", "dentist".
• location (string, required) — City / area / address, e.g. "Brooklyn, NY" or "Milano".
• country (string) — ISO 3166-1 alpha-2 code — proxy exit geo and Google locale (gl). Omit for the default pool.
• lang (string) — Interface language (hl), e.g. en, it, de.
• max_results (integer) — How many places to deliver at most (1–100). You pay only for delivered places.

What one place looks like

• rank (integer) — 1-based position across the merged pages.
• name (string) — Business name.
• rating (number, nullable) — Star rating (1–5).
• reviews (integer, nullable) — Review count.
• category (string, nullable) — Google category, e.g. "Pizza restaurant".
• price_level (string, nullable) — Price level as shown ($,
  0–20).
• address (string, nullable) — Street address as shown.
• phone (string, nullable) — Phone number as shown.
• website (string, nullable) — Website URL or domain.
• hours (string, nullable) — Opening hours snippet.
• service_options (string, nullable) — Dine-in · Takeout · Delivery…
• thumbnail (string, nullable) — Photo thumbnail URL.
• maps_url (string, nullable) — Google Maps link.
• latitude (number, nullable) — GPS latitude.
• longitude (number, nullable) — GPS longitude.
• place_id (string, nullable) — Google place id (ChIJ… or 0x…:0x…).
• data_id (string, nullable) — Feature id 0x…:0x… — input for Place reviews.
• description (string, nullable) — Editorial blurb when Google shows one.
• found_by (string) — The Google query that surfaced this place.

FAQ

What does the Google Maps places API return?

Searches Google's local results for a keyword in a location and delivers de-duplicated place records with contact and geo fields. Paginates automatically until max_results is reached or Google runs out. Use the returned data_id with the Place reviews collector. Each row carries 19 fields, listed in full on this page.

What do I send it?

A semantic input, not a URL list: query and location are required. One run returns up to 100 places.

How much does the Google Maps places API cost?

$0.001 per delivered place. A run that delivers nothing is not billed, and the