Yelp
Yelp connects people with great local businesses. The Yelp Fusion API gives developers programmatic access to Yelp's database of millions of local businesses, ratings, reviews, photos, events, and category taxonomy, plus the Yelp Fusion AI conversational search endpoint. Core public capabilities include business search and discovery, business details, review excerpts, autocomplete, phone and address matching, and local event search. Partner-tier APIs add reviews response, leads, advertising, reservations, waitlist, checkout, and reporting. Authentication uses a Yelp API key passed as a bearer token.
Yelp publishes 32 API contracts indexed on the APIs.io network, including AI API, Businesses API, Categories API, and 29 more. Tagged areas include Restaurant, Local Search, Reviews, Business Data, and Location.
The Yelp catalog on APIs.io includes 2 JSON-LD contexts and 3 Spectral governance rulesets.
Yelp’s developer surface includes changelog, authentication, engineering blog, documentation, getting-started guide, API reference, signup flow, and 64 more developer resources.
What this lets a business do 1
Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →
Kin Score
Markets this provider is in provisional
The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.
| Market | Position | Depth | Registered MCP server | Declares compatibility |
|---|---|---|---|---|
| Commerce Platform Ecosystems (Shopify, WooCommerce, Stripe Apps) | builds-on | 36.2 | - | 1 |
| Data Marketplaces (data providers on cloud data platforms) | builds-on | 36.2 | - | 1 |
| Reviews, Ratings and UGC (review platforms and who integrates with them) | builds-on | 36.2 | - | 1 |
| GraphQL Ecosystem (Foundation, graphql.org listings, public GraphQL APIs) | builds-on | 36.2 | - | 1 |
| IFTTT Services (service publishers) | builds-on | 36.2 | - | 1 |
Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards implemented 3
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
APIs 32
Individual APIs this provider publishes, each with its own machine-readable definition.
Yelp AI API
Conversational Yelp Fusion AI search and chat
Yelp Businesses API
Search, match, and retrieve local business data
Yelp Categories API
Yelp business category taxonomy
Yelp Events API
Local event search and details
Yelp Reviews API
Business review excerpts and ratings
Yelp Advertising API
Advertising operations documented in the Yelp developer reference: Pause Program; Resume Program; Create Program; Modify Program; Terminate Program; Program Status.
Yelp Business Subscriptions API
Business Subscriptions operations documented in the Yelp developer reference: Get Business Subscriptions; Subscribe to businesses; Unsubscribe from businesses; Get Quota.
Yelp Claim Business API
Claim Business operations documented in the Yelp developer reference: Claim Business; Claim Status.
Yelp Data Ingestion API
Data Ingestion operations documented in the Yelp developer reference: Business Update; Job Status.
Yelp Home Services API
Home Services operations documented in the Yelp developer reference: Get Jobs; Get Survey; Request a Quote.
Yelp Leads API
Leads operations documented in the Yelp developer reference: Get Lead IDs for a Business; Get Lead; Get Lead Events; Write Event; Mark Lead Event as read; Mark Lead as replied.
Yelp Listing Management API
Listing Management operations documented in the Yelp developer reference: Add subscriptions; Delete subscriptions; Retrieve subscriptions.
Yelp OAuth Authorization v2 API
OAuth Authorization v2 operations documented in the Yelp developer reference: Revoke Access Token; Get Access Token v2; Get Access Token v3.
Yelp Partner Support API
Partner Support operations documented in the Yelp developer reference: Program List All; Business Info; Business Migration Info; Program Info; Program List.
Yelp Program Feature API
Program Feature operations documented in the Yelp developer reference: Create a portfolio project draft; Retrieve Program Feature; Add Program Feature; Delete Program Feature; G...
Yelp Respond to Reviews API
Respond to Reviews API operations documented in the Yelp developer reference: Respond to Review; Get Access Token; Get Businesses Associated with Access Token; Retrieve Business...
Yelp Webhooks API
Webhooks operations documented in the Yelp developer reference: Subscribe to Webhooks; Linkout Attribution; Get Webhook Signing Keys; Add Business IDs to Allow List; Remove Busi...
Yelp Access Token API
The Access Token API from Yelp — 1 operation(s) for access token.
Yelp Add API
The Add API from Yelp — 1 operation(s) for add.
Yelp Bookings API
The Bookings API from Yelp — 6 operation(s) for bookings.
Yelp Checkout API
The Checkout API API from Yelp — 8 operation(s) for checkout api.
Yelp Daily Reports API
The Daily Reports API from Yelp — 4 operation(s) for daily reports.
Yelp Fulfillment API
The Fulfillment API API from Yelp — 1 operation(s) for fulfillment api.
Yelp List API
The List API from Yelp — 1 operation(s) for list.
Yelp Monthly Reports API
The Monthly Reports API from Yelp — 4 operation(s) for monthly reports.
Yelp OAuth Authorization v3 API
The OAuth Authorization v3 API from Yelp — 1 operation(s) for oauth authorization v3.
Yelp Portfolio Photo API
The Portfolio Photo API from Yelp — 2 operation(s) for portfolio photo.
Yelp Portfolio Project API
The Portfolio Project API from Yelp — 2 operation(s) for portfolio project.
Yelp Quota API
The Quota API from Yelp — 2 operation(s) for quota.
Yelp Remove API
The Remove API from Yelp — 1 operation(s) for remove.
Yelp Token API
The Token API from Yelp — 1 operation(s) for token.
Yelp Waitlist API
The Waitlist API from Yelp — 7 operation(s) for waitlist.
Scroll for all 32
Postman Collections 5
Ready-to-run Postman collections for exercising this provider's APIs.
Open Collections 5
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Yelp Fusion AI API
OPEN COLLECTIONYelp Fusion AI Businesses API
OPEN COLLECTIONYelp Fusion AI Categories API
OPEN COLLECTIONYelp Fusion AI Events API
OPEN COLLECTIONYelp Fusion API
OPEN COLLECTIONMCP Servers 1
Model Context Protocol servers that expose these APIs to AI agents.
Agent Skills 5
Packaged agent skills for driving this provider's APIs from an AI assistant.
yelp-ask-yelp-ai
AGENT SKILLyelp-book-a-reservation
AGENT SKILLyelp-find-and-vet-a-business
AGENT SKILLyelp-respond-to-a-review
AGENT SKILLyelp-work-a-lead
AGENT SKILLGraphQL 1
GraphQL schemas published by this provider.
Yelp GraphQL API
Yelp exposes a GraphQL endpoint alongside its REST Fusion API, available at `https://api.yelp.com/v3/graphql`. The same bearer-token authentication used for the REST API applies...
GRAPHQLYelp API pricing
Prices published by Yelp, read 2026-10-28 from docs.developer.yelp.com/docs/plans.
| Plan | Price |
|---|---|
| Premium | Premium Includes: 66 attributes; Early access to the AI API (20 daily API calls); Premium search filters; Up to 12 pho |
| Enhanced | Enhanced Includes: 23 attributes; Enhanced attributes only; max 3 photos; max 3 review excerpts; no Review Highlights e |
| Base | Base Includes: 15 attributes; Base search filters only; no review excerpts; no photos |
Plan details, limits and sources →
Rate limits
- Places API daily limit (Starter trial): a client is limited to 300 (Starter Plan) API calls per 24 hours, resetting every midnight UTC
- Places API QPS: You have exceeded the queries-per-second limit for this endpoint.
Pricing Plans 1
Published pricing tiers and plan structures.
Yelp Plans Pricing
PLANSRate Limits 1
Documented rate limits and quota policies.
Yelp Rate Limits
RATE LIMITSTerms of Service 1
What its API terms permit and prohibit, quoted from its own page.
Privacy & Data 1
Its role, the data it processes, retention and transfers, quoted from its own privacy page.
Eligibility 1
Who may sign up and where, quoted from its own terms.
AI Preferences 1
Its stance on AI training, inference and agents, quoted from its own pages.
FinOps 1
Cost, billing, and metering signals for API financial operations.
Yelp Finops
FINOPSFeatures 8
Notable capabilities this provider offers.
Business Search
Search up to 240 businesses by location, term, category, price, and attributes.
Business Details
Retrieve rich detail for a business by id or alias, including hours, photos, and attributes.
Reviews
Retrieve review excerpts, ratings, and reviewer details for a business.
Autocomplete
Return search-term, business, and category suggestions as the user types.
Phone and Address Match
Resolve a phone number or postal address to Yelp businesses.
Events
Search and retrieve local events with timing, location, cost, and ticketing.
Category Taxonomy
Access the full Yelp business category list and per-category details.
Fusion AI
Natural language, multi-turn conversational search and business questions.
Scroll for all 8
Semantic Vocabularies 2
JSON-LD contexts and semantic vocabularies used across these APIs.
Yelp Context
JSON-LDYelp Fusion Api Context
JSON-LDSpectral Rules 3
Spectral governance rulesets for linting and validating these APIs. Counts are the severity each rule declares, not results of running them.
OpenAPI Overlays 27
Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.
Yelp Advertising Api Overlay
GENERATEDYelp Ai Api Overlay
GENERATEDYelp Business Subscriptions Api Overlay
GENERATEDYelp Businesses Api Overlay
GENERATEDYelp Categories Api Overlay
GENERATEDYelp Checkout Api Overlay
GENERATEDYelp Claim Business Api Overlay
GENERATEDYelp Data Ingestion Api Overlay
GENERATEDYelp Events Api Overlay
GENERATEDYelp Fulfillment Api Overlay
GENERATEDYelp Home Services Api Overlay
GENERATEDYelp Leads Api Overlay
GENERATEDYelp Listing Management Api Overlay
GENERATEDYelp Miscellaneous Api Overlay
GENERATEDYelp Oauth Authorization V2 Api Overlay
GENERATEDYelp Partner Support Api Overlay
GENERATEDYelp Program Feature Api Overlay
GENERATEDYelp Reporting Api V2 Api Overlay
GENERATEDYelp Reporting Api V3 Api Overlay
GENERATEDYelp Reservations Api Overlay
GENERATEDYelp Respond To Reviews Api Overlay
GENERATEDYelp Reviews Api Overlay
GENERATEDYelp Syndication Api Overlay
GENERATEDYelp Syndication Base Api Overlay
GENERATEDYelp Waitlist Partner Api Overlay
GENERATEDYelp Webhooks Api Overlay
GENERATEDScroll for all 27
JSON Schema 30
Standalone JSON Schema definitions for this provider's data models.
AddRemoveBusinessesToAllowListResponse
JSON SCHEMAAiChatRequest
JSON SCHEMAAiChatResponse
JSON SCHEMAAutocompleteResponse
JSON SCHEMABusinessDetail
JSON SCHEMABusinessHours
JSON SCHEMABusiness
JSON SCHEMABusinessSearchResponse
JSON SCHEMACategory
JSON SCHEMAclient_id
JSON SCHEMAclient_secret
JSON SCHEMACoordinates
JSON SCHEMAEvent
JSON SCHEMAEventSearchResponse
JSON SCHEMAGenericAttributionWebhookRequest
JSON SCHEMAGetEventsResponse
JSON SCHEMALeadObject
JSON SCHEMALocation
JSON SCHEMAMarkLeadAsRepliedRequest
JSON SCHEMAMarkLeadEventAsReadRequest
JSON SCHEMAMatchingCriteria
JSON SCHEMAReview
JSON SCHEMAReviewsResponse
JSON SCHEMAAccess Token Request
JSON SCHEMARefresh Access Token Request
JSON SCHEMAUpdate
JSON SCHEMAWebhookKeySet
JSON SCHEMAWriteLeadEventRequest
JSON SCHEMAScroll for all 30
JSON Structure 14
JSON Structure definitions describing this provider's data shapes.
Yelp Ai Chat Request Structure
JSON STRUCTUREYelp Ai Chat Response Structure
JSON STRUCTUREYelp Autocomplete Response Structure
JSON STRUCTUREYelp Business Detail Structure
JSON STRUCTUREYelp Business Hours Structure
JSON STRUCTUREYelp Business Search Response Structure
JSON STRUCTUREYelp Business Structure
JSON STRUCTUREYelp Category Structure
JSON STRUCTUREYelp Coordinates Structure
JSON STRUCTUREYelp Event Search Response Structure
JSON STRUCTUREYelp Event Structure
JSON STRUCTUREYelp Location Structure
JSON STRUCTUREYelp Review Structure
JSON STRUCTUREYelp Reviews Response Structure
JSON STRUCTUREScroll for all 14
Examples 14
Example request and response payloads for these APIs.
Yelp Ai Chat Request Example
EXAMPLEYelp Business Detail Example
EXAMPLEYelp Business Example
EXAMPLEYelp Business Hours Example
EXAMPLEYelp Category Example
EXAMPLEYelp Coordinates Example
EXAMPLEYelp Event Example
EXAMPLEYelp Location Example
EXAMPLEYelp Review Example
EXAMPLEScroll for all 14
Security Posture 3
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Scopes 1
OAuth scopes governing access to this provider's APIs.
Agentic Access (API Evangelist recommendations) 1
Recommended x-agentic-access execution contracts for AI agents.
Use Cases 5
What developers build with this provider.
Restaurant Discovery
Power restaurant and food discovery experiences with search, ratings, and photos.
Location-Aware Recommendations
Surface nearby, open, and highly-rated businesses based on user coordinates.
Reputation Monitoring
Track ratings and review excerpts for a portfolio of businesses.
Conversational Concierge
Build AI agents that answer natural language questions about local businesses.
Local Events Listings
Embed curated local event listings into apps and sites.
Integrations 3
Pre-built integrations with other platforms and tools.
Zapier
Yelp Leads and Conversions APIs offer Zapier integrations for no-code workflows.
Model Context Protocol
Official Yelp MCP server exposes Fusion AI as an agent tool over MCP.
Webhooks
Reviews and Leads webhooks push real-time events to partner endpoints.
Resources
Get Started 4
Portal, sign-up, and the first successful call
Documentation 3
Reference material describing how the API behaves
Agent Surfaces 6
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 14
Pagination, idempotency, versioning, errors, and events
Scroll for all 14
Build 12
SDKs, sample code, and the tooling you integrate with
Scroll for all 12
Access & Security 8
Authentication, authorization, and security posture
Scroll for all 8
Operate 8
Status, limits, changes, and where to get help
Scroll for all 8
Commercial 7
Pricing, plans, and the legal terms of use
Scroll for all 7
Company 3
The organization behind the API
Other 6
Properties that don't map to a standard resource type
Source (apis.yml)
Yelp API — frequently asked questions
Does Yelp have an API?
Yes. APIs.io lists 32 APIs from Yelp, including Yelp AI API, Yelp Businesses API and Yelp Categories API, and 29 more.
Is there an OpenAPI specification for the Yelp API?
Yes. APIs.io indexes 32 OpenAPI specifications for Yelp, each linked for download from this page.
How do I authenticate with the Yelp API?
Yelp uses bearer-token authentication (http/oauth2 · 3 schemes). The details are profiled on APIs.io as Yelp Authentication.
How much does the Yelp API cost?
Yelp publishes its prices; its Premium plan is Premium as of 2026-10-28. APIs.io lists 3 pricing plans for Yelp, with each plan's price, limits and inclusions under Pricing on this page.
Does Yelp have an MCP server?
Yes. APIs.io lists 1 MCP server for Yelp: MCP server requiring an API key; 1 tool listed.
Is the Yelp API ready for AI agents?
Yelp has a Kin Score of 68.2 out of 100 (exemplar) and an Agent Readiness score of 47.7 (agent-native), scored by API Evangelist on 2026-11-13.
Work with this as data
Every provider here is available over the APIs.io API and to AI agents over MCP.