{ "job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965", "status": "queued", "businesses_submitted": 2, "credits_reserved": 0, "message": "Enrichment accepted. It is visible in your Mapsdata dashboard."}
Endpoints
Create an enrichment
Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.
{ "job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965", "status": "queued", "businesses_submitted": 2, "credits_reserved": 0, "message": "Enrichment accepted. It is visible in your Mapsdata dashboard."}
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.
Show business fields
string
Company or business name, up to 200 characters. Supply it with website_url.
string
Absolute http:// or https:// company website. Supply it with business_name.
string
HTTPS Google Maps listing URL, including maps.app.goo.gl links.
string
Google Place ID for an exact listing.
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.
{ "job_id": "4a982a10-b50e-440d-a4f4-0f6b2af8a965", "status": "queued", "businesses_submitted": 2, "credits_reserved": 0, "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. 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.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mapsdata API","description":"Search Google Maps and retrieve enriched local business leads.","colors":{"primary":"#656c2e","light":"#7b8338","dark":"#7b8338"},"logo":"https://mintcdn.com/mapsdata/j7H3nB6-kjdlM0lM/images/logo.png?fit=max\u0026auto=format\u0026n=j7H3nB6-kjdlM0lM\u0026q=85\u0026s=30cfcb6e5c33b2d293fe5cb5b46e7f19","favicon":"https://mintcdn.com/mapsdata/j7H3nB6-kjdlM0lM/images/logo.ico?fit=max\u0026auto=format\u0026n=j7H3nB6-kjdlM0lM\u0026q=85\u0026s=784761c4911731f4baf083e7ff18cf71","api":{"mdx":{"auth":{"method":"key","name":"x-api-key"},"server":"https://www.mapsdata.io/api/v1"}},"appearance":{"default":"light","strict":true},"navbar":{"primary":{"type":"button","label":"Get API key","href":"https://www.mapsdata.io/integrations?tab=keys"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/mapsdata-io","youtube":"https://www.youtube.com/@Mapsdataio"}},"seo":{"metatags":{"canonical":"https://www.mapsdata.io/docs","og:site_name":"Mapsdata","robots":"index, follow"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mapsdata","hasAudioNarration":false,"actualSubdomain":"mapsdata","customDomains":["www.mapsdata.io"],"gitSource":{"type":"github","owner":"mapsdata-io","repo":"mapsdata-frontend","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6af6c8863a8cec7369632e08","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":12},{"language":"default","tag":"Getting started","count":4},{"language":"default","tag":"Reference","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"endpoints/create-enrichment","slug":"/endpoints/create-enrichment","pageMetadata":{"title":"Create an enrichment","description":"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.","api":"POST /enrichments","href":"/endpoints/create-enrichment"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,required:true,id:`param-idempotency-key`,children:_jsx(_components.p,{children:`A stable unique value for one logical enrichment batch. Required in production. Retry the same body with the same value after a timeout.`})}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,id:`param-name`,children:_jsxs(_components.p,{children:[`Dashboard list name, up to 200 characters. Defaults to `,_jsx(_components.code,{children:`Enrich {count} supplied businesses`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`businesses`,type:`array`,required:true,id:`param-businesses`,children:[_jsx(_components.p,{children:`Between 1 and 700 unique businesses.`}),_jsxs(Expandable,{title:`business fields`,children:[_jsxs(ParamField,{body:`businesses[].business_name`,type:`string`,id:`param-businesses-business-name`,children:[`Company or business name, up to 200 characters. Supply it with `,_jsx(_components.code,{children:`website_url`}),`.`]}),_jsxs(ParamField,{body:`businesses[].website_url`,type:`string`,id:`param-businesses-website-url`,children:[`Absolute `,_jsx(_components.code,{children:`http://`}),` or `,_jsx(_components.code,{children:`https://`}),` company website. Supply it with `,_jsx(_components.code,{children:`business_name`}),`.`]}),_jsxs(ParamField,{body:`businesses[].google_maps_url`,type:`string`,id:`param-businesses-google-maps-url`,children:[`HTTPS Google Maps listing URL, including `,_jsx(_components.code,{children:`maps.app.goo.gl`}),` links.`]}),_jsx(ParamField,{body:`businesses[].place_id`,type:`string`,id:`param-businesses-place-id`,children:`Google Place ID for an exact listing.`})]}),_jsxs(_components.p,{children:[`Each item needs either both `,_jsx(_components.code,{children:`business_name`}),` and `,_jsx(_components.code,{children:`website_url`}),`, a `,_jsx(_components.code,{children:`google_maps_url`}),`, or a `,_jsx(_components.code,{children:`place_id`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`country_code`,type:`string`,id:`param-country-code`,children:_jsxs(_components.p,{children:[`ISO 3166-1 alpha-2 country code such as `,_jsx(_components.code,{children:`US`}),`, `,_jsx(_components.code,{children:`CA`}),`, or `,_jsx(_components.code,{children:`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.`]})}),`\n`,_jsx(ParamField,{body:`options`,type:`object`,id:`param-options`,children:_jsxs(_components.p,{children:[`Select the Pay-on-Find outputs. `,_jsx(_components.code,{children:`business_emails`}),`, `,_jsx(_components.code,{children:`owner_emails`}),`, and `,_jsx(_components.code,{children:`owner_phones`}),` are booleans and default to `,_jsx(_components.code,{children:`true`}),`. At least one must be enabled.`]})}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`what-runs`,children:`What runs`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`queued`}),`, `,_jsx(_components.code,{children:`importing`}),`, and `,_jsx(_components.code,{children:`enriching`}),`; fast jobs can pass through an intermediate state between polls.`]}),`\n`,_jsx(Heading,{level:`2`,id:`input-precedence`,children:`Input precedence`}),`\n`,_jsxs(_components.p,{children:[`When one row contains both a business-name and website pair and Maps identifiers, Mapsdata treats the name and website as canonical. If `,_jsx(_components.code,{children:`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.`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`validation-and-credits`,children:`Validation and credits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Duplicate canonical identities are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Relative URLs and non-HTTP(S) URLs are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Non-Google Maps URLs in `,_jsx(_components.code,{children:`google_maps_url`}),` and malformed Place IDs are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`country_code`}),` must be a valid two-letter ISO country code. It is required for name-and-website rows that have no Maps identifier.`]}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`Pay-on-Find accounts reserve 0 credits at creation and are charged only for contact data successfully found.`}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`Requests beyond the 700-business maximum are rejected before a job or lead is created.`}),`\n`,_jsx(_components.li,{children:`The same body and idempotency key return the existing job without charging twice.`}),`\n`]}),`\n`,_jsx(`div`,{className:`callout mint-my-5 mint-rounded-xl mint-border mint-border-[#656c2e]/30 mint-bg-[#656c2e]/10 mint-px-5 mint-py-4 mint-text-sm mint-text-[#4d5321]`,children:_jsxs(_components.p,{children:[`Standalone enrichment jobs appear in the same Dashboard and Lead lists as searches, labelled `,_jsx(`strong`,{children:`Standalone enrichment · API`}),`. Lead fields update live while workers finish.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an enrichment","description":"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.","api":"POST /enrichments","href":"/endpoints/create-enrichment"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`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.`}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,required:true,id:`param-idempotency-key`,children:_jsx(_components.p,{children:`A stable unique value for one logical enrichment batch. Required in production. Retry the same body with the same value after a timeout.`})}),`\n`,_jsx(ParamField,{body:`name`,type:`string`,id:`param-name`,children:_jsxs(_components.p,{children:[`Dashboard list name, up to 200 characters. Defaults to `,_jsx(_components.code,{children:`Enrich {count} supplied businesses`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`businesses`,type:`array`,required:true,id:`param-businesses`,children:[_jsx(_components.p,{children:`Between 1 and 700 unique businesses.`}),_jsxs(Expandable,{title:`business fields`,children:[_jsxs(ParamField,{body:`businesses[].business_name`,type:`string`,id:`param-businesses-business-name`,children:[`Company or business name, up to 200 characters. Supply it with `,_jsx(_components.code,{children:`website_url`}),`.`]}),_jsxs(ParamField,{body:`businesses[].website_url`,type:`string`,id:`param-businesses-website-url`,children:[`Absolute `,_jsx(_components.code,{children:`http://`}),` or `,_jsx(_components.code,{children:`https://`}),` company website. Supply it with `,_jsx(_components.code,{children:`business_name`}),`.`]}),_jsxs(ParamField,{body:`businesses[].google_maps_url`,type:`string`,id:`param-businesses-google-maps-url`,children:[`HTTPS Google Maps listing URL, including `,_jsx(_components.code,{children:`maps.app.goo.gl`}),` links.`]}),_jsx(ParamField,{body:`businesses[].place_id`,type:`string`,id:`param-businesses-place-id`,children:`Google Place ID for an exact listing.`})]}),_jsxs(_components.p,{children:[`Each item needs either both `,_jsx(_components.code,{children:`business_name`}),` and `,_jsx(_components.code,{children:`website_url`}),`, a `,_jsx(_components.code,{children:`google_maps_url`}),`, or a `,_jsx(_components.code,{children:`place_id`}),`.`]})]}),`\n`,_jsx(ParamField,{body:`country_code`,type:`string`,id:`param-country-code`,children:_jsxs(_components.p,{children:[`ISO 3166-1 alpha-2 country code such as `,_jsx(_components.code,{children:`US`}),`, `,_jsx(_components.code,{children:`CA`}),`, or `,_jsx(_components.code,{children:`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.`]})}),`\n`,_jsx(ParamField,{body:`options`,type:`object`,id:`param-options`,children:_jsxs(_components.p,{children:[`Select the Pay-on-Find outputs. `,_jsx(_components.code,{children:`business_emails`}),`, `,_jsx(_components.code,{children:`owner_emails`}),`, and `,_jsx(_components.code,{children:`owner_phones`}),` are booleans and default to `,_jsx(_components.code,{children:`true`}),`. At least one must be enabled.`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`22`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`22`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` POST`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://www.mapsdata.io/api/v1/enrichments\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Content-Type: application/json\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"x-api-key: md_live_your_key\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Idempotency-Key: october-plumbing-enrichment-v1\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -d`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` '{`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"name\": \"Plumbing companies to enrich\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"country_code\": \"US\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"businesses\": [`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"business_name\": \"Plumbing NYC\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"website_url\": \"https://www.plumbingnyc.com\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"google_maps_url\": \"https://www.google.com/maps?cid=123456789\"`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` ],`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"options\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"business_emails\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"owner_emails\": true,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"owner_phones\": false`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }'`})}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`202`,numberOfLines:`7`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`7`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"job_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"4a982a10-b50e-440d-a4f4-0f6b2af8a965\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"queued\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"businesses_submitted\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"credits_reserved\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Enrichment accepted. It is visible in your Mapsdata dashboard.\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})})}),`\n`,_jsx(Heading,{level:`2`,id:`what-runs`,children:`What runs`}),`\n`,_jsxs(_components.p,{children:[`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 `,_jsx(_components.code,{children:`queued`}),`, `,_jsx(_components.code,{children:`importing`}),`, and `,_jsx(_components.code,{children:`enriching`}),`; fast jobs can pass through an intermediate state between polls.`]}),`\n`,_jsx(Heading,{level:`2`,id:`input-precedence`,children:`Input precedence`}),`\n`,_jsxs(_components.p,{children:[`When one row contains both a business-name and website pair and Maps identifiers, Mapsdata treats the name and website as canonical. If `,_jsx(_components.code,{children:`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.`]}),`\n`,_jsx(_components.p,{children:`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.`}),`\n`,_jsx(Heading,{level:`2`,id:`validation-and-credits`,children:`Validation and credits`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Duplicate canonical identities are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Relative URLs and non-HTTP(S) URLs are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[`Non-Google Maps URLs in `,_jsx(_components.code,{children:`google_maps_url`}),` and malformed Place IDs are rejected with `,_jsx(_components.code,{children:`422`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`country_code`}),` must be a valid two-letter ISO country code. It is required for name-and-website rows that have no Maps identifier.`]}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`Pay-on-Find accounts reserve 0 credits at creation and are charged only for contact data successfully found.`}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`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.`}),`\n`,_jsx(_components.li,{children:`Requests beyond the 700-business maximum are rejected before a job or lead is created.`}),`\n`,_jsx(_components.li,{children:`The same body and idempotency key return the existing job without charging twice.`}),`\n`]}),`\n`,_jsx(`div`,{className:`callout mint-my-5 mint-rounded-xl mint-border mint-border-[#656c2e]/30 mint-bg-[#656c2e]/10 mint-px-5 mint-py-4 mint-text-sm mint-text-[#4d5321]`,children:_jsxs(_components.p,{children:[`Standalone enrichment jobs appear in the same Dashboard and Lead lists as searches, labelled `,_jsx(`strong`,{children:`Standalone enrichment · API`}),`. Lead fields update live while workers finish.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Create an enrichment","description":"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.","api":"POST /enrichments","href":"/endpoints/create-enrichment"}}}},"mdxExtracts":{"tableOfContents":[{"title":"What runs","slug":"what-runs","depth":2,"children":[]},{"title":"Input precedence","slug":"input-precedence","depth":2,"children":[]},{"title":"Validation and credits","slug":"validation-and-credits","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"22\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -X\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> POST\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://www.mapsdata.io/api/v1/enrichments\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Content-Type: application/json\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"x-api-key: md_live_your_key\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"Idempotency-Key: october-plumbing-enrichment-v1\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#D7BA7D\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\"> -d\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> '{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"name\": \"Plumbing companies to enrich\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"country_code\": \"US\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"businesses\": [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"business_name\": \"Plumbing NYC\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"website_url\": \"https://www.plumbingnyc.com\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"google_maps_url\": \"https://www.google.com/maps?cid=123456789\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> ],\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"options\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"business_emails\": true,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"owner_emails\": true,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"owner_phones\": false\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> }'\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"202","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"7\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"job_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"4a982a10-b50e-440d-a4f4-0f6b2af8a965\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"status\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"queued\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"businesses_submitted\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">2\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"credits_reserved\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Enrichment accepted. It is visible in your Mapsdata dashboard.\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Create an enrichment","path":"/enrichments","servers":[{"url":"https://www.mapsdata.io/api/v1"}],"method":"post","request":{"security":[{"title":"API Key Auth","parameters":{"header":{"x-api-key":{"type":"apiKey"}},"query":{},"cookie":{}}}],"parameters":{"query":{},"header":{"Idempotency-Key":{"schema":[{"type":"string","description":"A stable unique value for one logical enrichment batch. Required in production. Retry the same body with the same value after a timeout.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"name":[{"type":"string","description":"Dashboard list name, up to 200 characters. Defaults to `Enrich {count} supplied businesses` ."}],"businesses":[{"type":"array","items":[{"type":"object","properties":{"businesses[].business_name":[{"type":"string","description":"Company or business name, up to 200 characters. Supply it with `website_url` ."}],"businesses[].website_url":[{"type":"string","description":"Absolute `http://` or `https://` company website. Supply it with `business_name` ."}],"businesses[].google_maps_url":[{"type":"string","description":"HTTPS Google Maps listing URL, including `maps.app.goo.gl` links."}],"businesses[].place_id":[{"type":"string","description":"Google Place ID for an exact listing."}]}}],"description":"Between 1 and 700 unique businesses. Each item needs either both `business_name` and `website_url` , a `google_maps_url` , or a `place_id` .","required":true}],"country_code":[{"type":"string","description":"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."}],"options":[{"type":"object","properties":{},"description":"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."}]}}],"examples":{"example":{"value":{"name":"\u003cstring>","businesses":[{"businesses[].business_name":"\u003cstring>","businesses[].website_url":"\u003cstring>","businesses[].google_maps_url":"\u003cstring>","businesses[].place_id":"\u003cstring>"}],"country_code":"\u003cstring>","options":{}}}}}}},"response":{},"deprecated":false}},"jsLinks":[],"dynamicCss":".mint-my-5 {\n margin-top: 1.25rem;\n margin-bottom: 1.25rem\n}\n.mint-rounded-xl {\n border-radius: 0.75rem\n}\n.mint-border {\n border-width: 1px\n}\n.mint-border-\\[\\#656c2e\\]\\/30 {\n border-color: rgb(101 108 46 / 0.3)\n}\n.mint-bg-\\[\\#656c2e\\]\\/10 {\n background-color: rgb(101 108 46 / 0.1)\n}\n.mint-px-5 {\n padding-left: 1.25rem;\n padding-right: 1.25rem\n}\n.mint-py-4 {\n padding-top: 1rem;\n padding-bottom: 1rem\n}\n.mint-text-sm {\n font-size: 0.875rem;\n line-height: 1.25rem\n}\n.mint-text-\\[\\#4d5321\\] {\n --tw-text-opacity: 1;\n color: rgb(77 83 33 / var(--tw-text-opacity, 1))\n}","subdomain":"mapsdata","siteName":"Mapsdata API","title":"Create an enrichment - Mapsdata API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-13T08:21:31.398Z","originalFileLocation":"endpoints/create-enrichment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"light\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mapsdata API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"index, follow\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create an enrichment - Mapsdata API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mapsdata\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.mapsdata.io/docs/endpoints/create-enrichment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mapsdata.mintlify.site/docs/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+an+enrichment\u0026amp;description=Enrich+businesses+you+already+selected+using+names+and+websites%2C+Google+Maps+URLs%2C+or+Place+IDs.\u0026amp;theme=b297a435d1be9dc8884e4547\u0026amp;signature=30f71455fc89e71492787e09741aa5fc49d31a928319523dcffd1922a912178c\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Create an enrichment - Mapsdata API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mapsdata.mintlify.site/docs/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+an+enrichment\u0026amp;description=Enrich+businesses+you+already+selected+using+names+and+websites%2C+Google+Maps+URLs%2C+or+Place+IDs.\u0026amp;theme=b297a435d1be9dc8884e4547\u0026amp;signature=30f71455fc89e71492787e09741aa5fc49d31a928319523dcffd1922a912178c\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/mapsdata/2vIuMm-NznxqwPHg/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mapsdata API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#656c2e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.mapsdata.io/docs/endpoints/create-enrichment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/endpoints/create-enrichment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.mapsdata.io/#organization\",\"name\":\"Mapsdata API\",\"url\":\"https://www.mapsdata.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mapsdata/j7H3nB6-kjdlM0lM/images/logo.png?fit=max\u0026auto=format\u0026n=j7H3nB6-kjdlM0lM\u0026q=85\u0026s=30cfcb6e5c33b2d293fe5cb5b46e7f19\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.mapsdata.io/docs#website\",\"name\":\"Mapsdata API\",\"url\":\"https://www.mapsdata.io/docs\",\"publisher\":{\"@id\":\"https://www.mapsdata.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment#webpage\",\"url\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment\",\"name\":\"Create an enrichment\",\"description\":\"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\",\"dateModified\":\"2026-11-13T08:21:31.398Z\",\"isPartOf\":{\"@id\":\"https://www.mapsdata.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.mapsdata.io/docs/endpoints/get-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create an enrichment\",\"item\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment#apireference\",\"headline\":\"Create an enrichment\",\"name\":\"Create an enrichment\",\"description\":\"Enrich businesses you already selected using names and websites, Google Maps URLs, or Place IDs.\",\"url\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment\",\"mainEntityOfPage\":{\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-enrichment#webpage\"},\"dateModified\":\"2026-11-13T08:21:31.398Z\",\"publisher\":{\"@id\":\"https://www.mapsdata.io/#organization\"},\"isPartOf\":{\"@id\":\"https://www.mapsdata.io/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mapsdata API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mapsdata API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/endpoints/create-enrichment.md","siteName":"Mapsdata API","nav":{"global":null,"groups":[{"group":"Getting started","pages":[{"title":"Quickstart","href":"/index"},{"title":"MCP server","href":"/mcp-server"},{"title":"Authentication","href":"/authentication"},{"title":"Agent skill","href":"/agent-skill"}]},{"group":"Endpoints","pages":[{"title":"Get account","api":"GET /account","href":"/endpoints/get-account"},{"title":"Look up locations","api":"GET /locations","href":"/endpoints/get-locations"},{"title":"Look up categories","api":"GET /categories","href":"/endpoints/get-categories"},{"title":"Create a search","api":"POST /searches","href":"/endpoints/create-search"},{"title":"List searches","api":"GET /searches","href":"/endpoints/list-searches"},{"title":"Get search status","api":"GET /searches/{search_id}","href":"/endpoints/get-search"},{"title":"Get search results","api":"GET /searches/{search_id}/results","href":"/endpoints/get-results"},{"title":"Get a business","description":"Retrieve one complete business record by its result ID.","api":"GET /businesses/{business_id}","href":"/endpoints/get-business"},{"title":"Create an enrichment","api":"POST /enrichments","href":"/endpoints/create-enrichment"},{"title":"List enrichments","description":"List standalone enrichment jobs owned by the account.","api":"GET /enrichments","href":"/endpoints/list-enrichments"},{"title":"Get enrichment status","api":"GET /enrichments/{job_id}","href":"/endpoints/get-enrichment"},{"title":"Get enrichment results","api":"GET /enrichments/{job_id}/results","href":"/endpoints/get-enrichment-results"}]},{"group":"Reference","pages":[{"title":"Data fields","href":"/reference/data-fields"},{"title":"Search lifecycle","href":"/reference/search-lifecycle"},{"title":"Plans and credits","href":"/reference/plans-and-credits"},{"title":"Errors and rate limits","href":"/reference/errors-and-rate-limits"}]}]},"basePath":"","title":"Create an enrichment - Mapsdata API","buildId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","deploymentId":"dpl_Aw98ji4XvBsgtZwL1VrkUF9ehFqz","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CQGbdtm4.js","utils-D88A1f-Z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChqWdz1A.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-yBrxdh_6.js","snippetPresets-BgqDrFJC.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Duxc2rZw.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C7jidOil.js","shallow-xkjpHm-U.js","getApiPlaygroundDisplay-fE3rVpvL.js","CodeSnippet-LgxljKed.js","CodeSnippets-D-pXWDHq.js","Page-C2-BijcO.js","getPastedJson-CLRcu-uo.js","icon-Cxirpjgo.js","MethodPill-D49eqY5e.js","DuplicateIcon-CivCz5Rp.js","createIcon-D71qL3f5.js","DynamicMarkdown-BcGRTrw6.js","SectionHeading-DzaqmmSD.js","axios-vUo_bRtp.js"]}