Essencial
Leads
Quando um job está concluído, percorra as páginas dos leads extraídos.
Email and social fields are only populated for paid plans with enrichment enabled.
GET/v1/scrape-jobs/:id/leads
Query parameters
| Field | Type | Description |
|---|---|---|
| limit | number? | Page size (1–1000, default 100). |
| offset | number? | Number of rows to skip (default 0). |
The response is { "data": [ lead, ... ], "total": number }. Each lead:
| Field | Type | Description |
|---|---|---|
| id | string | Lead id. |
| provider | string | Map source the lead came from: google · bing · apple. |
| name | string | Business name. |
| fullAddress | string | null | Formatted address. |
| street | string | null | Street. |
| municipality | string | null | City / municipality. |
| categories | string[] | Business categories. |
| latitude | number | null | Latitude. |
| longitude | number | null | Longitude. |
| phone | string | null | Primary phone number. |
| phones | string[] | All phone numbers. |
| website | string | null | Website URL. |
| domain | string | null | Website domain. |
| emails | LeadEmail[] | All discovered emails with BillionVerify status (enrichment, paid plans). |
| socials | Record<string,string> | Social profile URLs (enrichment). |
| rating | number | null | Average review rating. |
| reviewCount | number | null | Number of reviews. |
| mapsUrl | string | null | Listing URL on the source map. |
| placeId | string | null | Source place id (Google Place ID, Bing ypid, Apple muid). |
Field availability by provider
Every lead uses the same shape, but the source maps expose different fields — missing ones are null / empty. emails and socials are never from the map; they come from website enrichment on all providers.
| Field | Bing | Apple | |
|---|---|---|---|
| name, address, coordinates, phone, website, categories, placeId, mapsUrl | ✓ | ✓ | ✓ |
| street, municipality | ✓ | — | ✓ |
| rating, reviewCount | ✓ | ✓ | — |
| openingHours | by day | single text | — |
| reviewUrl | ✓ | — | — |
| featuredImage | ✓ | ✓ | — |
| priceLevel, claimed | ✓ | — | — |
| emails, socials | enrichment | enrichment | enrichment |
cURL
curl "https://api.mapleads.ai/v1/scrape-jobs/JOB_ID/leads?limit=100&offset=0" \
-H "Authorization: Bearer mapleads_xxx"