List every lead in this account
Every lead you own, regardless of how it got here — searches and dataset unlocks alike. Scoping leads to a search only ever worked because search was the single way in; an unlocked row has no job and would be invisible. Keyset-paginated newest first; pass cursor from the previous response. Requires the leads:read scope when called with a scoped key.
/v1/leadsEvery lead you own, regardless of how it got here — searches and dataset unlocks alike. Scoping leads to a search only ever worked because search was the single way in; an unlocked row has no job and would be invisible. Keyset-paginated newest first; pass cursor from the previous response. Requires the leads:read scope when called with a scoped key.
Pass Authorization: Bearer mapleads_xxx.
In: header
Query Parameters
Source maps to keep. Repeat the parameter or comma-separate. Omit to include all three — there is no default map. The same business can appear once per map; those are separate rows with separate identifiers, not duplicates.
Rows per page (default 100, max 500).
Opaque keyset cursor from the previous response.
Response Body
application/json
curl -X GET "https://example.com/v1/leads"{ "leads": [ {} ], "nextCursor": "string"}Unlock dataset rows into your leads POST
Buys rows into this account's leads, charging the same credits a search result costs. Idempotent per row: anything already owned comes back in `alreadyOwned` and is not charged, so a double-submit or a retry cannot bill twice. Insufficient balance rejects the whole batch with 402 rather than unlocking part of it — a partial unlock leaves you unable to tell which rows you bought. Requires the `business:unlock` scope when called with a scoped key.
Get one of your leads GET
Returns a single lead this account owns, in the same shape the list returns. A lead belonging to someone else is 404, not 403 — a 403 would confirm the id is real. Free. Requires the `leads:read` scope when called with a scoped key.