curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}
Endpoints
Get enrichment results
Read supplied businesses and their live enrichment fields.
GET
/
enrichments
/
{job_id}
/
results
curl "https://www.mapsdata.io/api/v1/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}
Returns every supplied business immediately. Contact, owner, social, phone, and verification fields update while
Fetch all pages again after the job becomes terminal. See Data fields for the complete business shape and verification guidance.
status is enriching.
string
required
UUID returned by
POST /enrichments.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/enrichments/4a982a10-b50e-440d-a4f4-0f6b2af8a965/results?page=1&page_size=500" \
-H "x-api-key: md_live_your_key"
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"items": [
{
"id": "c7a0cc35-23f6-48c8-963a-6ac72481ca70",
"search_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"position": 1,
"rank": 1,
"title": "Plumbing NYC",
"website": "https://www.plumbingnyc.com",
"owner_names": ["Example Owner"],
"decision_maker_names": [],
"emails": ["service@plumbingnyc.com"],
"owner_emails": [],
"decision_maker_emails": [],
"email_verification_status": "processing",
"email_verifications": {},
"socials": {"facebooks": [], "instagrams": [], "linkedIns": []},
"additional_phones": [],
"phone_types": {},
"enrichment_status": "completed",
"owner_enrichment_status": "completed",
"key_contacts": []
}
],
"total": 2,
"page": 1,
"page_size": 500,
"has_more": false
}