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 5 APIs on the APIs.io network, including AI API, Businesses API, Categories API, and 2 more. Tagged areas include Restaurant, Local Search, Reviews, Business Data, and Location.
The Yelp catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.
Yelp’s developer surface includes authentication, engineering blog, documentation, getting-started guide, API reference, signup flow, developer console, and 28 more developer resources.
Kin Score
APIs 5
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
Postman Collections 5
Ready-to-run Postman collections for exercising this provider's APIs.
Open Collections 1
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Yelp Fusion API
OPEN COLLECTIONGraphQL 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...
GRAPHQLPricing Plans 1
Published pricing tiers and plan structures.
Yelp Plans Pricing
PLANSRate Limits 1
Documented rate limits and quota policies.
Yelp Rate Limits
RATE LIMITSFinOps 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 1
JSON-LD contexts and semantic vocabularies used across these APIs.
Yelp Fusion Api Context
JSON-LDSpectral Rules 2
Spectral governance rulesets for linting and validating these APIs.
Yelp API Rules
SPECTRALYelp API Rules
SPECTRALJSON Schema 14
Standalone JSON Schema definitions for this provider's data models.
AiChatRequest
JSON SCHEMAAiChatResponse
JSON SCHEMAAutocompleteResponse
JSON SCHEMABusinessDetail
JSON SCHEMABusinessHours
JSON SCHEMABusiness
JSON SCHEMABusinessSearchResponse
JSON SCHEMACategory
JSON SCHEMACoordinates
JSON SCHEMAEvent
JSON SCHEMAEventSearchResponse
JSON SCHEMALocation
JSON SCHEMAReview
JSON SCHEMAReviewsResponse
JSON SCHEMAScroll for all 14
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.
Agentic Access 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 2
Reference material describing how the API behaves
Agent Surfaces 2
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 4
Pagination, idempotency, versioning, errors, and events
Build 9
SDKs, sample code, and the tooling you integrate with
Scroll for all 9
Access & Security 4
Authentication, authorization, and security posture
Operate 4
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API