Mapbox Search Box 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“Session-based pricing: free up to 500/month, then $11.50 per 1,000 sessions (501–100,000). Request-based pricing: free up to 25,000/month, then $1.70 per 1,000 (25,001–100,000). No flat subscription fee — pure usage-based with volume tiers.”

Published pricing

✓ Yes [3]mapbox.com/pricing“501 - 100,000 sessions: $11.50 per 1,000; 100,001 - 200,000 sessions: $10.00 per 1,000; 200,001 - 500,000 sessions: $8.40 per 1,000; 500,001 - 1,000,000 sessions: $6.60 per 1,000”

Free tier

✓ Yes [4]mapbox.com/pricing“Free Tier: Up to 500 sessions/month at no cost; Free Tier: Up to 25,000 requests/month”mapbox.com/pricing“The introductory preview pricing that was available previously has transitioned to standard pricing as of Q4 2025. No separate enterprise tier is listed; higher volume users should contact sales for discount.”

Free tier details

500 sessions/month free; 25,000 requests/month free (for non-session endpoints: /category, /reverse). Perpetual recurring free allowance - not a trial credit. [5]mapbox.com/pricing“Session-Based Pricing — Free Tier: Up to 500 sessions/month at no cost; Request-Based Pricing — Free Tier: Up to 25,000 requests/month”

Self-serve signup

✓ Yes [6]mapbox.com/pricing“Self-serve signup available; Automatically get volume pricing as your usage grows”

Requires sales call

✗ No

Enterprise plan

✓ Yes [7]mapbox.com/pricing“higher volume users should contact sales for discount”

• POI search
• Nearby / radius
• Autocomplete
• Place details

Supported actions

suggest, retrieve, forward, category, reverse, list_category [8]docs.mapbox.com/api/search/search-box/“/suggest - Get autocomplete suggestions for search queries; /retrieve - Retrieve detailed information about a suggested feature; /forward - Text search to get results with coordinates; /category/{canonical_category_id} - Search POIs by category; /list/category - Get available categories list; /reverse - Reverse lookup to find features at specific coordinates”

Regions

United States, Canada, Europe, 80+ countries globally (53 new countries added 2025), 330 million POIs globally, 375 million addresses globally [9]docs.mapbox.com/api/search/search-box/“Supported regions: United States, Canada, and Europe”mapbox.com/search-box“375M+ addresses globally; 170M+ points of interest (POIs) worldwide”mapbox.com/blog/mapbox-search-box-api-expanded-poi-coverage-smarter-search“53 new countries added in 2025; 375 million addresses; 330 million points of interest (POIs)”

Languages

Czech, Croatian, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Italian, Japanese, Lithuanian, Latvian, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Turkish, Ukrainian [10]docs.mapbox.com/api/search/search-box/“Czech, Croatian, Danish, Dutch, English, Estonian, Finnish, French, German, Greek, Hungarian, Italian, Japanese, Lithuanian, Latvian, Polish, Portuguese, Romanian, Russian, Slovak, Slovenian, Spanish, Swedish, Turkish, Ukrainian”

Input types

text query, coordinates (lat/lon), place id (session token + suggestion id), bounding box, country code, category name, POI category filter, polyline (search along route)

Output types

JSON, GeoJSON FeatureCollection

Webhooks

✗ No

Sandbox / test mode

✗ No [11]docs.mapbox.com/api/search/search-box/“A developer playground is referenced: 'Search Box API Developer Playground' allows testing queries on a map, plus a 'User Demo' for interactive search testing. This is a live-environment playground, not a dedicated sandbox with test-mode keys.”

SDK languages

JavaScript (Web), JavaScript (React), JavaScript (Core/Node), Swift/iOS, Kotlin/Android [12]docs.mapbox.com/api/search/search-box/“Mapbox Search JS - Web, React, Node.js; Mapbox Search SDK for Android; Mapbox Search SDK for iOS”

MCP server

✓ Yes [13]docs.mapbox.com/api/guides/mcp-server/“Uses the Search Box API to search for and geocode POIs, addresses, and places.”docs.mapbox.com/api/guides/mcp-server/“Hosted MCP Server URL: https://mcp.mapbox.com/mcp”

SOC 2

SOC 2 Type II [14]mapbox.com/security“SOC 2 Type II: Security, Availability, and Confidentiality Report; SOC 3: General Control Report. We are SOC 2 Type 2 and SOC 3 compliant.”

HIPAA

✗ No [15]mapbox.com/security“ISO 27001, HIPAA, and PCI DSS are not mentioned as Mapbox certifications. Only SOC 2 Type II, SOC 3, ISO 9001, and TISAX are listed.”

GDPR

✓ Yes [16]mapbox.com/privacy“This privacy policy applies to the extent Mapbox processes personal data in its capacity as a data controller under the GDPR.”mapbox.com/privacy“customers/prospective customers should read Mapbox's data processing addendum ("DPA"): https://www.mapbox.com/legal/dpa which governs certain customer personal data.”

ISO 27001

✗ No [17]mapbox.com/security“Certifications listed: SOC 2 Type II, SOC 3, ISO 9001 (Global Quality Standard), TISAX (Automotive Industry Standard). ISO 27001 is not mentioned.”

PCI DSS

✗ No [18]mapbox.com/security“Payment Card Industry Standard-certified refers to Stripe (their payment processor), not Mapbox itself as an API provider.”

Published SLA

✓ Yes [19]mapbox.com/sla“If Customer has an active executed order, and the Mapbox APIs covered by and used in accordance with such order are not available 99.9% of the time every month, Customer will be eligible to receive a Service Credit”

Rate limits

10 requests per second (default); sessions expire after 50 successive /suggest calls, 180 seconds of inactivity, or after /suggest → /retrieve completion; query string max 256 characters; max 10 results per request (25 for /category) [20]docs.mapbox.com/api/search/search-box/“The default rate limit for the Mapbox Search Box API is 10 requests per second. Sessions end when: /suggest followed by /retrieve with matching token completes; /suggest called without /retrieve within 180 seconds; 50 successive /suggest calls occur with same token.”

Known restrictions

All data returned is only available for temporary use; permanent storage requires contacting Mapbox sales, Attribution text must be displayed: '© 2023 Mapbox and its suppliers. All rights reserved. Use of this data is subject to the Mapbox Terms of Service.', License is non-transferable and non-sublicensable, Cannot create multiple accounts to circumvent free usage limits, ETA calculations incur additional Matrix API charges, Reusing session_token across concurrent sessions may result in unpredictable billing, No pagination support for results [21]docs.mapbox.com/api/search/search-box/“all data returned by the Search Box API endpoints is only available for temporary use. If your use case requires storing position data, contact Mapbox sales.”

• Docs
• API reference
• llms.txt

Docs rendering: static · llms.txt present

API style

rest

Base URL

https://api.mapbox.com/search/searchbox/v1

Version

v1

Versioning

url

Stability

ga

Auth methods

api_key

Idempotency keys

✗ No

Error format

vendor-specific

Rate limit

10 / second

SDKs

• JavaScript (Web) @mapbox/search-js-web · repo
• JavaScript (React) @mapbox/search-js-react · repo
• JavaScript (Core/Node) @mapbox/search-js-core · repo
• Swift/iOS MapboxSearch · repo
• Kotlin/Android MapboxSearch · repo

• Auth docs
• Quickstart
• MCP server
• Deprecation policy

Launched

2023-01-01

GA

2024-03-05

Notable customers

Toyota, General Motors, ANWB, Tripadvisor, Picnic, Straightaway, Curb, Parkbee

• Azure Maps Search (POI)

  "Azure Maps is a collection of geospatial services and SDKs that use fresh mapping data to provide geographic context to web and mobile applications."

  Usage · free tier · public pricing · self-serve

• Google Places API

  "The Places API is a service that accepts HTTP requests for location data through a variety of methods. It returns formatted location data and imagery about establishments, geographic locations, or prominent points of interest."

  Usage · free tier · public pricing · self-serve

• TomTom Search / Places API

  "Search is a RESTful API designed for developers allowing single-line fuzzy search for addresses and POIs. Search assigns a latitude/longitude to a specific address, cross street, geographic feature, or point of interest (POI)."

  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

• HERE Geocoding & Search API (Discover & Browse)

  "Enable precise conversion and discovery of geocoordinates, POIs and addresses to improve location accuracy and context."

  Hybrid · free tier · self-serve

• Esri ArcGIS Places API

  "a location service hosted by Esri that can search for businesses and geographic locations around the world and return detailed information about each place."

  Usage · free tier · public pricing · self-serve

Mapbox Search Box API alternatives · Mapbox Search Box API vs Azure Maps Search (POI) · All Places & POI APIs APIs

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

1. ↑Description: mapbox.com
2. ↑Pricing model: mapbox.com
3. ↑Published pricing: mapbox.com
4. ↑Free tier: mapbox.com · mapbox.com
5. ↑Free tier details: mapbox.com
6. ↑Self-serve signup: mapbox.com
7. ↑Enterprise plan: mapbox.com
8. ↑Supported actions: docs.mapbox.com
9. ↑Regions: docs.mapbox.com · mapbox.com · mapbox.com
10. ↑Languages: docs.mapbox.com
11. ↑Sandbox: docs.mapbox.com
12. ↑SDK languages: docs.mapbox.com
13. ↑MCP server: docs.mapbox.com · docs.mapbox.com
14. ↑SOC 2: mapbox.com
15. ↑HIPAA: mapbox.com
16. ↑GDPR: mapbox.com · mapbox.com
17. ↑ISO 27001: mapbox.com
18. ↑PCI DSS: mapbox.com
19. ↑Published SLA: mapbox.com
20. ↑Rate limits: docs.mapbox.com
21. ↑Known restrictions: 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: {} → {"nearby":true,"poi_search":true,"autocomplete":true,"place_details":true}
8. 2026-06-14 Summary Md: (none) → Mapbox Search Box API is a REST-based location search service covering addresse…
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 10 requests per second (default); sessions expire after 50 successive /suggest …
33. 2026-06-14 Rate Limit Requests: set to 10
34. 2026-06-14 Rate Limit Window: set to second
35. 2026-06-14 Known Restrictions: set to All data returned is only available for temporary use; permanent storage requir…
36. 2026-06-14 Auth Methods: set to api_key
37. 2026-06-14 Auth Docs URL: set to https://docs.mapbox.com/accounts/guides/tokens/
38. 2026-06-14 API Style: set to rest
39. 2026-06-14 Base URL: set to https://api.mapbox.com/search/searchbox/v1
40. 2026-06-14 API Version: set to v1
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/playground/search-box/
46. 2026-06-14 Idempotency Supported: set to No
47. 2026-06-14 Error Format: set to vendor-specific
48. 2026-06-14 Requires Verification: set to Yes
49. 2026-06-14 Starting Price Usd: set to 11.5
50. 2026-06-14 Price Basis: set to 1,000 sessions

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-search \
  -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-search/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 →