Skip to main content
POST
Creates an asynchronous enrichment job for businesses you already selected. It does not run a broad Google Maps discovery search. The job appears in the same Lead lists used by dashboard searches, API jobs, and MCP jobs; supplied businesses appear as the import stage commits them and then update 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
Between 1 and 700 unique businesses.Each item needs either both business_name and website_url, a google_maps_url, or a place_id.
string
ISO 3166-1 alpha-2 country code such as US, CA, or IE. Required when any row has only a name and website. When a Maps identifier is also present, Mapsdata can infer the country, but supplying this value avoids that extra lookup.
object
Select the Pay-on-Find outputs. business_emails, owner_emails, and owner_phones are booleans and default to true. At least one must be enabled.

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. Maps-only rows are resolved to an exact listing first. Jobs move through queued, importing, and enriching; fast jobs can pass through an intermediate state between polls.

Input precedence

When one row contains both a business-name and website pair and Maps identifiers, Mapsdata treats the name and website as canonical. If country_code is supplied, it skips exact Maps resolution and retains the Maps URL and Place ID as supporting metadata. If the country is missing, Mapsdata may resolve the Maps identifier to obtain location evidence. A Maps URL or Place ID is the primary identity only when a complete name-and-website pair is unavailable. Duplicate detection follows the same order: name and website first, then Place ID, then Maps URL. This avoids enriching the same supplied company twice merely because two rows contain different listing identifiers.

Validation and credits

  • Duplicate canonical identities are rejected with 422.
  • Relative URLs and non-HTTP(S) URLs are rejected with 422.
  • Non-Google Maps URLs in google_maps_url and malformed Place IDs are rejected with 422.
  • country_code must be a valid two-letter ISO country code. It is required for name-and-website rows that have no Maps identifier.
  • An active subscription or trial is required. A trial needs at least 1 available credit per submitted business; a paid subscription needs at least 1.5 per submitted business.
  • Pay-on-Find accounts reserve 0 credits at creation and are charged only for contact data successfully found.
  • Once accepted, the complete batch finishes even if its final charge uses the remaining balance. The balance stops at zero rather than removing results or interrupting the job.
  • Owner and decision-maker names are included. A business email costs 1 credit, an owner or decision-maker email costs 2, and a direct owner phone costs 5. Each billable data type is charged at most once per submitted business; no billable contact found costs 0.
  • Requests beyond the 700-business maximum 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.