curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"city": "New York",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"business_status": "OPERATIONAL",
"rank": 1,
"categories": ["Plumber", "Heating contractor"],
"country_code": "US",
"google_maps_url": "https://www.google.com/maps?cid=8182443519000000000",
"owner_name": "Elena Torres",
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"email_verifications": {
"elena@hudsonplumbing.example": {
"result": "ok",
"quality": "good",
"source": "anymailfinder"
}
},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": [], "youtubes": [], "yelps": []},
"additional_phones": [],
"phone_types": {"+12125550184": "landline"},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 74,
"page": 1,
"page_size": 500,
"has_more": false
}
Endpoints
Get search results
Page through enriched businesses, including partial results from an active job.
GET
/
searches
/
{search_id}
/
results
curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"city": "New York",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"business_status": "OPERATIONAL",
"rank": 1,
"categories": ["Plumber", "Heating contractor"],
"country_code": "US",
"google_maps_url": "https://www.google.com/maps?cid=8182443519000000000",
"owner_name": "Elena Torres",
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"email_verifications": {
"elena@hudsonplumbing.example": {
"result": "ok",
"quality": "good",
"source": "anymailfinder"
}
},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": [], "youtubes": [], "yelps": []},
"additional_phones": [],
"phone_types": {"+12125550184": "landline"},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 74,
"page": 1,
"page_size": 500,
"has_more": false
}
Returns businesses already imported for the job. Results are available while discovery and enrichment continue; the same rows appear live in the Mapsdata UI.
string
required
UUID returned as
job_id by POST /searches.integer
default:"1"
Page number, starting at
1.integer
default:"100"
Businesses per page, from
1 to 500.curl "https://www.mapsdata.io/api/v1/searches/c15dbb36-5a56-4720-b1af-b388bcaf78dc/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc",
"position": 1,
"title": "Hudson Plumbing & Heating",
"category": "Plumber",
"address": "221 W 37th St, New York, NY 10018",
"city": "New York",
"phone": "+12125550184",
"website": "https://hudsonplumbing.example",
"rating": 4.7,
"review_count": 186,
"business_status": "OPERATIONAL",
"rank": 1,
"categories": ["Plumber", "Heating contractor"],
"country_code": "US",
"google_maps_url": "https://www.google.com/maps?cid=8182443519000000000",
"owner_name": "Elena Torres",
"owner_names": ["Elena Torres"],
"decision_maker_names": [],
"emails": ["service@hudsonplumbing.example"],
"owner_emails": ["elena@hudsonplumbing.example"],
"decision_maker_emails": [],
"email_verification_status": "completed",
"email_verifications": {
"elena@hudsonplumbing.example": {
"result": "ok",
"quality": "good",
"source": "anymailfinder"
}
},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": [], "youtubes": [], "yelps": []},
"additional_phones": [],
"phone_types": {"+12125550184": "landline"},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 74,
"page": 1,
"page_size": 500,
"has_more": false
}
Pagination and live data
During an active job,total, contact fields, and verification fields can change between requests. Treat each response as a current snapshot. When the search reaches a terminal status, fetch from page 1 again and continue until has_more is false.
An email in
See Data fields for the complete lead shape.emails, owner_emails, or decision_maker_emails is not automatically verified. Inspect email_verification_status and the address entry in email_verifications before use.