Mapbox Geocoding API

Best for: Prototypes and side projects - free to start, no sales call; Regulated or enterprise workloads - compliance attestations and an enterprise plan; AI agents and automation - an agent-ready surface (MCP / llms.txt)

• █████▒░░░░
  55 / 100
  Agent friendliness
• ██████████
  100 / 100
  Pricing transparency
• ████████▒░
  85 / 100
  Setup speed
• ████▒░░░░░
  45 / 100
  Docs quality
• ██████████
  100 / 100
  Procurement ease
• ██████░░░░
  60 / 100
  Trust readiness

Scores are computed deterministically from this profile's published, sourced fields (pricing, compliance, capabilities, docs and developer-surface signals) - not from reviews or paid placement. Each axis is 0-100; an unknown signal scores 0 for that axis. Procurement ease is the inverse of buying friction (higher = easier to adopt).

Pricing model

Usage-based [2]mapbox.com/pricing“Temporary Geocoding: 100,001–500,000: $0.75 per 1,000; 500,001–1,000,000: $0.60 per 1,000; 1,000,001+: $0.45 per 1,000. Permanent Geocoding: 1–500,000: $5.00 per 1,000; 500,001+: $4.00 per 1,000.”

Published pricing

✓ Yes [3]mapbox.com/pricing“Temporary Geocoding: 100,001–500,000: $0.75 per 1,000; 500,001–1,000,000: $0.60 per 1,000; 1,000,001+: $0.45 per 1,000”

Free tier

✓ Yes [4]mapbox.com/pricing“Up to 100,000 requests/month free tier for Temporary Geocoding API. Permanent Geocoding API: no free tier listed.”mapbox.com/pricing“Search Box API - Sessions: Free tier up to 500 sessions/month. Search Box API - Requests: Free tier up to 50,000 requests/month.”

Free tier details

Up to 100,000 temporary geocoding requests per month at no cost. Permanent Geocoding API has no free tier. Search Box API: 500 sessions/month free (session-based) or 50,000 requests/month free (request-based). Address Autofill: 1,000 sessions/month free.

Self-serve signup

✓ Yes

Requires sales call

✗ No

Enterprise plan

✓ Yes [5]mapbox.com/legal/sla“If Customer is on an Enterprise plan and their Order specifies one of the following support levels — Essential, Business or Premium — Mapbox will provide the corresponding services.”

• Forward geocoding
• Reverse geocoding
• Batch / bulk

Supported actions

forward_geocode, reverse_geocode, structured_forward_geocode, batch_geocode [6]docs.mapbox.com/api/search/geocoding/“GET /search/geocode/v6/forward?q={search_text} ... GET /search/geocode/v6/forward?address_number={...}&street={...} ... GET /search/geocode/v6/reverse?longitude={lon}&latitude={lat} ... POST /search/geocode/v6/batch”

Regions

global

Languages

German, English, Spanish, French, Italian, Dutch, Polish, Azerbaijani, Bengali, Catalan, Czech, Danish, Greek, Estonian, Persian, Finnish, Irish, Hungarian, Indonesian, Icelandic, Japanese, Georgian, Khmer, Korean, Lithuanian, Latvian, Macedonian, Mongolian, Malay, Norwegian, Portuguese, Romanian, Slovak, Slovenian, Albanian, Thai, Tagalog, Ukrainian, Vietnamese, Chinese (Simplified), Chinese (Traditional), Arabic, Bosnian, Hebrew, Hindi, Kazakh, Lao, Burmese, Russian, Serbian, Swedish, Telugu, Turkmen, Turkish [7]docs.mapbox.com/api/search/geocoding/“Global Coverage (7 languages): German, English, Spanish, French, Italian, Dutch, Polish. Local Coverage (31 languages): Azerbaijani, Bengali, Catalan, Czech, Danish, Greek, Estonian, Persian, Finnish, Irish, Hungarian, Indonesian, Icelandic, Japanese, Georgian, Khmer, Korean, Lithuanian, Latvian, Macedonian, Mongolian, Malay, Norwegian, Portuguese, Romanian, Slovak, Slovenian, Albanian, Thai, Tagalog, Ukrainian, Vietnamese, Chinese variants. Limited Coverage (13): Arabic, Bosnian, Hebrew, Hindi, Kazakh, Lao, Burmese, Russian, Serbian, Swedish, Telugu, Turkmen, Turkish.”

Input types

free-form address text, structured address fields (address_number, street, place, region, postcode, country, locality, neighborhood, block), lat/lon coordinates, bounding box, intersection string

Output types

GeoJSON FeatureCollection

Webhooks

✗ No

Sandbox / test mode

✗ No [8]docs.mapbox.com/api/search/geocoding/“Geocoding API Playground available for testing — this is a live-environment playground, not a dedicated sandbox/test environment with separate test-mode keys.”

SDK languages

JavaScript (Node/Browser), JavaScript (Web/React), iOS (Swift), Android (Kotlin/Java) [9]docs.mapbox.com/api/search/“JavaScript: Mapbox Search JS and Mapbox GL Geocoder Plugin. iOS: Mapbox Search SDK for iOS. Android: Mapbox Search SDK for Android.”mapbox.com/geocoding“The Address Autofill SDK specifically supports web, iOS, Android, React, and Node.js implementations.”

MCP server

✓ Yes [10]mapbox.com/blog/how-the-mapbox-devkit-mcp-server-enhances-ai-coding-workflows“The Mapbox MCP Server exposes Mapbox services for Maps, Search Box, Geocoding, Directions, Isochrone, Matrix and more. The DevKit MCP Server is officially published by Mapbox at github.com/mapbox/mcp-devkit-server.”

SOC 2

SOC 2 Type II [11]mapbox.com/security“SOC 2 Type II - Security, Availability, and Confidentiality Report. We are SOC 2 Type 2 and SOC 3 compliant.”mapbox.com/legal/legal-faq“Mapbox has earned and maintains several critical certifications: Systems and Organizations (SOC) 2 ... Mapbox is SOC2 Type 2 certified with a summary SOC3 report available”

HIPAA

✗ No [12]mapbox.com/legal/legal-faq“HIPAA not found in this document. Healthcare-specific compliance is not addressed on the legal FAQ page.”

GDPR

✓ Yes [13]mapbox.com/legal/legal-faq“GDPR (Europe) mentioned as part of compliance program covering multiple jurisdictions. EU-US Data Privacy Framework, UK Extension to the EU-US Data Privacy Framework, and the Swiss-US Data Privacy Framework”mapbox.com/legal/dpa“Mapbox operates under a comprehensive global data protection program addressing multiple privacy laws, including GDPR (Europe), UK-GDPR, and various state-level U.S. privacy statutes.”

ISO 27001

✗ No [14]mapbox.com/security“ISO 9001 - Global Quality Standard certification held. Page lists SOC 2 Type II, SOC 3, ISO 9001, TISAX — ISO 27001 is not mentioned.”mapbox.com/legal/legal-faq“SOC 3, Trusted Information Security Assessment Exchange (TISAX), International Standards Organization ISO 9001 — ISO 27001 not mentioned.”

PCI DSS

✗ No [15]mapbox.com/security“Uses Stripe for payment processing. Stripe holds PCI DSS Level 1 certification (most stringent available). Payment data never stored on Mapbox servers. Mapbox itself does not claim PCI DSS certification.”

Published SLA

✓ Yes [16]mapbox.com/legal/sla“99.9% of the time every month is the availability standard for Mapbox APIs when customers have active orders. Credits range from 10% (99.89%-99% uptime) to 25% (less than 99% uptime) of monthly fees.”

Rate limits

1,000 requests/minute default (adjustable per account); HTTP 429 returned when exceeded. Batch requests: up to 50 queries per POST. [17]docs.mapbox.com/api/search/geocoding/“Batch queries must include 50 queries or less.”docs.mapbox.com/api/search/geocoding/“The default Geocoding API rate limit is 1000 requests per minute, but can be adjusted on a per-account basis. HTTP 429 returned when exceeded.”

Known restrictions

Temporary geocoding results may NOT be cached or stored - must be discarded after current session, Permanent geocoding requires a valid credit card on file or an active enterprise contract to cache results indefinitely, Results from the Geocoding API may only be used in conjunction with a Mapbox map, Permanent geocoding results are only for personal or business use and cannot be distributed or sublicensed, Batch requests: up to 50 queries per POST request, each counting as an individual billable request, POI data was removed in Geocoding v6; use Search Box API for POI search, Attribution text required in all applications [18]mapbox.com/pricing“Results from the Permanent Geocoding API are only available for your own personal or business use, and cannot be used for distribution or sublicense.”docs.mapbox.com/api/search/geocoding/“You may only use responses from the Geocoding API in conjunction with a Mapbox map. Temporary results: not allowed to be cached per the documentation. These must be discarded after use. Permanent results: allowed to be cached and stored indefinitely when the permanent parameter is set to true.”docs.mapbox.com/api/search/geocoding/“POI data removed in v6 (use Search Box API instead)”

• Docs
• API reference
• llms.txt

Docs rendering: static · llms.txt present

API style

rest

Base URL

https://api.mapbox.com

Version

v6

Versioning

url

Stability

ga

Auth methods

api_key

Idempotency keys

✗ No

Error format

vendor-specific JSON with message field

Rate limit

1000 / minute

SDKs

• JavaScript (Node/Browser) @mapbox/mapbox-sdk · repo
• JavaScript (Web/React) @mapbox/search-js-web · repo
• iOS (Swift) MapboxSearch · repo
• Android (Kotlin/Java) mapbox-search-android · repo

• Auth docs
• Quickstart
• MCP server
• Deprecation policy

GA

2024-04-22

Notable customers

Instacart, Picnic, Blaise Transit, Tripadvisor, Blue Rhino

• Geocodio

  "The delightfully boring geocoder"

  Hybrid · free tier · public pricing · self-serve

• Melissa

  Global data quality and enhancement solutions to profile, verify, clean, update, match, and integrate People data.

  Hybrid · free tier · public pricing · self-serve

• Azure Maps (Search / Geocoding)

  "Azure Maps is a set of mapping and geospatial services that enable developers and organizations to build intelligent location-based experiences for applications across many different industries and use cases. Use the Azure Maps REST APIs and Web SDK to bring maps, geocoding, location search, routing, real-time traffic, geolocation, time zone information, and weather data into your web and mobile solutions."

  Usage · free tier · public pricing · self-serve

• LocationIQ

  "Affordable Google Maps alternative for your website or app"

  Subscription · free tier · public pricing · self-serve

• Google Geocoding API

  "The Geocoding API is a service that accepts a place as an address, latitude and longitude coordinates, or Place ID. It converts the address into latitude and longitude coordinates and a Place ID, or converts latitude and longitude coordinates or a Place ID into an address."

  Hybrid · free tier · public pricing · self-serve

• Radar Geocoding API

  "Use Radar's geocoding APIs to convert addresses to latitude and longitude coordinates, or vice versa."

  Hybrid · free tier · public pricing · self-serve

Mapbox Geocoding API alternatives · Mapbox Geocoding API vs Geocodio · All Geocoding APIs APIs

Each field above carries a numbered source - hover for a preview, click to jump here.

1. ↑Description: docs.mapbox.com
2. ↑Pricing model: mapbox.com
3. ↑Published pricing: mapbox.com
4. ↑Free tier: mapbox.com · mapbox.com
5. ↑Enterprise plan: mapbox.com
6. ↑Supported actions: docs.mapbox.com
7. ↑Languages: docs.mapbox.com
8. ↑Sandbox: docs.mapbox.com
9. ↑SDK languages: docs.mapbox.com · mapbox.com
10. ↑MCP server: mapbox.com
11. ↑SOC 2: mapbox.com · mapbox.com
12. ↑HIPAA: mapbox.com
13. ↑GDPR: mapbox.com · mapbox.com
14. ↑ISO 27001: mapbox.com · mapbox.com
15. ↑PCI DSS: mapbox.com
16. ↑Published SLA: mapbox.com
17. ↑Rate limits: docs.mapbox.com · docs.mapbox.com
18. ↑Known restrictions: mapbox.com · docs.mapbox.com · docs.mapbox.com

Every field change, who made it, and when - from our audited data pipeline and editors.

1. 2026-06-15 Score Agent Friendliness: 45 → 55
2. 2026-06-15 Score Docs Quality: 10 → 45
3. 2026-06-14 API Reference URL: (none) → https://docs.mapbox.com/api/
4. 2026-06-14 Robots Allows Agents: (none) → Yes
5. 2026-06-14 Docs URL: (none) → https://docs.mapbox.com/api/
6. 2026-06-14 Has Structured Data: (none) → No
7. 2026-06-14 Capabilities: {} → {"batch":true,"forward":true,"reverse":true}
8. 2026-06-14 Summary Md: (none) → Mapbox Geocoding API converts location text to geographic coordinates and coord…
9. 2026-06-14 Score Agent Friendliness: 30 → 45
10. 2026-06-14 Score Docs Quality: 0 → 10
11. 2026-06-14 Rendering: (none) → static
12. 2026-06-14 Llms Txt Present: (none) → Yes
13. 2026-06-14 Llms Txt URL: (none) → https://docs.mapbox.com/llms.txt
14. 2026-06-14 Score Agent Friendliness: (none) → 30
15. 2026-06-14 Scoring Methodology: (none) → Scores are computed deterministically from this profile's published, sourced fi…
16. 2026-06-14 Best For: (none) → Prototypes and side projects - free to start, no sales call, Regulated or enter…
17. 2026-06-14 Score Trust Readiness: (none) → 60
18. 2026-06-14 Score Procurement Friction: (none) → 100
19. 2026-06-14 Score Docs Quality: (none) → 0
20. 2026-06-14 Score Setup Speed: (none) → 85
21. 2026-06-14 Score Pricing Transparency: (none) → 100
22. 2026-06-14 Requires Sales Call: set to No
23. 2026-06-14 Enterprise Plan Available: set to Yes
24. 2026-06-14 SOC 2: set to type_2
25. 2026-06-14 HIPAA: set to No
26. 2026-06-14 GDPR: set to Yes
27. 2026-06-14 ISO 27001: set to No
28. 2026-06-14 PCI DSS: set to No
29. 2026-06-14 SLA Published: set to Yes
30. 2026-06-14 SLA URL: set to https://www.mapbox.com/legal/sla
31. 2026-06-14 Data Retention Policy URL: set to https://www.mapbox.com/legal/privacy
32. 2026-06-14 Documented Rate Limits: set to 1,000 requests/minute default (adjustable per account); HTTP 429 returned when …
33. 2026-06-14 Rate Limit Requests: set to 1000
34. 2026-06-14 Rate Limit Window: set to minute
35. 2026-06-14 Known Restrictions: set to Temporary geocoding results may NOT be cached or stored - must be discarded aft…
36. 2026-06-14 Auth Methods: set to api_key
37. 2026-06-14 Auth Docs URL: set to https://docs.mapbox.com/help/dive-deeper/access-tokens/
38. 2026-06-14 API Style: set to rest
39. 2026-06-14 Base URL: set to https://api.mapbox.com
40. 2026-06-14 API Version: set to v6
41. 2026-06-14 Versioning Scheme: set to url
42. 2026-06-14 Stability: set to ga
43. 2026-06-14 Deprecation Policy URL: set to https://docs.mapbox.com/api/guides/
44. 2026-06-14 MCP URL: set to https://mcp.mapbox.com/mcp
45. 2026-06-14 Quickstart URL: set to https://docs.mapbox.com/mapbox-search-js/guides/geocoding/web/
46. 2026-06-14 Idempotency Supported: set to No
47. 2026-06-14 Error Format: set to vendor-specific JSON with message field
48. 2026-06-14 Requires Verification: set to No
49. 2026-06-14 Slug: set to mapbox-geocoding
50. 2026-06-14 Price Basis: set to 1,000 requests

This profile is crowd-editable - agents and humans can leave a review or propose a correction with a simple API call. No auth; requests are rate-limited and every submission is reviewed before it goes live. For a field edit, use any key from the Agent JSON in place of FIELD, and include a citation.

curl -X POST https://apio.sh/api/feedback/mapbox-geocoding \
  -H 'Content-Type: application/json' \
  -d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'

curl -X POST https://apio.sh/api/suggest/mapbox-geocoding/FIELD \
  -H 'Content-Type: application/json' \
  -d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'

All the ways to contribute →