# Mapsdata API

> Search Google Maps and retrieve enriched local business leads.

- [Quickstart](https://www.mapsdata.io/docs/index.md): Search for local businesses, enrich them by domain, and get back verified owner names, owner and decision-maker emails, phone intelligence, social profiles, Google Maps data, and website intelligence.
- [Authentication](https://www.mapsdata.io/docs/authentication.md): Authenticate Mapsdata API requests and manage keys safely.
- [Agent skill](https://www.mapsdata.io/docs/agent-skill.md): Copy Mapsdata's complete API workflow into Claude Code, Codex, or another agent.
- [Get account](https://www.mapsdata.io/docs/endpoints/get-account.md): Read the current plan, subscription status, search allowance, and remaining credits.
- [Look up locations](https://www.mapsdata.io/docs/endpoints/get-locations.md): Find a city label that maps exactly to the Mapsdata search UI.
- [Look up categories](https://www.mapsdata.io/docs/endpoints/get-categories.md): Find normalized Google business categories for a search query.
- [Create a search](https://www.mapsdata.io/docs/endpoints/create-search.md): Queue a Google Maps business search and contact enrichment job.
- [List API searches](https://www.mapsdata.io/docs/endpoints/list-searches.md): List searches created through the public API.
- [Get search status](https://www.mapsdata.io/docs/endpoints/get-search.md): Read live job state, counts, billing, and terminal errors.
- [Get search results](https://www.mapsdata.io/docs/endpoints/get-results.md): Page through enriched businesses, including partial results from an active job.
- [Create an enrichment](https://www.mapsdata.io/docs/endpoints/create-enrichment.md): Enrich supplied businesses by company name and website without running a Maps search.
- [List enrichments](https://www.mapsdata.io/docs/endpoints/list-enrichments.md): List standalone enrichment jobs created through the API.
- [Get enrichment status](https://www.mapsdata.io/docs/endpoints/get-enrichment.md): Read live progress and terminal state for a standalone enrichment job.
- [Get enrichment results](https://www.mapsdata.io/docs/endpoints/get-enrichment-results.md): Read supplied businesses and their live enrichment fields.
- [Data fields](https://www.mapsdata.io/docs/reference/data-fields.md): Reference for search jobs, result pages, businesses, contacts, and verification.
- [Search lifecycle](https://www.mapsdata.io/docs/reference/search-lifecycle.md): Understand asynchronous jobs, live result delivery, dashboard sync, and safe polling.
- [Plans and credits](https://www.mapsdata.io/docs/reference/plans-and-credits.md): How account plans bound search size and reserve lead credits.
- [Errors and rate limits](https://www.mapsdata.io/docs/reference/errors-and-rate-limits.md): Handle Mapsdata API errors, retries, concurrency, and account-wide request limits.