Maps

Google Maps place search

Google Maps place search for any query: name, address, coordinates, rating and review count, type, website, phone, price level, opening hours, booking links, and whether the listing is claimed by its owner (claimed: false is a lead-gen signal). Each place carries a cid usable with /api/v1/maps/place. Without ll results are biased by the scraper exit IP’s location — pass ll for deterministic results, especially when paginating.

Credits: 1 (refunded on failure).

get/api/v1/maps

Request

  • Base URL: https://scrapewhale.dev
  • URL: https://scrapewhale.dev/api/v1/maps
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Query parameters

qstring required

The place search query.

llstring

Location bias as @lat,lng,zoom, e.g. @40.7504,-73.9824,14z.

glstring

Country code, e.g. "us", "gb", "de".

hlstring

Language code, e.g. "en", "es".

pageinteger

Page of 20 places (1–5, default 1). Deeper pages widen the search radius.

format'json' | 'markdown' | 'both'

Response shape: "json" (structured data only), "markdown" (markdown only), or "both".

Response

Success.

idstring required
status'completed' required
extractorstring required

Extractor name, e.g. "traffic", "meta-ads", "instagram-profile".

titlestring nullable
sourceUrlstring nullable

Canonical public URL of the extracted source.

creditsChargedinteger required

0 when served from the shared cache.

cachedboolean

True when served from the shared extraction cache (free).

createdAtinteger required

Unix epoch milliseconds.

dataobject nullable

Raw structured payload from the source.

markdownstring

Clean markdown rendering of the payload.

Changes

No recorded changes to this operation across all 1 revision of this API.