{ "name": "Yelp Fusion API", "slug": "yelp-fusion", "website_url": "https://business.yelp.com/data/products/fusion/", "vendor_description": "\"The Yelp Places API allows you to get the best local content and user reviews from millions of businesses around the world.\"", "categories": [ "places" ], "summary": "Yelp Fusion is a REST API giving developers access to Yelp's local business data across 30+ countries, covering search, place details, user reviews, autocomplete, events, and business insights including risk signals and food-and-drinks analytics. Paid plans start at $229 per month with 30,000 calls included, a 5,000-call daily cap, and overage billing per 1,000 calls; a 30-day trial provides 5,000 free calls for evaluation. Notable integrations include Apple Maps, SoundHound, and SoftBank's Pepper robot. Use requires prominently displaying the Yelp logo and official star ratings, linking back to Yelp business pages, and not caching data beyond 24 hours.", "capabilities": { "supported_actions": [ "business_search", "phone_search", "business_match", "business_details", "transaction_search", "engagement_metrics", "service_offerings", "business_insights", "food_and_drinks_insights", "risk_signal_insights", "reviews", "review_highlights", "event_search", "event_lookup", "featured_events", "categories", "category_details", "autocomplete", "get_jobs", "get_survey", "request_a_quote" ], "supported_regions": [ "United States", "Canada", "United Kingdom", "Australia", "France", "Germany", "Austria", "Switzerland", "Spain", "Italy", "Netherlands", "Belgium", "Portugal", "Poland", "Czech Republic", "Denmark", "Finland", "Norway", "Sweden", "Turkey", "Mexico", "Argentina", "Brazil", "Chile", "Hong Kong", "Japan", "Malaysia", "New Zealand", "Philippines", "Singapore", "Taiwan" ], "supported_languages": [ "cs", "da", "de", "en", "es", "fi", "fil", "fr", "it", "ja", "ms", "nb", "nl", "pl", "pt", "sv", "tr", "zh" ], "input_types": [ "text query", "lat/lon coordinates", "location string", "category", "phone number", "business name", "radius", "price filter", "open_now flag", "attributes" ], "output_types": [ "JSON" ], "webhooks_supported": false, "sandbox_available": false, "sdk_languages": [ "Python", "Multiple (code samples)", "Swift/iOS" ], "mcp_server_available": true }, "integration": { "api_style": "rest", "base_url": "https://api.yelp.com/v3", "api_version": "v3", "versioning_scheme": "url", "stability": "ga", "deprecation_policy_url": null, "auth_methods": [ "api_key" ], "auth_docs_url": "https://docs.developer.yelp.com/docs/places-authentication", "idempotency_supported": false, "error_format": "vendor-specific", "webhook_signing": null, "webhook_events_url": "https://docs.developer.yelp.com/docs/webhooks", "rate_limit_requests": 500, "rate_limit_window": "day", "sdk_packages": [ { "package": "mcp-yelp-agent", "language": "Python", "official": true, "repo_url": "https://github.com/Yelp/yelp-mcp" }, { "package": null, "language": "Multiple (code samples)", "official": true, "repo_url": "https://github.com/Yelp/yelp-fusion" }, { "package": null, "language": "Swift/iOS", "official": true, "repo_url": "https://github.com/Yelp/yelp-ios" } ], "mcp_url": "https://github.com/Yelp/yelp-mcp", "quickstart_url": "https://docs.developer.yelp.com/docs/places-intro" }, "pricing": { "pricing_model": "hybrid", "has_published_pricing": true, "starting_price_usd": "229.0000", "price_basis": "month", "free_tier_available": false, "free_tier_limit": "5,000 API calls during 30-day trial", "free_tier_details": null, "minimum_commitment": null, "self_serve_signup": true, "requires_sales_call": false, "requires_verification": true, "enterprise_plan_available": true, "price_points": [ { "plan": "Base", "item": "Monthly subscription", "amount_usd": "229.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Base", "item": "Overage API calls", "amount_usd": "5.9100", "amount_percent": null, "per": "1,000 API calls", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Enhanced", "item": "Monthly subscription", "amount_usd": "299.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Enhanced", "item": "Overage API calls", "amount_usd": "6.5700", "amount_percent": null, "per": "1,000 API calls", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Premium", "item": "Monthly subscription", "amount_usd": "643.0000", "amount_percent": null, "per": "month", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Premium", "item": "Overage API calls", "amount_usd": "14.1300", "amount_percent": null, "per": "1,000 API calls", "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" }, { "plan": "Yelp AI API", "item": "Per-call usage", "amount_usd": "25.0000", "amount_percent": null, "per": "1,000 API calls", "currency": "USD", "source_url": "https://business.yelp.com/data/resources/pricing/" }, { "plan": "Enterprise", "item": "Custom pricing for >150,000 monthly calls", "amount_usd": null, "amount_percent": null, "per": null, "currency": "USD", "source_url": "https://business.yelp.com/data/products/fusion/" } ] }, "compliance": { "soc2": null, "hipaa": null, "gdpr": null, "iso_27001": null, "pci_dss": null, "sla_published": false, "sla_url": null, "data_retention_policy_url": "https://terms.yelp.com/developers/api_terms/20250113_en_us/", "documented_rate_limits": "Default paid plan: 30,000 API calls per month with a daily limit of up to 5,000 calls; overages billed in increments of 1,000 calls. Exceeding the daily limit returns HTTP 429 (Too Many Requests); limits reset at midnight UTC. Trial: up to 5,000 calls during 30-day trial, strictly for evaluation and not commercial deployment. Plans requiring >150,000 monthly calls require contacting sales.", "known_restrictions": [ "Cannot store/cache Yelp data longer than 24 hours (exception: business IDs for backend matching only)", "Must display Yelp logo prominently on all content sourced from Yelp", "Must use official Yelp-branded star ratings only; cannot blend with other rating sources", "Must include 'Read Reviews' links back to corresponding Yelp business pages", "Cannot use Yelp content to train, develop, or fine-tune generative AI models without written approval", "Cannot perform semantic analysis or incorporate rating trends without prior approval", "Cannot build competing Yelp alternatives", "Cannot remove hyperlinks or tracking parameters from Yelp content", "Commercial analytics/metrics on Yelp data require separate Insights API licensing", "Trial plan (5,000 calls/30 days) is strictly for evaluation, not commercial deployment", "Attribution required: Yelp logo must link to yelp.com or the business's Yelp page" ] }, "developer": { "docs_url": null, "api_reference_url": "https://docs.developer.yelp.com/reference/v2_ai_chat", "openapi_spec_url": null, "postman_collection_url": null, "changelog_url": null, "status_page_url": null, "llms_txt_url": null, "markdown_docs_url": null, "rendering": "static" }, "adoption": { "launched_at": "2016-09-20", "ga_date": "2016-09-20", "github_stars": null, "github_stars_at": null, "notable_customers": [ "SoundHound (Hound/Houndify)", "Logitech (ZeroTouch)", "SoftBank (Pepper robot)", "INRIX (OpenCar)", "Local Motors (Olli)", "Apple Maps" ] }, "scores": { "agent_friendliness": 50, "pricing_transparency": 85, "setup_speed": 60, "docs_quality": 20, "procurement_friction": 85, "trust_readiness": 0, "best_for": [ "AI agents and automation - an agent-ready surface (MCP / llms.txt)", "Teams needing broad API coverage out of the box" ], "avoid_if": [ "You want to try it free before paying", "You have strict compliance requirements" ] }, "sources": [ { "field": "launched_at", "url": "https://blog.yelp.com/news/yelp-fusion-developer-program-data-api-access/", "excerpt": "Launch Date: September 20, 2016", "confidence": "high" }, { "field": "vendor_description", "url": "https://docs.developer.yelp.com/docs/fusion-intro", "excerpt": "The Yelp Places API allows you to get the best local content and user reviews from millions of businesses around the world.", "confidence": "high" }, { "field": "supported_actions", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "Businesses: Search, Phone Search, Business Match, Business Details, Food Delivery Search, Engagement Metrics, Service Offerings, Business Insights, Food & Drinks Insights, Risk Signal Insights. Reviews: Reviews and Review Highlights. Events: Event Search, Event Details, Featured Events. Categories: All Categories and Category Details. Home Services: Get Jobs, Get Survey, Request a Quote. Miscellaneous: Autocomplete.", "confidence": "high" }, { "field": "pricing_model", "url": "https://business.yelp.com/data/resources/pricing/", "excerpt": "Premium: $643/month + $14.13 per 1,000 additional calls. Enhanced: $299/month + $6.57 per 1,000 additional calls. Base: $229/month + $5.91 per 1,000 additional calls.", "confidence": "high" }, { "field": "free_tier_available", "url": "https://business.yelp.com/data/products/fusion/", "excerpt": "5,000 free API calls during the 30-day trial period.", "confidence": "high" }, { "field": "enterprise_plan_available", "url": "https://business.yelp.com/data/products/fusion/", "excerpt": "If you need more than 150,000 monthly API calls, get in touch with their sales team for custom pricing.", "confidence": "high" }, { "field": "soc2", "url": "https://trust.yelp.com/", "excerpt": null, "confidence": "high" }, { "field": "gdpr", "url": "https://trust.yelp.com/", "excerpt": null, "confidence": "high" }, { "field": "mcp_server_available", "url": "https://github.com/Yelp/yelp-mcp", "excerpt": "Official Yelp MCP server repository hosted under github.com/Yelp organization. Built in Python. Exposes a yelp_agent tool that processes natural language queries about local businesses.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://business.yelp.com/data/products/fusion/", "excerpt": "If you need more than 150,000 monthly API calls, get in touch.", "confidence": "high" }, { "field": "known_restrictions", "url": "https://terms.yelp.com/developers/display_requirements/", "excerpt": "Make Yelp's logo prominently visible on all content that originated from Yelp. Must use official Yelp-branded stars only; generic stars are prohibited. Cannot blend Yelp ratings with other sources.", "confidence": "high" }, { "field": "self_serve_signup", "url": "https://docs.developer.yelp.com/docs/fusion-authentication", "excerpt": "Create an app on Yelp's Developers site to obtain your private API Key. Complete a form with app information and agree to their API Terms of Use. Receive your API Key upon submission.", "confidence": "high" }, { "field": "api_style", "url": "https://docs.developer.yelp.com/docs/fusion-intro", "excerpt": "The Yelp Places API uses private key authentication to authenticate all endpoints. Your private API Key will be automatically generated after you create your app.", "confidence": "high" }, { "field": "base_url", "url": "https://docs.developer.yelp.com/docs/places-authentication", "excerpt": "All endpoints operate under https://api.yelp.com/v3.", "confidence": "high" }, { "field": "api_version", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "API Version: v3 (with v2 alternatives available for OAuth)", "confidence": "high" }, { "field": "versioning_scheme", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "Versioning Scheme: URL path-based versioning (e.g., /v3/, /v2/)", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.developer.yelp.com/docs/fusion-authentication", "excerpt": "set the Authorization HTTP header value as Bearer API_KEY", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.developer.yelp.com/changelog/fusion-daily-rate-limits-changed", "excerpt": "Fusion API: Old limit: 5,000 daily requests. New limit: 500 daily requests. Effective Date: May 16, 2023. If your client was created before May 16th 2023 the old limits still apply.", "confidence": "medium" }, { "field": "rate_limit_window", "url": "https://docs.developer.yelp.com/docs/places-rate-limiting", "excerpt": "Limits reset at midnight UTC daily, with exact reset times provided via the RateLimit-ResetTime header in ISO 8601 format.", "confidence": "high" }, { "field": "price_basis", "url": "https://business.yelp.com/data/products/places-api/", "excerpt": "Base Plan: $229 per month plus $5.91 per additional 1,000 API calls. Enhanced Plan: $299 per month plus $6.57 per additional 1,000 API calls. Premium Plan: $643 per month plus $14.13 per additional 1,000 API calls.", "confidence": "high" }, { "field": "website_url", "url": "https://business.yelp.com/data/products/fusion/", "excerpt": "Fusion API | Yelp Data Licensing — primary marketing and pricing page for the Yelp Places API product.", "confidence": "high" }, { "field": "pricing_model", "url": "https://business.yelp.com/data/products/fusion/", "excerpt": "Base: $229 per month plus $5.91 per additional 1,000 API calls. Enhanced: $299 per month plus $6.57 per additional 1,000 API calls. Premium: $643 per month plus $14.13 per additional 1,000 API calls.", "confidence": "high" }, { "field": "has_published_pricing", "url": "https://business.yelp.com/data/resources/pricing/", "excerpt": "Base: $229/month + $5.91 per 1,000 additional calls. Enhanced: $299/month + $6.57 per 1,000 additional calls. Premium: $643/month + $14.13 per 1,000 additional calls.", "confidence": "high" }, { "field": "free_tier_available", "url": "https://docs.developer.yelp.com/docs/places-faq", "excerpt": "up to 5,000 free API calls during your 30-day trial... STRICTLY FOR EVALUATION AND NOT FOR COMMERCIAL DEPLOYMENT.", "confidence": "high" }, { "field": "sla_published", "url": "https://terms.yelp.com/developers/api_terms/20250113_en_us/", "excerpt": "THE API, YELP BRAND FEATURES AND YELP CONTENT ARE PROVIDED 'AS IS', 'WITH ALL FAULTS' AND 'AS AVAILABLE' WITHOUT WARRANTY... THE API AGREEMENT DOES NOT ENTITLE YOU TO ANY SUPPORT FOR THE API.", "confidence": "high" }, { "field": "hipaa", "url": "https://trust.yelp.com/", "excerpt": null, "confidence": "high" }, { "field": "webhooks_supported", "url": "https://docs.developer.yelp.com/docs/business-subscriptions-api", "excerpt": "The Business Subscriptions API is a distinct service that manages subscriptions across multiple types, including webhooks. This is a Yelp Partner API with restricted access; requires separate enablement — you must contact Yelp to enable your client for webhook subscriptions specifically.", "confidence": "high" }, { "field": "documented_rate_limits", "url": "https://docs.developer.yelp.com/docs/places-faq", "excerpt": "Default allocation is 30,000 API calls per month with a daily limit of up to 5,000 calls. Overage usage is billed in increments of 1,000 calls. When daily limits are exceeded, additional requests on the same day will return a 429 (Too Many Requests) error. Limits reset at midnight UTC every day.", "confidence": "high" }, { "field": "known_restrictions", "url": "https://terms.yelp.com/developers/api_terms/20250113_en_us/", "excerpt": "cache, record, pre-fetch, or otherwise store any portion of the Yelp Content for a period longer than twenty-four (24) hours from receipt", "confidence": "high" }, { "field": "known_restrictions", "url": "https://terms.yelp.com/developers/api_terms/20250113_en_us/", "excerpt": "use, copy, process, modify, reverse engineer, or create derivative works based on the Yelp Content for the purpose of training, developing, enhancing, or fine-tuning any Generative AI Models", "confidence": "high" }, { "field": "sandbox_available", "url": "https://docs.developer.yelp.com/docs/fusion-intro", "excerpt": null, "confidence": "high" }, { "field": "api_style", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "Base URL: https://api.yelp.com/v3/businesses/search", "confidence": "high" }, { "field": "base_url", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "Base URL: https://api.yelp.com/v3/businesses/search", "confidence": "high" }, { "field": "api_version", "url": "https://docs.developer.yelp.com/docs/places-intro", "excerpt": "All endpoints operate under https://api.yelp.com/v3", "confidence": "high" }, { "field": "auth_methods", "url": "https://docs.developer.yelp.com/docs/places-authentication", "excerpt": "Yelp Places API uses private API Keys to authenticate requests. The API key must be included in the HTTP Authorization header using Bearer token format: Authorization: Bearer API_KEY", "confidence": "high" }, { "field": "auth_docs_url", "url": "https://docs.developer.yelp.com/docs/places-authentication", "excerpt": "Yelp Places API uses private API Keys to authenticate requests.", "confidence": "high" }, { "field": "rate_limit_requests", "url": "https://docs.developer.yelp.com/docs/places-rate-limiting", "excerpt": "Limits vary by plan selection during signup. Your current allowances appear in response headers: RateLimit-DailyLimit, RateLimit-Remaining, and RateLimit-ResetTime.", "confidence": "medium" }, { "field": "starting_price_usd", "url": "https://business.yelp.com/data/products/places-api/", "excerpt": "Base Plan: $229 per month plus $5.91 per additional 1,000 API calls", "confidence": "high" }, { "field": "free_tier_limit", "url": "https://business.yelp.com/data/products/places-api/", "excerpt": "All three tiers include 5,000 free API calls during the 30-day trial period.", "confidence": "high" }, { "field": "launched_at", "url": "https://www.businesswire.com/news/home/20160920005477/en/Yelp-Launches-A-New-Developer-Program-Yelp-Fusion", "excerpt": "Yelp Launches A New Developer Program: Yelp Fusion (September 20, 2016)", "confidence": "high" }, { "field": "notable_customers", "url": "https://www.phonearena.com/news/apple-maps-request-quote-feature-yelp_id165718", "excerpt": "Apple Maps adds a new Request a Quote feature through Yelp integration", "confidence": "medium" }, { "field": "sdk_packages", "url": "https://github.com/Yelp/yelp-mcp", "excerpt": "Official MCP server at github.com/Yelp/yelp-mcp. This is officially maintained by Yelp as indicated by the GitHub organization and repository ownership. Package: mcp-yelp-agent (installed via uv run).", "confidence": "high" }, { "field": "quickstart_url", "url": "https://docs.developer.yelp.com/docs/places-intro", "excerpt": "Getting Started with the Yelp Places API — autocomplete, business search, transaction search, business details, reviews workflow.", "confidence": "high" }, { "field": "webhook_events_url", "url": "https://docs.developer.yelp.com/docs/webhooks", "excerpt": "Webhook event types include: new review for a given business, Data Ingestion API job updates, license verification, and new leads. Subscriptions use the Business Subscriptions API with subscription type WEBHOOK.", "confidence": "medium" }, { "field": "requires_verification", "url": "https://docs.developer.yelp.com/docs/places-intro", "excerpt": "Commercial use cases require completing a Yelp Places Enterprise application. Free trial signup available through Yelp's business products page.", "confidence": "medium" }, { "field": "stability", "url": "https://docs.developer.yelp.com/changelog", "excerpt": "The changelog shows active maintenance with recent improvements to core endpoints (Leads API, Fusion AI). Fusion API has been in production since September 2016.", "confidence": "high" }, { "field": "notable_customers", "url": "https://blog.yelp.com/news/yelp-fusion-developer-program-data-api-access/", "excerpt": "Notable partners include SoundHound Inc. (Hound and Houndify), Logitech (ZeroTouch), SoftBank (Pepper robot), INRIX (OpenCar), Local Motors (Olli smart shuttle with IBM Watson).", "confidence": "medium" }, { "field": "sdk_packages", "url": "https://github.com/Yelp/yelp-fusion", "excerpt": "The README explicitly distinguishes between Official and Unofficial client libraries. Only the iOS SDK is listed under the Official category. Repository: yelp-ios — The official iOS client library.", "confidence": "high" }, { "field": "mcp_url", "url": "https://github.com/Yelp/yelp-mcp", "excerpt": "Official Yelp MCP server repository at github.com/Yelp/yelp-mcp, vendor-maintained by Yelp.", "confidence": "high" }, { "field": "error_format", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "Standard HTTP status codes with structured error responses: 400 Bad Request, 401 Unauthorized (UNAUTHORIZED_API_KEY, TOKEN_INVALID), 403 Authorization Error, 404 Resource Not Found, 429 Rate limited, 500 Internal Server Error, 503 Service Unavailable.", "confidence": "medium" }, { "field": "data_retention_policy_url", "url": "https://terms.yelp.com/developers/api_terms/20250113_en_us/", "excerpt": "cache, record, pre-fetch, or otherwise store any portion of the Yelp Content for a period longer than twenty-four (24) hours from receipt.", "confidence": "high" }, { "field": "requires_verification", "url": "https://docs.developer.yelp.com/docs/places-authentication", "excerpt": "Create an app on Yelp's Developer site, select an appropriate plan, complete the app form and agree to Terms of Use, receive your API Key.", "confidence": "medium" }, { "field": "idempotency_supported", "url": "https://docs.developer.yelp.com/reference/v3_business_search", "excerpt": "No idempotency support mentioned in the documentation excerpt. The API is primarily read-only (GET requests), so idempotency keys are not applicable.", "confidence": "low" } ], "fields_not_found": [ "soc2", "hipaa", "gdpr", "iso_27001", "pci_dss", "sla_uptime_percentage", "sla_url", "deprecation_policy_url", "webhook_signing", "idempotency_supported (no write endpoints, so N/A)", "ga_date (exact; using launch date)", "rate_limit_requests (exact QPS limit not published)" ], "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/yelp-fusion", "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/yelp-fusion/{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" } ] } }