curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc" \
-H "x-api-key: md_live_your_key"
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "enriching",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "api",
"run_id": "provider-run-id",
"error": null,
"lead_count": 74,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 51,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
Endpoints
Get search status
Read live job state, counts, billing, and terminal errors.
GET
/
searches
/
{search_id}
curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc" \
-H "x-api-key: md_live_your_key"
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "enriching",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "api",
"run_id": "provider-run-id",
"error": null,
"lead_count": 74,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 51,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
Poll this endpoint every 5–10 seconds. A job is terminal when status is
Do not wait for completion before presenting results. Fetch
completed or failed.
curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc" \
-H "x-api-key: md_live_your_key"
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "enriching",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "api",
"run_id": "provider-run-id",
"error": null,
"lead_count": 74,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 51,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
GET /searches/{search_id}/results during running, importing, and enriching to read businesses already found.
Continue the search workflow
- Read the businesses already found with
GET /searches/{search_id}/results. - Retrieve other jobs owned by the account with
GET /searches. - Start another job with
POST /searches.
