Skip to main content
POST
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.
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.

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.

Choose the workflow

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.