DocumentationAPI Reference
Searches

Export leads

Downloads all or selected leads as CSV, JSON, or Excel. The response is a file rather than a JSON envelope. Requires the leads:export scope when called with a scoped key.

GET/v1/searches/{id}/export

Downloads all or selected leads as CSV, JSON, or Excel. The response is a file rather than a JSON envelope. Requires the leads:export scope when called with a scoped key.

Authorization

AuthorizationBearer <token>

Pass Authorization: Bearer mapleads_xxx.

In: header

Path Parameters

id*string

Search identifier.

Formatuuid

Query Parameters

format?string

Export file format.

Default"csv"

Value in

  • "csv"
  • "json"
  • "xlsx"
leadIds?string

Optional comma-separated lead IDs to include.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/searches/497f6eca-6276-4993-bfeb-53cbbbba6f08/export"
[  {    "name": "string",    "fullAddress": "string",    "categories": [      "string"    ],    "phone": "string",    "website": "http://example.com",    "rating": 0,    "reviewCount": 0,    "emails": [      {}    ],    "socials": {      "property1": "http://example.com",      "property2": "http://example.com"    }  }]

List leads for a search GET

Returns a paginated slice of the job's extracted business leads. Enrichment fields depend on the account's current plan. Requires the `leads:read` scope when called with a scoped key.

Browse the business dataset GET

Server-side filtered, keyset-paginated view of the shared business dataset. Contact values (phone, email, website) are never returned for rows you do not own — only `hasPhone`/`hasEmail`/`hasWebsite` presence flags. Unlock a row to get the values. Pass `cursor` from the previous response to page; never build one yourself. Requires the `business:read` scope when called with a scoped key.