# Leads

Once a job is completed, page through its extracted leads. Email and social fields are only populated for paid plans with enrichment enabled.

`GET /v1/searches/: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. |
| `email` | string \| null | Best email (enrichment, paid plans). |
| `emails` | string[] | All discovered emails (enrichment). |
| `socials` | Record<string,string> | Social profile URLs (enrichment). |
| `technologies` | WebsiteTechnology[] | Website technology names, versions, and categories (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. `email` and `socials` are never from the map; they come from website enrichment on all providers.

| Field | Google | 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 "https://api.mapleads.ai/v1/searches/JOB_ID/leads?limit=100&offset=0" \
  -H "Authorization: Bearer mapleads_xxx"
```