# Maps business leads: `POST /v1/maps/leads`

Cost: 6 credits (6 (a partial or empty result and failed requests are free)). Docs: https://scrapercompany.com/docs/reference/maps-leads

Google Maps businesses with harvested, MX-checked emails.

One Maps search per search term in `location`; each business's
own website (home plus contact/about pages) is harvested for emails and social profile links. Each
lead carries the Maps row (name, category, phone, website,
rating, address, coordinates, place id) plus `email`, its
`email_source` page, `all_emails` with per-address status, and
the social links found on the site.

`email_status` is an MX check only: `valid` = the domain has MX
records and the address is not a generic role inbox;
`risky-role` = MX records but a role inbox (`info@`, `contact@`,
…); `invalid` = the domain answered and has no MX records. A
lookup that failed or timed out is `unverified`, the same as
`verify_emails` off. It never claims the mailbox itself exists.
`only_with_email` (default) returns only businesses with an
email; the counts (`searched`, `with_website`, `with_email`)
always describe the whole search. A business whose site fails
or publishes no email is data, not an error; an empty lead list
is not billed.
The whole call stops at its time budget; a harvest cut short is
`meta.partial` and is not billed. A Maps block or a spent budget
with nothing to return is 503 with `Retry-After`.

Request body (JSON):

- `search_terms` (array of string; required; min items 1, max items 5): Business types to search (one Maps search each).
- `location` (string; required; min length 1, max length 120): City or area to search in.
- `max_results` (integer; optional; default 10; min 1, max 20): Places enriched per search term.
- `verify_emails` (boolean; optional; default true): MX-check every harvested email domain (tags each address valid / risky-role / invalid). Off, or a DNS lookup that failed: `unverified`.
- `only_with_email` (boolean; optional; default true): Return only businesses with at least one harvested email.
- `max_emails_per_site` (integer; optional; default 5; min 1, max 20): Cap on addresses harvested per business site.

Base URL: `https://api.scrapercompany.com`. Auth: send your key in the `x-api-key` header. A failed request (4xx or 5xx) or an empty result costs 0 credits.

- [Full API reference as one Markdown file](https://scrapercompany.com/llms-full.txt)
- [OpenAPI spec](https://scrapercompany.com/openapi.json)