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.
string
required
UUID returned as
job_id by POST /searches.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
}
string
One of
queued, starting, running, importing, enriching, completed, or failed.integer
Businesses imported so far. This can increase while the job is active.
integer
Businesses whose contact enrichment has completed.
integer
Credits reserved when the job was created.
string | null
Terminal failure explanation when available.
GET /searches/{search_id}/results during running, importing, and enriching to read businesses already found.