curl -X POST "https://www.mapsdata.io/api/v1/enrichments" \
-H "Content-Type: application/json" \
-H "x-api-key: md_live_your_key" \
-H "Idempotency-Key: october-plumbing-enrichment-v1" \
-d '{
"name": "Plumbing companies to enrich",
"businesses": [
{
"business_name": "Plumbing NYC",
"website_url": "https://www.plumbingnyc.com"
},
{
"business_name": "A&E NYC Plumbing",
"website_url": "https://www.aeplumbingnyc.com"
}
]
}'
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"businesses_submitted": 2,
"credits_reserved": 2,
"message": "Enrichment accepted. It is visible in your Mapsdata dashboard."
}
Endpoints
Create an enrichment
Enrich supplied businesses by company name and website without running a Maps search.
POST
/
enrichments
curl -X POST "https://www.mapsdata.io/api/v1/enrichments" \
-H "Content-Type: application/json" \
-H "x-api-key: md_live_your_key" \
-H "Idempotency-Key: october-plumbing-enrichment-v1" \
-d '{
"name": "Plumbing companies to enrich",
"businesses": [
{
"business_name": "Plumbing NYC",
"website_url": "https://www.plumbingnyc.com"
},
{
"business_name": "A&E NYC Plumbing",
"website_url": "https://www.aeplumbingnyc.com"
}
]
}'
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"businesses_submitted": 2,
"credits_reserved": 2,
"message": "Enrichment accepted. It is visible in your Mapsdata dashboard."
}
Creates an asynchronous enrichment job for businesses you already have. It does not run Google Maps discovery. Every submitted business appears immediately in the Mapsdata dashboard while contact discovery and verification continue.
string
required
A stable unique value for one logical enrichment batch. Required in production. Retry the same body with the same value after a timeout.
string
Dashboard list name, up to 200 characters. Defaults to
Enrich {count} supplied businesses.array
required
curl -X POST "https://www.mapsdata.io/api/v1/enrichments" \
-H "Content-Type: application/json" \
-H "x-api-key: md_live_your_key" \
-H "Idempotency-Key: october-plumbing-enrichment-v1" \
-d '{
"name": "Plumbing companies to enrich",
"businesses": [
{
"business_name": "Plumbing NYC",
"website_url": "https://www.plumbingnyc.com"
},
{
"business_name": "A&E NYC Plumbing",
"website_url": "https://www.aeplumbingnyc.com"
}
]
}'
{
"job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965",
"status": "enriching",
"businesses_submitted": 2,
"credits_reserved": 2,
"message": "Enrichment accepted. It is visible in your Mapsdata dashboard."
}
What runs
Mapsdata uses the supplied website as the starting point for contact discovery, owner and decision-maker research, social discovery, additional public-source matching, and email verification where data is available. The job begins inenriching because business discovery has already been supplied by the caller.
Validation and credits
- Duplicate name and website pairs are rejected with
422. - Relative URLs and non-HTTP(S) URLs are rejected with
422. - Active paid plans reserve one credit per submitted business.
- The free plan uses the same single 100-credit free-job rules as a search.
- Requests beyond the plan maximum or available balance are rejected before a job or lead is created.
- The same body and idempotency key return the existing job without charging twice.
Standalone enrichment jobs appear in the same Dashboard and Lead lists as searches, labelled Standalone enrichment · API. Lead fields update live while workers finish.