Search
Search and geocoding is tied to everything we build — maps, navigation, AR — and underlies every app that helps humans explore their world.
.png)
Powering the world's largest companies
The Mapbox Search API receives billions of requests per week and supports the scale of global companies such as Facebook, The Weather Company, Uber, Adobe, Snap, and Samsung.
160 data sources and translations for 39 languages
Mapbox integrates over 160 data sources to provide precise address, place, and point of interest coverage all over the world and in 39 languages.
Reliable results with 99.9% uptime
Mapbox’s Search API is fast, stable, and highly available for your apps. Custom rate-limits up to millions of requests per second.
Search SDK
Developers around the globe use the Search SDK to confidently power search for Android and iOS apps. Benefit from over 200 location categories, fresh data updates and prebuilt UI components to get you up and running fast.

Address & Points of Interest
Location bias and language automatically detected from the user’s devices.
Type-ahead
The Mapbox Geocoding API does two things: forward geocoding and reverse geocoding. Forward geocoding converts location text into geographic coordinates, turning 2 Lincoln Memorial Circle NW into -77.050,38.889.




History & Favorites
If a user has searched in app before, the Search SDK always suggests results from their search history If the user has favorites saved, the SDK suggests recent results as well as any favorites nearby. As the user keeps typing, the ratio of favorites and history in the suggested results changes to most closely match the user’s text.

Category Search: Search SDK
A search for “coffee” prioritizes the category type “coffee” above specific POIs and features with coffee in the name like “Caribou Coffee” or “Coffeebush Lane.”
Our algorithm determines the most relevant mix of proximate and culturally prominent features that match the query.
Custom Search Data
Kiwi.com travelers input the origins and destinations they’d like to explore and view every trip combination on a map. As you scroll, the map updates to show each connection, including nearby airports and their prices. Mapbox GL is rendering the map client-side at 60 frames-per-second, the speed of a video game. The map and data overlays instantly update as Kiwi.com’s algorithms crunch complex user queries. Zooming, panning, and filtering results remain seamless.

Modern Data Platform
Mapbox Search is powered by hundreds of sources that are tested and validated every day. Our data improves every day, and we guarantee you'll see the following:
Precision: More than 75% of requests are returned with the most precise placement possible. 100% of responses have an accuracy rating, so you know exactly how to interpret our data.
Accuracy: 85% of our locations are in agreement with all major location providers. Why not 100%? Our standards for agreement are high and not everything makes the cut. We're constantly testing, analyzing, and ingesting new data to give you the best search experience available. But you shouldn't take our word for it - get in touch and we'll prove it to you.

Modern Data Platform
Mapbox Search is powered by hundreds of sources that are tested and validated every day. Our data improves every day, and we guarantee you'll see the following:
Precision: More than 75% of requests are returned with the most precise placement possible. 100% of responses have an accuracy rating, so you know exactly how to interpret our data.
Accuracy: 85% of our locations are in agreement with all major location providers. Why not 100%? Our standards for agreement are high and not everything makes the cut. We're constantly testing, analyzing, and ingesting new data to give you the best search experience available. But you shouldn't take our word for it - get in touch and we'll prove it to you.
Learn about pricing for Search products on the pricing page.
Frequently asked questions
Getting Started
How does place search work?
The Geocoding API performs two main tasks: forward search and reverse geocoding. Forward search converts text into geographic coordinates, for example, turning 2 Lincoln Memorial Circle NW into -77.050,38.889. Reverse geocoding converts geographic coordinates into a text description, for example, turning -77.050,38.889 into 2 Lincoln Memorial Circle NW.
How do I use the API?
You can access the Geocoding API directly through Mapbox Studio, using one of several wrapper libraries, or call the API directly using your preferred HTTP client. If you would like to make calls directly, check out our full API documentation.
Can I test the API?
If you would like to get a feel for how the Geocoding API works without building a whole application, we also provide an API Playground. In addition to providing a convenient user interface to test queries, the API playground allows you to test the API’s URL and query parameters, such as type filters and proximity. If you need to test do bulk testing, contact us.
Data
What is the source data?
Mapbox Search contains data from open data projects, governments, and private companies, like Foursquare. Results may not match Mapbox Streets or OpenStreetMap data.
What are the data types?
What languages do you support?
The API accepts a language query parameter, which allows you to specify the language in which you would like to search. One or more languages can be specified using ISO 639-1 codes. Multilingual geocoding coverage varies and you can expect more consistent results for areas where the specified language is most widely used. We currently support 39 languages, detailed here.
Can I upload my own data to the Geocoding API?
No, you cannot upload your own data so it can be queried from the Geocoding API.
What's the difference between mapbox.places and mapbox.places-permanent?
The mapbox-places endpoint is accessible to all geocoding customers. Requests to this endpoint must be triggered by user activity. Any results cannot be stored permanently, as described in Mapbox’s terms of service. The mapbox.places-permanent endpoint allows you to store results and perform batch geocoding. This endpoint does not include point-of-interest features, and the data available for other feature types may vary slightly compared to the data available in the ephemeral endpoint.
General
Can I customize my query to tune results?
There are a number of optional parameters you can use to customize your queries in order to return the most relevant results. These parameters can be specified using URL query parameters or as options when building your application with one of our client side libraries or plugins. The parameters allow you to filter results by geographic feature type and limit or bias results to a specified area. For example, if you want to limit your search results to addresses in the Washington DC Metro area, you could set the type parameter to address and the bbox parameter to -77.08,38.90,-76.99,38.95. With those parameters set, your query for Constitution Ave will only return street addresses in the DC Metro area, and will not include features you’re not interested in, such as Constitution Ave, El Paso, Texas 79908, United States. Check out the Geocoding API documentation for more information on available features.
Can I store the results?
Yes. The mapbox.places-permanent endpoint allows for permanent storage of results and for batch geocoding. This endpoint does not include point-of-interest features, and the data available for other feature types may vary slightly compared to the data available in the ephemeral endpoint. Contact us for pricing.
Billing
How much does it cost?
Go to the pricing page to learn about pricing for temporary geocoding, and contact us about pricing for the permanent endpoint.