Get a business
Resolves a Google CID to the shared business record: identity fields observed across every account's runs, plus — when you have started one — the status of your own most recent research or monitor run against it. Returns 404 until some run has actually observed this CID. Requires the business:read scope when called with a scoped key.
/v1/businesses/{cid}Resolves a Google CID to the shared business record: identity fields observed across every account's runs, plus — when you have started one — the status of your own most recent research or monitor run against it. Returns 404 until some run has actually observed this CID. Requires the business:read scope when called with a scoped key.
Pass Authorization: Bearer mapleads_xxx.
In: header
Path Parameters
Google CID. Resolved server-side to the business observed under (provider="google", providerBusinessId=cid) — the only provider phase two supports.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/businesses/string"{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "provider": "google", "providerBusinessId": "string", "cid": "string", "name": "string", "placeId": "string", "domain": "string", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z", "latestRun": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "kind": "research", "status": "pending", "createdAt": "2019-08-24T14:15:22Z" }}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.
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.