Run your first API search

Create an API key in the dashboard with scrapes:write access. Store it on your server. POST a JSON body such as {"q":"coffee shops in Seattle","page":1,"extra":false} to https://gmapscrawl.com/api/v1/search, using Authorization: Bearer with your key. Read data.businesses from the same response; data.total is at most 20.

Use pages 1–10 for additional searches, with one request unit per page. Include an Idempotency-Key (16–128 characters) and reuse it with the identical body on retries. No webhooks, job IDs, or separate result reads are needed.

See the Search API documentation for the current contract.