curl -X POST "https://www.mapsdata.io/api/v1/searches" \ -H "Content-Type: application/json" \ -H "x-api-key: md_live_your_key" \ -H "Idempotency-Key: ny-plumbers-2026-10-01" \ -d '{ "name": "New York plumbers", "input": { "query": "plumbers", "location": "New York, New York", "countryCode": "US", "maxResults": 100, "language": "en" }, "enrich_contacts": true }'
{ "job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc", "status": "queued", "credits_reserved": 0, "message": "Search accepted. It is visible in your Mapsdata dashboard."}
Endpoints
Create a search
Queue a Google Maps business search and contact enrichment job.
POST
/
searches
curl -X POST "https://www.mapsdata.io/api/v1/searches" \ -H "Content-Type: application/json" \ -H "x-api-key: md_live_your_key" \ -H "Idempotency-Key: ny-plumbers-2026-10-01" \ -d '{ "name": "New York plumbers", "input": { "query": "plumbers", "location": "New York, New York", "countryCode": "US", "maxResults": 100, "language": "en" }, "enrich_contacts": true }'
{ "job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc", "status": "queued", "credits_reserved": 0, "message": "Search accepted. It is visible in your Mapsdata dashboard."}
Creates an asynchronous search backed by the same queue, workers, credit balance, and result store as the Mapsdata dashboard. The response is 202 Accepted.
string
required
A stable unique value for one logical search. Use a UUID or a readable key such as ny-plumbers-2026-10-01. Required in production.
string
Dashboard list name, up to 200 characters. Defaults to {query} in {location}.
object
required
Search input shared with the web app.
Show input fields
string
required
Business type or search phrase, up to 300 characters.
string
required
Use the label returned by GET /locations, for example New York, New York.
string
Uppercase ISO two-letter country code, for example US.
integer
default:"100"
Requested businesses. Minimum 100; current product maximum 700.
string
default:"en"
Two- or three-letter language code, optionally followed by a locale.
boolean
default:"true"
Set true for the full discovery and enrichment pipeline. Set false for Google Maps business discovery only; returned enrichment status fields are not_requested.
curl -X POST "https://www.mapsdata.io/api/v1/searches" \ -H "Content-Type: application/json" \ -H "x-api-key: md_live_your_key" \ -H "Idempotency-Key: ny-plumbers-2026-10-01" \ -d '{ "name": "New York plumbers", "input": { "query": "plumbers", "location": "New York, New York", "countryCode": "US", "maxResults": 100, "language": "en" }, "enrich_contacts": true }'
{ "job_id": "c15dbb36-5a56-4720-b1af-b388bcaf78dc", "status": "queued", "credits_reserved": 0, "message": "Search accepted. It is visible in your Mapsdata dashboard."}
Credits and rejection behavior
An active subscription or trial is required. The trial lasts 3 days, includes 300 credits, and can be canceled anytime.
Pay-on-Find accounts reserve 0 credits at creation. Contact outcomes are charged after enrichment completes.
An enriched trial search needs at least 1 available credit per requested business and is limited to 300 businesses. An enriched paid search needs at least 1.5 available credits per requested business. Running enriched jobs count against that available starting balance.
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 business; no billable contact found costs 0.
Requests below 100 return 422 before a job is created or credits are reserved.
A request above the 700-business product ceiling returns 403.
Rejected requests create no job and deduct no credits.
Once accepted, a search finishes and returns all contact data found. Its charge is capped at the remaining balance, which stops at zero; the job is never interrupted or redacted midway.
With enrich_contacts: false, Mapsdata still returns business name, category, address, phone, website, rating, review count, status, and Maps identifiers when the discovery provider supplies them. It skips website crawling, people and email discovery, public-source enrichment, and email verification. The job completes directly after import.
Safe retries
Sending the same body and idempotency key returns the existing job without charging twice. Reusing the key with a different name, input, or enrichment setting returns 409 Conflict.
API-created jobs appear in Dashboard and Lead lists immediately. Partial businesses are imported and shown in the UI while the job is still running.
{"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-search","slug":"/endpoints/create-search","pageMetadata":{"title":"Create a search","description":"Queue a Google Maps business search and contact enrichment job.","api":"POST /searches","href":"/endpoints/create-search"},"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: \"Queue a Google Maps business search and contact enrichment job.\"\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={a:`a`,code:`code`,li:`li`,p:`p`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{Expandable,Heading,ParamField,Table}=_components;if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Creates an asynchronous search backed by the same queue, workers, credit balance, and result store as the Mapsdata dashboard. The response is `,_jsx(_components.code,{children:`202 Accepted`}),`.`]}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,required:true,id:`param-idempotency-key`,children:_jsxs(_components.p,{children:[`A stable unique value for one logical search. Use a UUID or a readable key such as `,_jsx(_components.code,{children:`ny-plumbers-2026-10-01`}),`. Required in production.`]})}),`\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:`{query} in {location}`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`input`,type:`object`,required:true,id:`param-input`,children:[_jsx(_components.p,{children:`Search input shared with the web app.`}),_jsxs(Expandable,{title:`input fields`,children:[_jsx(ParamField,{body:`input.query`,type:`string`,required:true,id:`param-input-query`,children:`Business type or search phrase, up to 300 characters.`}),_jsxs(ParamField,{body:`input.location`,type:`string`,required:true,id:`param-input-location`,children:[`Use the `,_jsx(_components.code,{children:`label`}),` returned by `,_jsx(_components.code,{children:`GET /locations`}),`, for example `,_jsx(_components.code,{children:`New York, New York`}),`.`]}),_jsxs(ParamField,{body:`input.countryCode`,type:`string`,id:`param-input-country-code`,children:[`Uppercase ISO two-letter country code, for example `,_jsx(_components.code,{children:`US`}),`.`]}),_jsxs(ParamField,{body:`input.maxResults`,type:`integer`,default:`100`,id:`param-input-max-results`,children:[`Requested businesses. Minimum `,_jsx(_components.code,{children:`100`}),`; current product maximum `,_jsx(_components.code,{children:`700`}),`.`]}),_jsx(ParamField,{body:`input.language`,type:`string`,default:`en`,id:`param-input-language`,children:`Two- or three-letter language code, optionally followed by a locale.`})]})]}),`\n`,_jsx(ParamField,{body:`enrich_contacts`,type:`boolean`,default:`true`,id:`param-enrich-contacts`,children:_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`true`}),` for the full discovery and enrichment pipeline. Set `,_jsx(_components.code,{children:`false`}),` for Google Maps business discovery only; returned enrichment status fields are `,_jsx(_components.code,{children:`not_requested`}),`.`]})}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`credits-and-rejection-behavior`,children:`Credits and rejection behavior`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An active subscription or trial is required. The trial lasts 3 days, includes 300 credits, and can be canceled anytime.`}),`\n`,_jsx(_components.li,{children:`Pay-on-Find accounts reserve 0 credits at creation. Contact outcomes are charged after enrichment completes.`}),`\n`,_jsx(_components.li,{children:`An enriched trial search needs at least 1 available credit per requested business and is limited to 300 businesses. An enriched paid search needs at least 1.5 available credits per requested business. Running enriched jobs count against that available starting balance.`}),`\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 business; no billable contact found costs 0.`}),`\n`,_jsxs(_components.li,{children:[`Requests below 100 return `,_jsx(_components.code,{children:`422`}),` before a job is created or credits are reserved.`]}),`\n`,_jsxs(_components.li,{children:[`A request above the 700-business product ceiling returns `,_jsx(_components.code,{children:`403`}),`.`]}),`\n`,_jsx(_components.li,{children:`Rejected requests create no job and deduct no credits.`}),`\n`,_jsx(_components.li,{children:`Once accepted, a search finishes and returns all contact data found. Its charge is capped at the remaining balance, which stops at zero; the job is never interrupted or redacted midway.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`choose-the-workflow`,children:`Choose the workflow`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Goal`}),_jsx(_components.th,{children:`Request`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Search Google Maps only`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`POST /searches`}),` with `,_jsx(_components.code,{children:`enrich_contacts: false`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Search and enrich every result`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`POST /searches`}),` with `,_jsx(_components.code,{children:`enrich_contacts: true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enrich businesses you already have`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/endpoints/create-enrichment`,children:_jsx(_components.code,{children:`POST /enrichments`})})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`With `,_jsx(_components.code,{children:`enrich_contacts: false`}),`, Mapsdata still returns business name, category, address, phone, website, rating, review count, status, and Maps identifiers when the discovery provider supplies them. It skips website crawling, people and email discovery, public-source enrichment, and email verification. The job completes directly after import.`]}),`\n`,_jsx(Heading,{level:`2`,id:`safe-retries`,children:`Safe retries`}),`\n`,_jsxs(_components.p,{children:[`Sending the same body and idempotency key returns the existing job without charging twice. Reusing the key with a different name, input, or enrichment setting returns `,_jsx(_components.code,{children:`409 Conflict`}),`.`]}),`\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:_jsx(_components.p,{children:`API-created jobs appear in Dashboard and Lead lists immediately. Partial businesses are imported and shown in the UI while the job is still running.`})})]})}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 a search","description":"Queue a Google Maps business search and contact enrichment job.","api":"POST /searches","href":"/endpoints/create-search"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,RequestExample,ResponseExample,Table}=_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);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Creates an asynchronous search backed by the same queue, workers, credit balance, and result store as the Mapsdata dashboard. The response is `,_jsx(_components.code,{children:`202 Accepted`}),`.`]}),`\n`,_jsx(ParamField,{header:`Idempotency-Key`,type:`string`,required:true,id:`param-idempotency-key`,children:_jsxs(_components.p,{children:[`A stable unique value for one logical search. Use a UUID or a readable key such as `,_jsx(_components.code,{children:`ny-plumbers-2026-10-01`}),`. Required in production.`]})}),`\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:`{query} in {location}`}),`.`]})}),`\n`,_jsxs(ParamField,{body:`input`,type:`object`,required:true,id:`param-input`,children:[_jsx(_components.p,{children:`Search input shared with the web app.`}),_jsxs(Expandable,{title:`input fields`,children:[_jsx(ParamField,{body:`input.query`,type:`string`,required:true,id:`param-input-query`,children:`Business type or search phrase, up to 300 characters.`}),_jsxs(ParamField,{body:`input.location`,type:`string`,required:true,id:`param-input-location`,children:[`Use the `,_jsx(_components.code,{children:`label`}),` returned by `,_jsx(_components.code,{children:`GET /locations`}),`, for example `,_jsx(_components.code,{children:`New York, New York`}),`.`]}),_jsxs(ParamField,{body:`input.countryCode`,type:`string`,id:`param-input-country-code`,children:[`Uppercase ISO two-letter country code, for example `,_jsx(_components.code,{children:`US`}),`.`]}),_jsxs(ParamField,{body:`input.maxResults`,type:`integer`,default:`100`,id:`param-input-max-results`,children:[`Requested businesses. Minimum `,_jsx(_components.code,{children:`100`}),`; current product maximum `,_jsx(_components.code,{children:`700`}),`.`]}),_jsx(ParamField,{body:`input.language`,type:`string`,default:`en`,id:`param-input-language`,children:`Two- or three-letter language code, optionally followed by a locale.`})]})]}),`\n`,_jsx(ParamField,{body:`enrich_contacts`,type:`boolean`,default:`true`,id:`param-enrich-contacts`,children:_jsxs(_components.p,{children:[`Set `,_jsx(_components.code,{children:`true`}),` for the full discovery and enrichment pipeline. Set `,_jsx(_components.code,{children:`false`}),` for Google Maps business discovery only; returned enrichment status fields are `,_jsx(_components.code,{children:`not_requested`}),`.`]})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`15`,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:`15`,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/searches\"`}),_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: ny-plumbers-2026-10-01\"`}),_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\": \"New York plumbers\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"input\": {`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"query\": \"plumbers\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"location\": \"New York, New York\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"countryCode\": \"US\",`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"maxResults\": 100,`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"language\": \"en\"`})}),`\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:` \"enrich_contacts\": true`})}),`\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:`6`,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:`6`,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:`\"c15dbb36-5a56-4720-b1af-b388bcaf78dc\"`}),_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:` \"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:`\"Search 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:`credits-and-rejection-behavior`,children:`Credits and rejection behavior`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`An active subscription or trial is required. The trial lasts 3 days, includes 300 credits, and can be canceled anytime.`}),`\n`,_jsx(_components.li,{children:`Pay-on-Find accounts reserve 0 credits at creation. Contact outcomes are charged after enrichment completes.`}),`\n`,_jsx(_components.li,{children:`An enriched trial search needs at least 1 available credit per requested business and is limited to 300 businesses. An enriched paid search needs at least 1.5 available credits per requested business. Running enriched jobs count against that available starting balance.`}),`\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 business; no billable contact found costs 0.`}),`\n`,_jsxs(_components.li,{children:[`Requests below 100 return `,_jsx(_components.code,{children:`422`}),` before a job is created or credits are reserved.`]}),`\n`,_jsxs(_components.li,{children:[`A request above the 700-business product ceiling returns `,_jsx(_components.code,{children:`403`}),`.`]}),`\n`,_jsx(_components.li,{children:`Rejected requests create no job and deduct no credits.`}),`\n`,_jsx(_components.li,{children:`Once accepted, a search finishes and returns all contact data found. Its charge is capped at the remaining balance, which stops at zero; the job is never interrupted or redacted midway.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`choose-the-workflow`,children:`Choose the workflow`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Goal`}),_jsx(_components.th,{children:`Request`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Search Google Maps only`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`POST /searches`}),` with `,_jsx(_components.code,{children:`enrich_contacts: false`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Search and enrich every result`}),_jsxs(_components.td,{children:[_jsx(_components.code,{children:`POST /searches`}),` with `,_jsx(_components.code,{children:`enrich_contacts: true`})]})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Enrich businesses you already have`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/endpoints/create-enrichment`,children:_jsx(_components.code,{children:`POST /enrichments`})})})]})]})]}),`\n`,_jsxs(_components.p,{children:[`With `,_jsx(_components.code,{children:`enrich_contacts: false`}),`, Mapsdata still returns business name, category, address, phone, website, rating, review count, status, and Maps identifiers when the discovery provider supplies them. It skips website crawling, people and email discovery, public-source enrichment, and email verification. The job completes directly after import.`]}),`\n`,_jsx(Heading,{level:`2`,id:`safe-retries`,children:`Safe retries`}),`\n`,_jsxs(_components.p,{children:[`Sending the same body and idempotency key returns the existing job without charging twice. Reusing the key with a different name, input, or enrichment setting returns `,_jsx(_components.code,{children:`409 Conflict`}),`.`]}),`\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:_jsx(_components.p,{children:`API-created jobs appear in Dashboard and Lead lists immediately. Partial businesses are imported and shown in the UI while the job is still running.`})})]})}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 a search","description":"Queue a Google Maps business search and contact enrichment job.","api":"POST /searches","href":"/endpoints/create-search"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Credits and rejection behavior","slug":"credits-and-rejection-behavior","depth":2,"children":[]},{"title":"Choose the workflow","slug":"choose-the-workflow","depth":2,"children":[]},{"title":"Safe retries","slug":"safe-retries","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=\"15\">\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/searches\"\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: ny-plumbers-2026-10-01\"\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\": \"New York plumbers\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"input\": {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"query\": \"plumbers\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"location\": \"New York, New York\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"countryCode\": \"US\",\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"maxResults\": 100,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"language\": \"en\"\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\"> \"enrich_contacts\": true\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=\"6\">\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\">\"c15dbb36-5a56-4720-b1af-b388bcaf78dc\"\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\"> \"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\">\"Search 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 a search","path":"/searches","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 search. Use a UUID or a readable key such as `ny-plumbers-2026-10-01` . Required in production.","required":true}]}},"cookie":{},"path":{}},"body":{"application/json":{"schemaArray":[{"type":"object","properties":{"name":[{"type":"string","description":"Dashboard list name, up to 200 characters. Defaults to `{query} in {location}` ."}],"input":[{"type":"object","properties":{"input.query":[{"type":"string","description":"Business type or search phrase, up to 300 characters.","required":true}],"input.location":[{"type":"string","description":"Use the `label` returned by `GET /locations` , for example `New York, New York` .","required":true}],"input.countryCode":[{"type":"string","description":"Uppercase ISO two-letter country code, for example `US` ."}],"input.maxResults":[{"type":"integer","description":"Requested businesses. Minimum `100` ; current product maximum `700` ."}],"input.language":[{"type":"string","description":"Two- or three-letter language code, optionally followed by a locale."}]},"description":"Search input shared with the web app.","required":true}],"enrich_contacts":[{"type":"boolean","description":"Set `true` for the full discovery and enrichment pipeline. Set `false` for Google Maps business discovery only; returned enrichment status fields are `not_requested` ."}]}}],"examples":{"example":{"value":{"name":"\u003cstring>","input":{"input.query":"\u003cstring>","input.location":"\u003cstring>","input.countryCode":"\u003cstring>","input.maxResults":123,"input.language":"\u003cstring>"},"enrich_contacts":true}}}}}},"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 a search - Mapsdata API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-21T11:42:27.719Z","originalFileLocation":"endpoints/create-search.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=\"Queue a Google Maps business search and contact enrichment job.\">\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 a search - Mapsdata API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Queue a Google Maps business search and contact enrichment job.\">\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-search\">\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+a+search\u0026amp;description=Queue+a+Google+Maps+business+search+and+contact+enrichment+job.\u0026amp;theme=b297a435d1be9dc8884e4547\u0026amp;signature=45ccb154bd6c875edfeda68de284b8a40019d8e33882aeba74711a9b45e5c6cf\">\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 a search - Mapsdata API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Queue a Google Maps business search and contact enrichment job.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mapsdata.mintlify.site/docs/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Create+a+search\u0026amp;description=Queue+a+Google+Maps+business+search+and+contact+enrichment+job.\u0026amp;theme=b297a435d1be9dc8884e4547\u0026amp;signature=45ccb154bd6c875edfeda68de284b8a40019d8e33882aeba74711a9b45e5c6cf\">\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-search\">\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-search.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-search#webpage\",\"url\":\"https://www.mapsdata.io/docs/endpoints/create-search\",\"name\":\"Create a search\",\"description\":\"Queue a Google Maps business search and contact enrichment job.\",\"dateModified\":\"2026-10-21T11:42:27.719Z\",\"isPartOf\":{\"@id\":\"https://www.mapsdata.io/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-search#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-search#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://www.mapsdata.io/docs/endpoints/get-account\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create a search\",\"item\":\"https://www.mapsdata.io/docs/endpoints/create-search\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-search#apireference\",\"headline\":\"Create a search\",\"name\":\"Create a search\",\"description\":\"Queue a Google Maps business search and contact enrichment job.\",\"url\":\"https://www.mapsdata.io/docs/endpoints/create-search\",\"mainEntityOfPage\":{\"@id\":\"https://www.mapsdata.io/docs/endpoints/create-search#webpage\"},\"dateModified\":\"2026-10-21T11:42:27.719Z\",\"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-search.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","description":"Find normalized Google business categories for a search query.","api":"GET /categories","href":"/endpoints/get-categories"},{"title":"Create a search","api":"POST /searches","href":"/endpoints/create-search"},{"title":"List searches","description":"List dashboard, REST API, and MCP searches for the account.","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","api":"GET /businesses/{business_id}","href":"/endpoints/get-business"},{"title":"Create an enrichment","api":"POST /enrichments","href":"/endpoints/create-enrichment"},{"title":"List enrichments","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 a search - 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"]}