curl "https://www.mapsdata.io/api/v1/searches?scope=all&page=1&page_size=20" \
-H "x-api-key: md_live_your_key"
{
"items": [
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "running",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "dashboard",
"run_id": "provider-run-id",
"error": null,
"lead_count": 38,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 16,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
],
"total": 1
}
Endpoints
List searches
List dashboard, REST API, and MCP searches for the account.
GET
/
searches
curl "https://www.mapsdata.io/api/v1/searches?scope=all&page=1&page_size=20" \
-H "x-api-key: md_live_your_key"
{
"items": [
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "running",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "dashboard",
"run_id": "provider-run-id",
"error": null,
"lead_count": 38,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 16,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
],
"total": 1
}
Returns all Google Maps discovery jobs owned by the account, newest first. This includes searches created in the Mapsdata dashboard, through the REST API, and through MCP. Standalone enrichment jobs are listed by
The response does not include
GET /enrichments.
Use
dashboard for website-created searches or integration for REST API and MCP searches.curl "https://www.mapsdata.io/api/v1/searches?scope=all&page=1&page_size=20" \
-H "x-api-key: md_live_your_key"
{
"items": [
{
"id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"name": "New York plumbers",
"status": "running",
"actor_input": {
"query": "plumbers",
"location": "New York, New York",
"countryCode": "US",
"maxResults": 100,
"language": "en"
},
"source": "apify",
"origin": "dashboard",
"run_id": "provider-run-id",
"error": null,
"lead_count": 38,
"credits_charged": 100,
"enrich_contacts": true,
"enriched_count": 16,
"delete_requested": false,
"created_at": "2026-10-01T09:12:30Z",
"finished_at": null
}
],
"total": 1
}
has_more. Another page exists when page × page_size < total.
Use the first item to retrieve the latest search, then call GET /searches/{search_id} for its status and GET /searches/{search_id}/results for its businesses.