List leads for a search
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.
/v1/searches/{id}/leadsReturns 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.
Pass Authorization: Bearer mapleads_xxx.
In: header
Path Parameters
Search identifier.
uuidQuery Parameters
Maximum leads to return. Values above 1000 fall back to the default page size of 100.
1 <= value <= 1000100Number of leads to skip.
0 <= value0Response 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/leads"{ "data": [ { "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" } } ], "total": 0}Cancel a search POST
Accepts a cancellation request for a cancellable job. Settlement is asynchronous: the finalize worker keeps and charges for results already produced, refunds the unused reservation, and then changes the job status to `canceled`. Poll the job until that terminal status is visible. Requires the `searches:write` scope when called with a scoped key.
Export leads GET
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.