Yelp Places API vs Mapbox Search Box API for AI agents
Yelp Places API is Yelp's licensed API (formerly Yelp Fusion) for searching businesses and reading Yelp business details, ratings, photos and review excerpts. Mapbox Search Box API is Mapbox's search API for addresses, places and POIs, with interactive (/suggest + /retrieve), text (/forward), category and reverse endpoints.
The short answer
- Yelp Places API: Yelp ratings, review excerpts and photos for restaurants and local services in consumer apps that display Yelp content. The terms rule out passing that content to an LLM.
- Mapbox Search Box API: Cheap autocomplete-style place and address search inside map apps, with a first-party hosted MCP server.
Side by side
| Yelp Places API | Mapbox Search Box API | |
|---|---|---|
| Searches | Local businesses listed on Yelp. Yelp says it covers "millions of businesses around the world," and the supported-locales page lists 32 countries. | Addresses, places and points of interest, including category search such as "coffee shops around me". |
| Returns | JSON over REST at https://api.yelp.com/v3. Results include name, address, phone, Yelp rating, price level, review count, coordinates, categories, image and Yelp URL. Photos and review excerpts depend on the plan. | JSON features with name, address, coordinates, POI categories, mapbox_id and optional metadata such as phone, website, open hours, rating and photos. Each response includes an attribution string. |
| Before the first call | A Yelp developer account (a business email is required for the trial) and a private API key. Paid plans need a credit card on file. | A Mapbox account and access token. You can sign up without a credit card, but you get trial usage limits until you add a payment method. |
| Free | A 30-day trial with up to 5,000 API calls, for evaluation only, not commercial use. There is no permanent free tier. | Introductory preview pricing: 500 interactive sessions a month and 50,000 /category or /reverse requests a month. The page also shows a "Standard pricing" table (2,500 and 25,000 free), and which table applies when was not stated in the text read. |
| Paid | Base costs $229 a month plus $5.91 per extra 1,000 calls. Enhanced costs $299 a month plus $6.57 per 1,000. Premium costs $643 a month plus $14.13 per 1,000. The FAQ says paid plans include 30,000 calls a month by default. | Sessions: $3.00 per 1,000 under the introductory preview pricing, or $11.50 per 1,000 under the standard pricing. /category and /reverse: $1.00 per 1,000 (intro) or $1.70 (standard). |
| Acting on a result | Results include the business phone number and its Yelp page URL. There is no way to message a business through the Places API. | Retrieved POIs can include phone and website in metadata. There is no way to message a business through the API. |
| Limits on keeping or showing results | No caching or storing of Yelp Content for more than 24 hours. No building your own business-listing database from it. Display Requirements apply, and Yelp can require removal of content within 24 hours. | All Search Box results are for temporary use only. Storing position data requires contacting Mapbox sales. |
| AI in its terms | Very restrictive. Section 9 bans training or fine-tuning generative AI models on Yelp Content. Section 9.4 bans submitting or ingesting any Yelp Content into any Generative AI Model, for example in prompts to ChatGPT. Yelp sells a separate Yelp AI API for conversational use at $25 per 1,000 calls. | Not stated on its pages |
| Coverage | 32 countries in Yelp's supported-locales list, including the US. | Global. The docs have a supported-geographies section that was not reviewed in detail. |
| MCP server | Yelp/yelp-mcp on GitHub (https://github.com/Yelp/yelp-mcp). It wraps the Yelp Fusion AI API with one yelp_agent tool and needs a Yelp Fusion AI key, not a Places API key. | Mapbox MCP Server, hosted at https://mcp.mapbox.com/mcp (OAuth) and open source at https://github.com/mapbox/mcp-server. The search tools use the Search Box API. |
Where Openpath fits
If the agent needs a local business to message in Austin, Texas, Openpath returns the listings themselves, free and with no key. See Openpath vs Yelp Places API and Openpath vs Mapbox Search Box API.
Questions people ask
What do I need before I can use Yelp Places API?
A Yelp developer account (a business email is required for the trial) and a private API key. Paid plans need a credit card on file.
Is Yelp Places API free?
A 30-day trial with up to 5,000 API calls, for evaluation only, not commercial use. There is no permanent free tier.
What do I need before I can use Mapbox Search Box API?
A Mapbox account and access token. You can sign up without a credit card, but you get trial usage limits until you add a payment method.
Is Mapbox Search Box API free?
Introductory preview pricing: 500 interactive sessions a month and 50,000 /category or /reverse requests a month. The page also shows a "Standard pricing" table (2,500 and 25,000 free), and which table applies when was not stated in the text read.
Sources
Every line about another company comes from its own pages. Prices and terms change, so check the source before you rely on one.
Yelp Places API, read on October 15, 2026:
- business.yelp.com/data/resources/pricing: “$229 per month plus $5.91 per additional 1,000 API calls”
- business.yelp.com/data/resources/pricing: “$299 per month plus $6.57 per additional 1,000 API calls”
- business.yelp.com/data/resources/pricing: “$643 per month plus $14.13 per additional 1,000 API calls”
- business.yelp.com/data/resources/pricing: “Receive 5,000 free API calls during the 30-day trial period”
- business.yelp.com/data/resources/pricing: “Start 30-day free trial Business email required”
- business.yelp.com/data/resources/pricing: “$25 / 1,000 API calls Minimum 1,000 daily API calls”
- docs.developer.yelp.com/docs/places-faq: “These API calls are STRICTLY FOR EVALUATION AND NOT FOR COMMERCIAL DEPLOYMENT”
- docs.developer.yelp.com/docs/places-faq: “This plan includes 30,000 API calls per month by default”
- docs.developer.yelp.com/docs/places-intro: “valuable information such as name, address, phone number, Yelp rating, price levels, and review counts”
- docs.developer.yelp.com/docs/places-intro: “The Yelp Places API uses private key authentication to authenticate all endpoints.”
- docs.developer.yelp.com/docs/places-intro: “millions of businesses around the world”
- terms.yelp.com/developers/api_terms: “opt into a paid subscription program by providing credit card and other necessary information”
- terms.yelp.com/developers/api_terms: “cache, record, pre-fetch, or otherwise store any portion of the Yelp Content for a period longer than twenty-four (24) hours”
- terms.yelp.com/developers/api_terms: “use it to update or create your own database of business listing information”
- terms.yelp.com/developers/api_terms: “Submit or ingest any Yelp Content into any Generative AI Model (e.g., prompts that contain any Yelp Content into ChatGPT”
- terms.yelp.com/developers/api_terms: “for the purpose of training, developing, enhancing, or fine-tuning any Generative AI Models without Yelp’s prior written approval”
- github.com/Yelp/yelp-mcp: “MCP server for exposing tools powered by Yelp's data”
- docs.developer.yelp.com/docs/resources-supported-locales: “Following are the locales Yelp Places API supports.”
Mapbox Search Box API, read on October 15, 2026:
- mapbox.com/pricing: “Introductory preview pricing* Monthly sessions Up to 500 501 - 100,000 ... Cost per 1,000 Free $3.00”
- mapbox.com/pricing: “Standard pricing Monthly requests Up to 2,500 2,501 - 100,000 ... Cost per 1,000 Free $11.50”
- mapbox.com/pricing: “Request to /category and /reverse endpoints are billed on a per-request basis.”
- mapbox.com/pricing: “Monthly requests Up to 50,000 50,001 - 500,000 ... Cost per 1,000 Free $1.00”
- mapbox.com/pricing: “A session includes 50 /suggest calls, and 1 /retrieve call, and it will automatically expire after 2 minutes of inactivity.”
- docs.mapbox.com/accounts/guides/signup: “Quick sign-up without a credit card gives you access to Mapbox services with trial usage limits.”
- docs.mapbox.com/api/search/search-box: “all data returned by the Search Box API endpoints is only available for temporary use”
- docs.mapbox.com/api/search/search-box: “"metadata" : { "phone" : "PHONE_NUMBER" , "website" : "WEBSITE_URL" , "open_hours"”
- docs.mapbox.com/api/guides/mcp-server: “This endpoint is available at https://mcp.mapbox.com/mcp”