{ "name": "Mapbox Search Box API", "slug": "mapbox-search", "website_url": "https://docs.mapbox.com/api/search/search-box/", "vendor_description": "\"All-in-one location search for addresses, places, and points of interest\"", "categories": [ "places" ], "summary": "Mapbox Search Box API is a REST-based location search service covering addresses, places, and points of interest across 80+ countries, with a dataset of 330 million POIs and 375 million addresses globally. It is priced per session at $11.50 per 1,000 sessions, with a free tier of 500 sessions per month and self-serve signup, making it accessible for small projects and scalable to enterprise. SDKs are available for JavaScript, React, iOS, and Android, and an MCP server is also available. The service is SOC 2 Type 2 certified and GDPR compliant, with a published SLA.", "capabilities": { "supported_actions": [ "suggest", "retrieve", "forward", "category", "reverse", "list_category" ], "supported_regions": [ "United States", "Canada", "Europe", "80+ countries globally (53 new countries added 2025)", "330 million POIs globally", "375 million addresses globally" ], "supported_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" ], "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_supported": false, "sandbox_available": false, "sdk_languages": [ "JavaScript (Web)", "JavaScript (React)", "JavaScript (Core/Node)", "Swift/iOS", "Kotlin/Android" ], "mcp_server_available": true }, "integration": { "api_style": "rest", "base_url": "https://api.mapbox.com/search/searchbox/v1", "api_version": "v1", "versioning_scheme": "url", "stability": "ga", "deprecation_policy_url": "https://docs.mapbox.com/api/guides/", "auth_methods": [ "api_key" ], "auth_docs_url": "https://docs.mapbox.com/accounts/guides/tokens/", "idempotency_supported": false, "error_format": "vendor-specific", "webhook_signing": null, "webhook_events_url": null, "rate_limit_requests": 10, "rate_limit_window": "second", "sdk_packages": [ { "package": "@mapbox/search-js-web", "language": "JavaScript (Web)", "official": true, "repo_url": "https://github.com/mapbox/search-js" }, { "package": "@mapbox/search-js-react", "language": "JavaScript (React)", "official": true, "repo_url": "https://github.com/mapbox/search-js" }, { "package": "@mapbox/search-js-core", "language": "JavaScript (Core/Node)", "official": true, "repo_url": "https://github.com/mapbox/search-js" }, { "package": "MapboxSearch", "language": "Swift/iOS", "official": true, "repo_url": "https://github.com/mapbox/mapbox-search-ios" }, { "package": "MapboxSearch", "language": "Kotlin/Android", "official": true, "repo_url": "https://github.com/mapbox/mapbox-search-android" } ], "mcp_url": "https://mcp.mapbox.com/mcp", "quickstart_url": "https://docs.mapbox.com/playground/search-box/" }, "pricing": { "pricing_model": "usage_based", "has_published_pricing": true, "starting_price_usd": "11.5000", "price_basis": "1,000 sessions", "free_tier_available": true, "free_tier_limit": "500 sessions/month", "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.", "minimum_commitment": null, "self_serve_signup": true, "requires_sales_call": false, "requires_verification": true, "enterprise_plan_available": true, "price_points": [ { "plan": "Standard", "item": "Search Box API session (free tier)", "amount_usd": "0.0000", "amount_percent": null, "per": "first 500 sessions/month", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API session", "amount_usd": "11.5000", "amount_percent": null, "per": "1,000 sessions (501–100,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API session", "amount_usd": "10.0000", "amount_percent": null, "per": "1,000 sessions (100,001–200,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API session", "amount_usd": "8.4000", "amount_percent": null, "per": "1,000 sessions (200,001–500,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API session", "amount_usd": "6.6000", "amount_percent": null, "per": "1,000 sessions (500,001–1,000,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API request — /category, /reverse (free tier)", "amount_usd": "0.0000", "amount_percent": null, "per": "first 25,000 requests/month", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API request — /category, /reverse", "amount_usd": "1.7000", "amount_percent": null, "per": "1,000 requests (25,001–100,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API request — /category, /reverse", "amount_usd": "1.5000", "amount_percent": null, "per": "1,000 requests (100,001–500,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" }, { "plan": "Standard", "item": "Search Box API request — /category, /reverse", "amount_usd": "1.2500", "amount_percent": null, "per": "1,000 requests (500,001–1,000,000/month)", "currency": "USD", "source_url": "https://www.mapbox.com/pricing" } ] }, "compliance": { "soc2": "type_2", "hipaa": false, "gdpr": true, "iso_27001": false, "pci_dss": false, "sla_published": true, "sla_url": "https://www.mapbox.com/legal/sla", "data_retention_policy_url": "https://www.mapbox.com/legal/privacy", "documented_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)", "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" ] }, "developer": { "docs_url": "https://docs.mapbox.com/api/", "api_reference_url": "https://docs.mapbox.com/api/", "openapi_spec_url": null, "postman_collection_url": null, "changelog_url": null, "status_page_url": null, "llms_txt_url": "https://docs.mapbox.com/llms.txt", "markdown_docs_url": null, "rendering": "static" }, "adoption": { "launched_at": "2023-01-01", "ga_date": "2024-03-05", "github_stars": null, "github_stars_at": null, "notable_customers": [ "Toyota", "General Motors", "ANWB", "Tripadvisor", "Picnic", "Straightaway", "Curb", "Parkbee" ] }, "scores": { "agent_friendliness": 55, "pricing_transparency": 100, "setup_speed": 85, "docs_quality": 45, "procurement_friction": 100, "trust_readiness": 60, "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)" ], "avoid_if": [] }, "sources": [ { "field": "supported_regions", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "Supported regions: United States, Canada, and Europe", "confidence": "high" }, { "field": "supported_regions", "url": "https://www.mapbox.com/search-box", "excerpt": "375M+ addresses globally; 170M+ points of interest (POIs) worldwide", "confidence": "high" }, { "field": "vendor_description", "url": "https://www.mapbox.com/search-box", "excerpt": "All-in-one location search for addresses, places, and points of interest", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "/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", "confidence": "high" }, { "field": "supported_regions", "url": "https://www.mapbox.com/blog/mapbox-search-box-api-expanded-poi-coverage-smarter-search", "excerpt": "53 new countries added in 2025; 375 million addresses; 330 million points of interest (POIs)", "confidence": "high" }, { "field": "supported_languages", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "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", "confidence": "high" }, { "field": "free_tier_available", "url": "https://www.mapbox.com/pricing", "excerpt": "Free Tier: Up to 500 sessions/month at no cost; Free Tier: Up to 25,000 requests/month", "confidence": "high" }, { "field": "free_tier_details", "url": "https://www.mapbox.com/pricing#search", "excerpt": "Session-Based Pricing — Free Tier: Up to 500 sessions/month at no cost; Request-Based Pricing — Free Tier: Up to 25,000 requests/month", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://docs.mapbox.com/api/guides/mcp-server/", "excerpt": "Uses the Search Box API to search for and geocode POIs, addresses, and places.", "confidence": "high" }, { "field": "soc2", "url": "https://www.mapbox.com/security", "excerpt": "SOC 2 Type II: Security, Availability, and Confidentiality Report; SOC 3: General Control Report. We are SOC 2 Type 2 and SOC 3 compliant.", "confidence": "high" }, { "field": "hipaa", "url": "https://www.mapbox.com/security", "excerpt": "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.", "confidence": "high" }, { "field": "gdpr", "url": "https://www.mapbox.com/privacy", "excerpt": "This privacy policy applies to the extent Mapbox processes personal data in its capacity as a data controller under the GDPR.", "confidence": "high" }, { "field": "sla_published", "url": "https://www.mapbox.com/sla", "excerpt": "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", "confidence": "high" }, { "field": "sdk_languages", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "Mapbox Search JS - Web, React, Node.js; Mapbox Search SDK for Android; Mapbox Search SDK for iOS", "confidence": "high" }, { "field": "known_restrictions", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "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.", "confidence": "high" }, { "field": "self_serve_signup", "url": "https://www.mapbox.com/pricing", "excerpt": "Self-serve signup available; Automatically get volume pricing as your usage grows", "confidence": "high" }, { "field": "api_version", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "Base URL: https://api.mapbox.com/search/searchbox/v1/ — Current Version: v1", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "A valid Mapbox access token.", "confidence": "high" }, { "field": "auth_docs_url", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "access tokens and token scopes guidance: https://docs.mapbox.com/accounts/guides/tokens/", "confidence": "high" }, { "field": "rate_limit_window", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "The default rate limit for the Mapbox Search Box API is 10 requests per second.", "confidence": "high" }, { "field": "stability", "url": "https://www.mapbox.com/blog/unlock-faster-smarter-search-with-mapbox-search-box-api", "excerpt": "The Mapbox Search Box API — general availability — March 5, 2024. The Search Box API is generally available to all Mapbox users.", "confidence": "high" }, { "field": "launched_at", "url": "https://www.mapbox.com/blog/mapbox-search-box-api-expanded-poi-coverage-smarter-search", "excerpt": "Since its general availability last year [written October 2025], it had a Public Preview release the year prior (approximately 2023)", "confidence": "medium" }, { "field": "starting_price_usd", "url": "https://www.mapbox.com/pricing#search", "excerpt": "Standard Pricing (Effective Q4 2025): 2,501 - 100,000 sessions: $11.50 per 1,000", "confidence": "high" }, { "field": "notable_customers", "url": "https://www.mapbox.com/blog/unlock-faster-smarter-search-with-mapbox-search-box-api", "excerpt": "Toyota, General Motors, ANWB, Straightaway, Curb, Parkbee", "confidence": "high" }, { "field": "sla_url", "url": "https://www.mapbox.com/legal/sla", "excerpt": "The SLA guarantees 99.9% of the time every month for API availability.", "confidence": "high" }, { "field": "mcp_url", "url": "https://docs.mapbox.com/api/guides/mcp-server/", "excerpt": "Hosted MCP Server URL: https://mcp.mapbox.com/mcp — NPM Package: @mapbox/mcp-server — GitHub Repository: https://github.com/mapbox/mcp-server", "confidence": "high" }, { "field": "sdk_packages", "url": "https://github.com/mapbox/mapbox-search-ios", "excerpt": "GitHub - mapbox/mapbox-search-ios: Search SDK for iOS with preconfigured UI in Swift", "confidence": "high" }, { "field": "requires_verification", "url": "https://docs.mapbox.com/accounts/faq/how-do-i-pay-for-mapbox-services/", "excerpt": "A valid card must be added to each Mapbox account to prevent account deactivation and to keep payments prompt.", "confidence": "medium" }, { "field": "idempotency_supported", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "No traditional idempotency headers or keys are mentioned in the documentation. The session_token parameter groups /suggest and /retrieve calls for billing purposes only.", "confidence": "high" }, { "field": "pricing_model", "url": "https://www.mapbox.com/pricing", "excerpt": "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.", "confidence": "high" }, { "field": "free_tier_available", "url": "https://www.mapbox.com/pricing#search", "excerpt": "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.", "confidence": "high" }, { "field": "has_published_pricing", "url": "https://www.mapbox.com/pricing", "excerpt": "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", "confidence": "high" }, { "field": "mcp_server_available", "url": "https://docs.mapbox.com/api/guides/mcp-server/", "excerpt": "Hosted MCP Server URL: https://mcp.mapbox.com/mcp", "confidence": "high" }, { "field": "iso_27001", "url": "https://www.mapbox.com/security", "excerpt": "Certifications listed: SOC 2 Type II, SOC 3, ISO 9001 (Global Quality Standard), TISAX (Automotive Industry Standard). ISO 27001 is not mentioned.", "confidence": "high" }, { "field": "pci_dss", "url": "https://www.mapbox.com/security", "excerpt": "Payment Card Industry Standard-certified refers to Stripe (their payment processor), not Mapbox itself as an API provider.", "confidence": "high" }, { "field": "gdpr", "url": "https://www.mapbox.com/privacy", "excerpt": "customers/prospective customers should read Mapbox's data processing addendum (\"DPA\"): https://www.mapbox.com/legal/dpa which governs certain customer personal data.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "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.", "confidence": "high" }, { "field": "sandbox_available", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "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.", "confidence": "high" }, { "field": "enterprise_plan_available", "url": "https://www.mapbox.com/pricing#search", "excerpt": "higher volume users should contact sales for discount", "confidence": "high" }, { "field": "base_url", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "https://api.mapbox.com/search/searchbox/v1/suggest?q={search_text}&access_token=YOUR_MAPBOX_ACCESS_TOKEN", "confidence": "high" }, { "field": "versioning_scheme", "url": "https://docs.mapbox.com/api/guides/", "excerpt": "Removing properties from JSON objects [or] Changing an API's URL structure [results in the] version string [being] incremented", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.mapbox.com/accounts/guides/tokens/", "excerpt": "Each access token you create will have a set of permissions that allow you or your applications to make certain types of requests to Mapbox APIs", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "The default rate limit for the Mapbox Search Box API is 10 requests per second.", "confidence": "high" }, { "field": "error_format", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "401 \"Not authorized\" — indicates an invalid access token; 400 \"Bad request\" — suggests syntax errors; 403 \"Forbidden\" — may indicate account issues", "confidence": "high" }, { "field": "ga_date", "url": "https://www.mapbox.com/blog/unlock-faster-smarter-search-with-mapbox-search-box-api", "excerpt": "General Availability Date: March 5, 2024", "confidence": "high" }, { "field": "free_tier_limit", "url": "https://www.mapbox.com/pricing#search", "excerpt": "Up to 500 monthly sessions are offered at no cost.", "confidence": "high" }, { "field": "price_basis", "url": "https://www.mapbox.com/pricing#search", "excerpt": "A search session is a series of /suggest and /retrieve API calls that are bundled together for billing purposes.", "confidence": "high" }, { "field": "notable_customers", "url": "https://www.mapbox.com/blog/mapbox-search-box-api-expanded-poi-coverage-smarter-search", "excerpt": "Tripadvisor — Jeremy Frisch, Product Lead for Places & Maps; Picnic — Arjan Braemer, Distribution Analyst Team Lead", "confidence": "high" }, { "field": "deprecation_policy_url", "url": "https://docs.mapbox.com/api/guides/", "excerpt": "If we deprecate an API or API endpoint that you are using, we will email you to give you at least 90 days' notice.", "confidence": "medium" }, { "field": "sdk_packages", "url": "https://www.npmjs.com/package/@mapbox/search-js-web", "excerpt": "@mapbox/search-js-web — official Mapbox package", "confidence": "high" }, { "field": "sdk_packages", "url": "https://github.com/mapbox/mapbox-search-android", "excerpt": "GitHub - mapbox/mapbox-search-android: Android SDK for Mapbox Search including preconfigured UI", "confidence": "high" }, { "field": "data_retention_policy_url", "url": "https://www.mapbox.com/legal/privacy", "excerpt": "Mapbox retains personal data for so long as it is needed to fulfill the purposes for which it was collected. IP Addresses: deleted after 30 days.", "confidence": "medium" }, { "field": "quickstart_url", "url": "https://docs.mapbox.com/api/search/search-box/", "excerpt": "Search Box API Developer Playground — Try Search API queries and see the results on a map: https://docs.mapbox.com/playground/search-box/", "confidence": "medium" } ], "fields_not_found": [ "exact total country count (stated 80+ but not a precise official count)", "ISO 27001 certification (not mentioned on security page; certifications are SOC 2 Type II, SOC 3, ISO 9001, TISAX)", "HIPAA compliance (not mentioned on security page)", "PCI DSS for Mapbox itself (only their payment processor Stripe holds PCI DSS Level 1)", "webhooks documentation", "dedicated sandbox/test environment separate from production", "oauth2", "hmac_signature", "webhook_events", "webhook_signing", "idempotency_keys", "dedicated_data_retention_policy_url" ], "source_confidence": "high", "last_verified_at": "2026-06-14T00:00:00.000Z", "contribute": { "note": "This data is crowd-editable. Suggest corrections or leave a review via these endpoints - no auth required, requests are rate-limited, and every submission is reviewed before it goes live. For a field edit, {field} is any key in this response and a citation is required.", "endpoints": [ { "action": "review", "label": "Leave a review or comment", "method": "POST", "url": "https://apio.sh/api/feedback/mapbox-search", "example_body": { "kind": "review", "rating": 5, "body": "Your experience with this API…" } }, { "action": "field_edit", "label": "Suggest a correction to a field (cite a source)", "method": "POST", "url": "https://apio.sh/api/suggest/mapbox-search/{field}", "example_body": { "value": "corrected value", "citations": [ { "url": "https://source.example/page", "excerpt": "supporting quote" } ], "note": "what changed and why" } }, { "action": "new_api", "label": "Suggest a new API to add", "method": "POST", "url": "https://apio.sh/api/suggest/api", "example_body": { "value": { "name": "Acme API", "website_url": "https://acme.example" }, "citations": [ { "url": "https://acme.example" } ] } }, { "action": "token", "label": "Optional - raise your rate limit", "method": "GET", "url": "https://apio.sh/api/feedback/token" } ] } }