Data fields

Result envelope

GET /searches/{search_id}/results and GET /enrichments/{job_id}/results return the same business shape. Search results appear as discovery imports them; enrichment jobs contain every submitted business immediately.

Field	Type	Description
`job_id`	string	Search UUID.
`status`	string	Current search lifecycle status.
`items`	array	Businesses in this page.
`total`	integer	Businesses available at the time of the request.
`page`	integer	Current one-based page.
`page_size`	integer	Requested page size.
`has_more`	boolean	Whether another page exists in this snapshot.

Business identity and rank

Field	Type	Description
`id`	string	Mapsdata lead UUID.
`search_id`	string	Parent search or enrichment-job UUID.
`position`	integer	Import position in the provider result set.
`rank`	integer	Stable alias of `position`.
`title`	string	Business name.
`category`	string \| null	Primary category label.
`categories`	string[]	All available category labels.
`category_id`	string \| null	Provider category identifier when available.
`place_id`	string \| null	Google Place ID or equivalent provider ID.
`cid`	string \| null	Google CID when available.
`claimed`	boolean \| null	Whether the Google Business Profile appears claimed.
`business_status`	string \| null	Provider business status such as `OPERATIONAL`.

Standalone enrichment begins with only title and website. Maps-only location, rank, reputation, and place-identity fields remain null unless later sources establish them. position and rank preserve the submitted array order.

Location and reputation

Field	Type	Description
`address`	string \| null	Formatted business address.
`street`	string \| null	Street address when supplied separately.
`city`	string \| null	City.
`state`	string \| null	Region or state.
`postal_code`	string \| null	Postal or ZIP code.
`country_code`	string \| null	ISO two-letter country code.
`rating`	number \| null	Aggregate Google rating.
`review_count`	integer \| null	Aggregate review count.
`google_maps_url`	string \| null	Direct Maps listing URL.
`image_url`	string \| null	Business image URL.
`logo_url`	string \| null	Business logo or profile image URL.

Website, phones, and socials

Field	Type	Description
`website`	string \| null	Canonical HTTP(S) website.
`website_display`	string \| null	Provider display form or domain.
`phone`	string \| null	Primary normalized business phone.
`additional_phones`	string[]	Additional unique phones.
`phone_types`	object	Phone number to inferred type mapping.
`phone_verifications`	object	Verified phone evidence keyed by number.
`socials`	object	Arrays keyed by network, including `facebooks`, `instagrams`, `linkedIns`, `twitters`, `youtubes`, `tiktoks`, `pinterests`, `whatsapps`, `tripadvisors`, `yelps`, `foursquares`, and `telegrams`.

People and emails

Field	Type	Description
`owner_name`	string \| null	First discovered owner, or first decision maker when no owner is available.
`owner_names`	string[]	Discovered owner names.
`decision_maker_names`	string[]	Discovered decision-maker names.
`verified_owner_names`	string[]	Owner names supported by a verification source.
`verified_decision_maker_names`	string[]	Decision makers supported by a verification source.
`owner_reasoning`	string \| null	Supporting explanation when available.
`emails`	string[]	All discovered business and direct emails.
`owner_emails`	string[]	Emails associated with owners.
`decision_maker_emails`	string[]	Emails associated with decision makers.
`email_verifications`	object	Per-address verification payload keyed by canonical lowercase email.
`email_verification_status`	string	Overall stage: typically `waiting`, `pending`, `processing`, `completed`, `failed`, or `skipped`.
`key_contacts`	object[]	Structured contacts collected from supporting public sources.

Enrichment states

The result exposes separate status fields because different sources can finish independently:

enrichment_status
owner_enrichment_status
facebook_enrichment_status
bbb_enrichment_status
yelp_enrichment_status
brave_owner_status
anymail_enrichment_status

Possible values depend on the stage and include waiting, pending, processing, completed, failed, skipped, and not_requested.

Arrays are returned as arrays even when empty. Optional scalar values use null. Do not substitute guessed field names: parse owner_emails, decision_maker_emails, and emails separately.

Interpret email verification

Look up each address in email_verifications. A result of ok with quality good is presented by Mapsdata as safe; catch-all, unknown, and lower-quality responses require caution. invalid should not be used. If the address has no terminal payload and the overall status is still active, wait for verification to finish.

Getting started

Endpoints

Reference

Result envelope

Business identity and rank

Location and reputation

Website, phones, and socials

People and emails

Enrichment states

Interpret email verification

​Result envelope

​Business identity and rank

​Location and reputation

​Website, phones, and socials

​People and emails

​Enrichment states

​Interpret email verification

Result envelope

Business identity and rank

Location and reputation

Website, phones, and socials

People and emails

Enrichment states

Interpret email verification