curl "https://www.mapsdata.io/api/v1/searches?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": "api",
"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 API searches
List searches created through the public API.
GET
/
searches
curl "https://www.mapsdata.io/api/v1/searches?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": "api",
"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 Google Maps discovery jobs whose
The response does not include
origin is api, newest first. Dashboard-created searches remain available in the web app but are not included here. Standalone enrichment jobs are listed by GET /enrichments.
integer
default:"1"
Page number, starting at
1.integer
default:"20"
Items per page, from
1 to 100.curl "https://www.mapsdata.io/api/v1/searches?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": "api",
"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.