Mapbox Geocoding API
High-quality forward and reverse geocoding powered by OpenStreetMap and proprietary data with autocomplete support.
🔴 Offline · 403 ms
0%
100,000 calls/month, free key, no credit card
API key
Free alternatives (live ranking)
- Nominatim (OpenStreetMap) — 🟢 Online · 1 req/sec, must set User-Agent, no key
- ip-api.com — 🟢 Online · 45 calls/min (HTTP only), no key, no credit card
- IPinfo — 🟢 Online · 50,000 calls/month, no key (token extends limits)
Compare Mapbox Geocoding API with…
- Mapbox Geocoding API vs Nominatim (OpenStreetMap) — 1 req/sec, must set User-Agent, no key
- Mapbox Geocoding API vs ip-api.com — 45 calls/min (HTTP only), no key, no credit card
- Mapbox Geocoding API vs IPinfo — 50,000 calls/month, no key (token extends limits)
Paid alternatives
- Mapbox Pay-As-You-Go — $0.75/1000 after free
Frequently Asked Questions
Does Mapbox Geocoding API require an API key?
Yes, Mapbox Geocoding API requires a free API key. You can sign up via https://docs.mapbox.com/api/search/geocoding/.
What is Mapbox Geocoding API's free tier?
100,000 calls/month, free key, no credit card
Is Mapbox Geocoding API currently online?
We check Mapbox Geocoding API every hour. The current status is shown at the top of this page. You can also see the 30-day uptime history in the chart above.
Implementation notes
When to use Mapbox Geocoding API
Mapbox Geocoding is the right pick when you also use Mapbox maps elsewhere in your stack — the API integrates seamlessly with Mapbox GL JS and includes proximity bias, country filtering, and language preference. Free tier covers 100,000 geocoding requests/month, the most generous in this category.
Common pitfalls
- Mapbox's ToS forbids storing geocoded coordinates for later reuse unless you're displaying them on a Mapbox map. Storing for later use with non-Mapbox maps violates terms and is detectable via API usage patterns.
- Free tier billing aggregates several products under one quota: geocoding, map tiles, directions, and matrix all consume from the 100k/month budget. A map-heavy app exhausts geocoding budget faster than expected.
- Geocoding results return as GeoJSON `FeatureCollection` with up to 5 candidates by default. The first feature is the highest-confidence match, but it's not always correct for ambiguous addresses — review the `relevance` scores rather than assuming index 0.
Quick start (bash)
curl "https://api.mapbox.com/geocoding/v5/mapbox.places/Eiffel%20Tower.json?access_token=YOUR_TOKEN&limit=1"Embed this badge
Add a live status badge to your README, docs, or website.
Markdown
[](https://freeapi.watch/mapbox-geocoding)HTML
<a href="https://freeapi.watch/mapbox-geocoding"><img src="https://freeapi-builder.a10ayassine.workers.dev/badge/mapbox-geocoding.svg" alt="Mapbox Geocoding API Status"/></a>