Yelp website screenshot

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.

68.2/100 exemplar ▬ flat Agent 48/100 agent native Heartbeat 100/100 alive open core · MIT Full breakdown ↓
scored 2026-11-13 · rubric v0.28.0 · Show this score on your site →
AccessPaid
25 published contracts 1 MCP Servers 5 Agent Skills 8 Features 5 Use Cases
RestaurantLocal SearchReviewsBusiness DataLocationPlacesGenerative AI

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

Consumer Commerce
AE-140
Reviews
GET /v3/businesses/{business_id_or_alias}/reviews

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-11-13 · rubric v0.28.0
Regulatory Posture applies to this provider. Its tags matched the AI & Biometrics regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.
Open Source Surface applies to this provider. This product is open source and we read its repository directly, so Open Source Surface carries 10 points of the composite. It is scored from what the repository actually publishes — a security policy, a contribution guide, a release history, a code of conduct — read live from the provider rather than inferred from our own catalog pointers. This facet adds; nothing was taken away to make room for it. An open-source project is not excused from the commercial facets, because exemption would strip it of the points it does earn. If we have the wrong repository, or this product is not open source, say so on your provider repo and we will drop the facet rather than have you publish against it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.
The six quality facets above are damped to 65 points between them, because both conditional facets apply and carry 35 points together. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 65% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site. Kin Score badge preview for Yelp It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/yelp/"><img src="https://apis.io/badge/yelp/card.svg" alt="Yelp on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
2 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
Ask about:
Yelp · a person reads this and replies by email.
or email info@apis.io
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/yelp/apis.yml: open an issue on github.com/api-evangelist/yelp to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

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.

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.

measured — observed by APIs.io (documented)
measured — observed by APIs.io (published)
measured — observed by APIs.io (declared)

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 COLLECTION

Yelp Fusion AI Events API

OPEN COLLECTION

Yelp Fusion API

OPEN COLLECTION

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Yelp MCP Server

MCP server requiring an API key; 1 tool listed.

MCP SERVER

Agent Skills 5

Packaged agent skills for driving this provider's APIs from an AI assistant.

yelp-ask-yelp-ai

AGENT SKILL

yelp-work-a-lead

AGENT SKILL

GraphQL 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...

GRAPHQL

Yelp API pricing

Prices published by Yelp, read 2026-10-28 from docs.developer.yelp.com/docs/plans.

PlanPrice
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

Rate-limit details →

Pricing Plans 1

Published pricing tiers and plan structures.

Yelp Plans Pricing

3 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Yelp Rate Limits

2 limits

RATE LIMITS

Terms of Service 1

What its API terms permit and prohibit, quoted from its own page.

Yelp

3 quoted statements, read from Yelp's own page on 2026-11-10.

TERMS

Privacy & Data 1

Its role, the data it processes, retention and transfers, quoted from its own privacy page.

Yelp

22 quoted statements, read from Yelp's own page on 2026-11-10.

PRIVACY

Eligibility 1

Who may sign up and where, quoted from its own terms.

Yelp

3 quoted statements, read from Yelp's own page on 2026-11-10.

ELIGIBILITY

AI Preferences 1

Its stance on AI training, inference and agents, quoted from its own pages.

Yelp

1 quoted statement, read from Yelp's own page on 2026-11-10.

AI PREFS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Yelp Finops

FINOPS

Features 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

25 classes · 86 properties

JSON-LD

Yelp Fusion Api Context

13 classes · 80 properties

JSON-LD

Spectral Rules 3

Spectral governance rulesets for linting and validating these APIs. Counts are the severity each rule declares, not results of running them.

Yelp — jsonschema rules

5 rules · 4 warn-severity 1 info-severity

SPECTRAL

Yelp API Rules

61 rules · 40 error-severity 14 warn-severity 7 info-severity

SPECTRAL

Yelp API Rules

39 rules · 6 error-severity 24 warn-severity 9 info-severity

SPECTRAL

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

7 actions · update · yelp-advertising-api-openapi.yml

GENERATED

Yelp Ai Api Overlay

2 actions · update · yelp-ai-api-openapi.yml

GENERATED

Yelp Business Subscriptions Api Overlay

5 actions · update · yelp-business-subscriptions-api-openapi.yml

GENERATED

Yelp Businesses Api Overlay

13 actions · update · yelp-businesses-api-openapi.yml

GENERATED

Yelp Categories Api Overlay

3 actions · update · yelp-categories-api-openapi.yml

GENERATED

Yelp Checkout Api Overlay

9 actions · update · yelp-checkout-api-openapi.yml

GENERATED

Yelp Claim Business Api Overlay

3 actions · update · yelp-claim-business-api-openapi.yml

GENERATED

Yelp Data Ingestion Api Overlay

3 actions · update · yelp-data-ingestion-api-openapi.yml

GENERATED

Yelp Events Api Overlay

4 actions · update · yelp-events-api-openapi.yml

GENERATED

Yelp Fulfillment Api Overlay

2 actions · update · yelp-fulfillment-api-openapi.yml

GENERATED

Yelp Home Services Api Overlay

4 actions · update · yelp-home-services-api-openapi.yml

GENERATED

Yelp Leads Api Overlay

7 actions · update · yelp-leads-api-openapi.yml

GENERATED

Yelp Listing Management Api Overlay

4 actions · update · yelp-listing-management-api-openapi.yml

GENERATED

Yelp Miscellaneous Api Overlay

2 actions · update · yelp-miscellaneous-api-openapi.yml

GENERATED

Yelp Oauth Authorization V2 Api Overlay

4 actions · update · yelp-oauth-authorization-v2-api-openapi.yml

GENERATED

Yelp Partner Support Api Overlay

6 actions · update · yelp-partner-support-api-openapi.yml

GENERATED

Yelp Program Feature Api Overlay

11 actions · update · yelp-program-feature-api-openapi.yml

GENERATED

Yelp Reporting Api V2 Api Overlay

5 actions · update · yelp-reporting-api-v2-api-openapi.yml

GENERATED

Yelp Reporting Api V3 Api Overlay

5 actions · update · yelp-reporting-api-v3-api-openapi.yml

GENERATED

Yelp Reservations Api Overlay

7 actions · update · yelp-reservations-api-openapi.yml

GENERATED

Yelp Respond To Reviews Api Overlay

5 actions · update · yelp-respond-to-reviews-api-openapi.yml

GENERATED

Yelp Reviews Api Overlay

3 actions · update · yelp-reviews-api-openapi.yml

GENERATED

Yelp Syndication Api Overlay

5 actions · update · yelp-syndication-api-openapi.yml

GENERATED

Yelp Syndication Base Api Overlay

5 actions · update · yelp-syndication-base-api-openapi.yml

GENERATED

Yelp Waitlist Partner Api Overlay

8 actions · update · yelp-waitlist-partner-api-openapi.yml

GENERATED

Yelp Webhooks Api Certification Overlay

1 action · security · yelp-webhooks-api-openapi.yml

DERIVED

Yelp Webhooks Api Overlay

7 actions · update · yelp-webhooks-api-openapi.yml

GENERATED

Scroll for all 27

JSON Schema 30

Standalone JSON Schema definitions for this provider's data models.

AiChatRequest

4 properties

JSON SCHEMA

AiChatResponse

5 properties

JSON SCHEMA

AutocompleteResponse

3 properties

JSON SCHEMA

BusinessDetail

6 properties

JSON SCHEMA

BusinessHours

3 properties

JSON SCHEMA

Business

17 properties

JSON SCHEMA

BusinessSearchResponse

3 properties

JSON SCHEMA

Category

5 properties

JSON SCHEMA

client_id

0 properties

JSON SCHEMA

client_secret

0 properties

JSON SCHEMA

Coordinates

2 properties

JSON SCHEMA

Event

20 properties

JSON SCHEMA

EventSearchResponse

2 properties

JSON SCHEMA

GenericAttributionWebhookRequest

9 properties

JSON SCHEMA

GetEventsResponse

1 properties

JSON SCHEMA

LeadObject

13 properties

JSON SCHEMA

Location

9 properties

JSON SCHEMA

MarkLeadAsRepliedRequest

1 properties

JSON SCHEMA

MarkLeadEventAsReadRequest

2 properties

JSON SCHEMA

MatchingCriteria

12 properties

JSON SCHEMA

Review

6 properties

JSON SCHEMA

ReviewsResponse

3 properties

JSON SCHEMA

Access Token Request

7 properties

JSON SCHEMA

Refresh Access Token Request

5 properties

JSON SCHEMA

Update

2 properties

JSON SCHEMA

WebhookKeySet

1 properties

JSON SCHEMA

WriteLeadEventRequest

2 properties

JSON SCHEMA

Scroll for all 30

JSON Structure 14

JSON Structure definitions describing this provider's data shapes.

Yelp Ai Chat Request Structure

4 properties

JSON STRUCTURE

Yelp Ai Chat Response Structure

5 properties

JSON STRUCTURE

Yelp Autocomplete Response Structure

3 properties

JSON STRUCTURE

Yelp Business Detail Structure

0 properties

JSON STRUCTURE

Yelp Business Hours Structure

3 properties

JSON STRUCTURE

Yelp Business Search Response Structure

3 properties

JSON STRUCTURE

Yelp Business Structure

17 properties

JSON STRUCTURE

Yelp Category Structure

5 properties

JSON STRUCTURE

Yelp Coordinates Structure

2 properties

JSON STRUCTURE

Yelp Event Search Response Structure

2 properties

JSON STRUCTURE

Yelp Event Structure

20 properties

JSON STRUCTURE

Yelp Location Structure

9 properties

JSON STRUCTURE

Yelp Review Structure

6 properties

JSON STRUCTURE

Yelp Reviews Response Structure

3 properties

JSON STRUCTURE

Scroll for all 14

Examples 14

Example request and response payloads for these APIs.

Yelp Business Example

17 fields

EXAMPLE

Yelp Category Example

5 fields

EXAMPLE

Yelp Coordinates Example

2 fields

EXAMPLE

Yelp Event Example

20 fields

EXAMPLE

Yelp Location Example

9 fields

EXAMPLE

Yelp Review Example

6 fields

EXAMPLE

Scroll for all 14

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Yelp Authentication

http/oauth2 · 3 schemes

SECURITY

Yelp Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Yelp Vulnerability Disclosure

Hackerone · security.txt · contact published

SECURITY

Scopes 1

OAuth scopes governing access to this provider's APIs.

Yelp Scopes

3 scopes · authorizationCode/clientCredentials

3 scopes

SCOPES

Agentic Access (API Evangelist recommendations) 1

Recommended x-agentic-access execution contracts for AI agents.

Yelp Agentic Access

112 operations · 54 acting · 3 human-in-the-loop

112 operations · 54 acting

AGENTIC

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)

apis.yml Raw ↑
aid: yelp
name: Yelp
description: 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.
type: Index
deliveryModel:
  model: open-core
  license: MIT
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: high
  source:
  - license
  - openapi
  - pricing
  generated: '2026-08-28'
  method: derived
accessModel:
  pricing: paid
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Paid
  confidence: high
  probe_state: covered
  source:
  - plans
  - authentication
  - scopes
  - rate-limits
  - security
  - sandbox
  generated: '2026-11-13'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/yelp.png
x-docs-platform: readme
x-docs-platform-confidence: high
x-docs-platform-checked: 2026-10-17
tags:
- Restaurant
- Local Search
- Reviews
- Business Data
- Location
- Places
- Generative AI
created: '2025-02-08'
modified: '2026-11-05'
url: https://raw.githubusercontent.com/api-evangelist/yelp/refs/heads/main/apis.yml
specificationVersion: '0.23'
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
common:
- type: Spectral
  url: rules/yelp-spectral-rules.yml
- type: Spectral
  url: rules/yelp-rules.yml
- type: Spectral
  url: rules/yelp-jsonschema-spectral-rules.yml
- type: JSONLD
  url: json-ld/yelp-context.jsonld
- type: Vocabulary
  url: vocabulary/yelp-vocabulary.yml
- type: AgentSkill
  url: skills/_index.yml
- type: DataModel
  url: data-model/yelp-data-model.yml
- type: ChangeLog
  url: changelog/yelp-changelog.yml
- type: Conventions
  url: conventions/yelp-conventions.yml
- type: Security
  url: https://hackerone.com/yelp?view_policy=true
- type: Deprecation
  url: lifecycle/yelp-lifecycle.yml
- type: Lifecycle
  url: lifecycle/yelp-lifecycle.yml
- type: ErrorCatalog
  url: errors/yelp-error-codes.yml
- type: ErrorCatalog
  url: errors/yelp-problem-types.yml
- type: Overlay
  url: overlays/yelp-advertising-api-overlay.yaml
- type: LLMsTxt
  url: llms/yelp-llms.txt
- type: ToolCrosswalk
  url: mcp/yelp-tool-crosswalk.yml
- type: MCPServer
  url: mcp/yelp-mcp.yml
- type: SecurityTxt
  url: well-known/yelp-yelp-security.txt
- type: SecurityTxt
  url: well-known/yelp-security.txt
- type: WellKnown
  url: well-known/yelp-well-known.yml
- type: Hosts
  url: hosts/yelp-hosts.yml
- type: IntegrationEdges
  url: integrations/yelp-integration-edges.yml
- type: Vendors
  url: vendors/yelp-vendors.yml
- type: Packages
  url: packages/yelp-packages.yml
- type: OAuthScopes
  url: scopes/yelp-scopes.yml
- type: CapabilityMap
  url: capabilities/yelp-capability-edges.yml
  name: Yelp Business Capability Map
- type: Website
  url: https://yelp.com
- type: IssueTracker
  url: https://github.com/Yelp/yelp-fusion/issues
- type: License
  name: MIT
  url: https://github.com/Yelp/yelp-fusion/blob/master/LICENSE
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/yelp/overview
- type: AgenticAccess
  url: agentic-access/yelp-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/yelp-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/yelp-domain-security.yml
- type: Authentication
  url: authentication/yelp-authentication.yml
- type: Blog
  url: https://blog.yelp.com/feed/
- type: Documentation
  url: https://docs.developer.yelp.com/
- type: GettingStarted
  url: https://docs.developer.yelp.com/docs/getting-started
- type: APIReference
  url: https://docs.developer.yelp.com/reference/v3_business_search
- type: Authentication
  url: https://docs.developer.yelp.com/docs/oauth-authorization
- type: DeveloperPortal
  url: https://www.yelp.com/developers
- type: Signup
  url: https://www.yelp.com/developers/v3/manage_app
- type: Console
  url: https://www.yelp.com/developers/fusion-ai/chat
- type: Pricing
  url: https://docs.developer.yelp.com/docs/plans
- type: RateLimits
  url: https://docs.developer.yelp.com/docs/places-rate-limiting
- type: ErrorCodes
  url: https://docs.developer.yelp.com/docs/api-errors
- type: FAQ
  url: https://docs.developer.yelp.com/docs/places-faq
- type: ChangeLog
  url: https://docs.developer.yelp.com/changelog
- type: TermsOfService
  url: https://docs.developer.yelp.com/docs/policies
- type: GitHubOrganization
  url: https://github.com/Yelp
- type: GitHubRepository
  url: https://github.com/Yelp/yelp-fusion
- type: LinkedIn
  url: https://www.linkedin.com/company/yelp-com
- type: Support
  url: https://www.yelp-support.com/
- type: PrivacyPolicy
  url: https://www.yelp.com/tos/privacy_policy
- type: LlmsText
  url: https://docs.developer.yelp.com/llms.txt
- type: SDKs
  title: Yelp Fusion Code Samples
  url: https://github.com/Yelp/yelp-fusion
- type: SDKs
  title: Python (yelp-python)
  url: https://github.com/Yelp/yelp-python
- type: SDKs
  title: Ruby (yelp-ruby)
  url: https://github.com/Yelp/yelp-ruby
- type: SDKs
  title: Android (yelp-android)
  url: https://github.com/Yelp/yelp-android
- type: SDKs
  title: iOS (yelp-ios)
  url: https://github.com/Yelp/yelp-ios
- type: Tools
  title: MCP Server (Fusion AI)
  url: https://github.com/Yelp/yelp-mcp
- type: SpectralRules
  url: rules/yelp-spectral-rules.yml
- type: Vocabulary
  url: vocabulary/yelp-vocabulary.yaml
- type: JSONLD
  url: json-ld/yelp-fusion-api-context.jsonld
- type: Plans
  url: plans/yelp-plans-pricing.yml
- type: RateLimits
  url: rate-limits/yelp-rate-limits.yml
- type: FinOps
  url: finops/yelp-finops.yml
- type: Features
  data:
  - name: Business Search
    description: Search up to 240 businesses by location, term, category, price, and attributes.
  - name: Business Details
    description: Retrieve rich detail for a business by id or alias, including hours, photos, and attributes.
  - name: Reviews
    description: Retrieve review excerpts, ratings, and reviewer details for a business.
  - name: Autocomplete
    description: Return search-term, business, and category suggestions as the user types.
  - name: Phone and Address Match
    description: Resolve a phone number or postal address to Yelp businesses.
  - name: Events
    description: Search and retrieve local events with timing, location, cost, and ticketing.
  - name: Category Taxonomy
    description: Access the full Yelp business category list and per-category details.
  - name: Fusion AI
    description: Natural language, multi-turn conversational search and business questions.
- type: UseCases
  data:
  - name: Restaurant Discovery
    description: Power restaurant and food discovery experiences with search, ratings, and photos.
  - name: Location-Aware Recommendations
    description: Surface nearby, open, and highly-rated businesses based on user coordinates.
  - name: Reputation Monitoring
    description: Track ratings and review excerpts for a portfolio of businesses.
  - name: Conversational Concierge
    description: Build AI agents that answer natural language questions about local businesses.
  - name: Local Events Listings
    description: Embed curated local event listings into apps and sites.
- type: Integrations
  data:
  - name: Zapier
    description: Yelp Leads and Conversions APIs offer Zapier integrations for no-code workflows.
  - name: Model Context Protocol
    description: Official Yelp MCP server exposes Fusion AI as an agent tool over MCP.
  - name: Webhooks
    description: Reviews and Leads webhooks push real-time events to partner endpoints.
- type: UsageTerms
  url: terms/yelp-terms-of-service.yml
- type: DataProcessing
  url: privacy/yelp-privacy-policy.yml
- type: Eligibility
  url: eligibility/yelp-eligibility.yml
- type: AIPreferences
  url: ai-preferences/yelp-ai-preferences.yml
apis:
- aid: yelp:yelp-ai-api
  name: Yelp AI API
  description: Conversational Yelp Fusion AI search and chat
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Artificial Intelligence
  tags_raw:
  - AI
  properties:
  - type: OpenAPI
    url: openapi/yelp-ai-api-openapi.yml
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_search
  - type: JSONSchema
    url: json-schema/yelp-ai-chat-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-ai-chat-response-schema.json
  - type: JSONStructure
    url: json-structure/yelp-business-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-detail-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-search-response-structure.json
  - type: JSONStructure
    url: json-structure/yelp-review-structure.json
  - type: JSONStructure
    url: json-structure/yelp-event-structure.json
  - type: JSONStructure
    url: json-structure/yelp-category-structure.json
  - type: Examples
    url: examples/yelp-business-search-response-example.json
  - type: Examples
    url: examples/yelp-business-detail-example.json
  - type: Examples
    url: examples/yelp-reviews-response-example.json
  - type: Examples
    url: examples/yelp-event-search-response-example.json
  - type: Examples
    url: examples/yelp-autocomplete-response-example.json
  - type: Examples
    url: examples/yelp-ai-chat-response-example.json
  - type: GraphQL
    url: graphql/yelp-graphql.md
- aid: yelp:yelp-businesses-api
  name: Yelp Businesses API
  description: Search, match, and retrieve local business data
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Business
  tags_raw:
  - Businesses
  properties:
  - type: OpenAPI
    url: openapi/yelp-businesses-api-openapi.yml
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_search
  - type: JSONSchema
    url: json-schema/yelp-business-schema.json
  - type: JSONSchema
    url: json-schema/yelp-business-detail-schema.json
  - type: JSONSchema
    url: json-schema/yelp-business-search-response-schema.json
  - type: JSONSchema
    url: json-schema/yelp-location-schema.json
  - type: JSONSchema
    url: json-schema/yelp-coordinates-schema.json
  - type: JSONSchema
    url: json-schema/yelp-category-schema.json
  - type: JSONSchema
    url: json-schema/yelp-autocomplete-response-schema.json
  - type: JSONSchema
    url: json-schema/yelp-business-hours-schema.json
  - type: JSONStructure
    url: json-structure/yelp-business-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-detail-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-search-response-structure.json
  - type: JSONStructure
    url: json-structure/yelp-review-structure.json
  - type: JSONStructure
    url: json-structure/yelp-event-structure.json
  - type: JSONStructure
    url: json-structure/yelp-category-structure.json
  - type: Examples
    url: examples/yelp-business-search-response-example.json
  - type: Examples
    url: examples/yelp-business-detail-example.json
  - type: Examples
    url: examples/yelp-reviews-response-example.json
  - type: Examples
    url: examples/yelp-event-search-response-example.json
  - type: Examples
    url: examples/yelp-autocomplete-response-example.json
  - type: Examples
    url: examples/yelp-ai-chat-response-example.json
  - type: GraphQL
    url: graphql/yelp-graphql.md
- aid: yelp:yelp-categories-api
  name: Yelp Categories API
  description: Yelp business category taxonomy
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Categories
  properties:
  - type: OpenAPI
    url: openapi/yelp-categories-api-openapi.yml
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_search
  - type: JSONSchema
    url: json-schema/yelp-category-schema.json
  - type: JSONStructure
    url: json-structure/yelp-business-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-detail-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-search-response-structure.json
  - type: JSONStructure
    url: json-structure/yelp-review-structure.json
  - type: JSONStructure
    url: json-structure/yelp-event-structure.json
  - type: JSONStructure
    url: json-structure/yelp-category-structure.json
  - type: Examples
    url: examples/yelp-business-search-response-example.json
  - type: Examples
    url: examples/yelp-business-detail-example.json
  - type: Examples
    url: examples/yelp-reviews-response-example.json
  - type: Examples
    url: examples/yelp-event-search-response-example.json
  - type: Examples
    url: examples/yelp-autocomplete-response-example.json
  - type: Examples
    url: examples/yelp-ai-chat-response-example.json
  - type: GraphQL
    url: graphql/yelp-graphql.md
- aid: yelp:yelp-events-api
  name: Yelp Events API
  description: Local event search and details
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Event
  tags_raw:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/yelp-events-api-openapi.yml
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_search
  - type: JSONSchema
    url: json-schema/yelp-location-schema.json
  - type: JSONSchema
    url: json-schema/yelp-event-schema.json
  - type: JSONSchema
    url: json-schema/yelp-event-search-response-schema.json
  - type: JSONStructure
    url: json-structure/yelp-business-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-detail-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-search-response-structure.json
  - type: JSONStructure
    url: json-structure/yelp-review-structure.json
  - type: JSONStructure
    url: json-structure/yelp-event-structure.json
  - type: JSONStructure
    url: json-structure/yelp-category-structure.json
  - type: Examples
    url: examples/yelp-business-search-response-example.json
  - type: Examples
    url: examples/yelp-business-detail-example.json
  - type: Examples
    url: examples/yelp-reviews-response-example.json
  - type: Examples
    url: examples/yelp-event-search-response-example.json
  - type: Examples
    url: examples/yelp-autocomplete-response-example.json
  - type: Examples
    url: examples/yelp-ai-chat-response-example.json
  - type: GraphQL
    url: graphql/yelp-graphql.md
- aid: yelp:yelp-reviews-api
  name: Yelp Reviews API
  description: Business review excerpts and ratings
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Reviews
  properties:
  - type: OpenAPI
    url: openapi/yelp-reviews-api-openapi.yml
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_search
  - type: JSONSchema
    url: json-schema/yelp-review-schema.json
  - type: JSONSchema
    url: json-schema/yelp-reviews-response-schema.json
  - type: JSONStructure
    url: json-structure/yelp-business-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-detail-structure.json
  - type: JSONStructure
    url: json-structure/yelp-business-search-response-structure.json
  - type: JSONStructure
    url: json-structure/yelp-review-structure.json
  - type: JSONStructure
    url: json-structure/yelp-event-structure.json
  - type: JSONStructure
    url: json-structure/yelp-category-structure.json
  - type: Examples
    url: examples/yelp-business-search-response-example.json
  - type: Examples
    url: examples/yelp-business-detail-example.json
  - type: Examples
    url: examples/yelp-reviews-response-example.json
  - type: Examples
    url: examples/yelp-event-search-response-example.json
  - type: Examples
    url: examples/yelp-autocomplete-response-example.json
  - type: Examples
    url: examples/yelp-ai-chat-response-example.json
  - type: GraphQL
    url: graphql/yelp-graphql.md
- aid: yelp:yelp-advertising-api
  name: Yelp Advertising API
  description: 'Advertising operations documented in the Yelp developer reference: Pause Program; Resume Program; Create Program;
    Modify Program; Terminate Program; Program Status.'
  humanURL: https://docs.developer.yelp.com/reference/create_reseller_program_v1
  baseURL: https://partner-api.yelp.com
  properties:
  - type: OpenAPI
    url: openapi/yelp-advertising-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_reseller_program_v1
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-business-subscriptions-api
  name: Yelp Business Subscriptions API
  description: 'Business Subscriptions operations documented in the Yelp developer reference: Get Business Subscriptions;
    Subscribe to businesses; Unsubscribe from businesses; Get Quota.'
  humanURL: https://docs.developer.yelp.com/reference/create_business_subscriptions
  baseURL: https://api.yelp.com/v3/businesses
  properties:
  - type: OpenAPI
    url: openapi/yelp-business-subscriptions-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_business_subscriptions
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-claim-business-api
  name: Yelp Claim Business API
  description: 'Claim Business operations documented in the Yelp developer reference: Claim Business; Claim Status.'
  humanURL: https://docs.developer.yelp.com/reference/claim_business_v1
  baseURL: https://partner-api.yelp.com
  properties:
  - type: OpenAPI
    url: openapi/yelp-claim-business-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/claim_business_v1
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: JSONSchema
    url: json-schema/yelp-matching-criteria-schema.json
- aid: yelp:yelp-data-ingestion-api
  name: Yelp Data Ingestion API
  description: 'Data Ingestion operations documented in the Yelp developer reference: Business Update; Job Status.'
  humanURL: https://docs.developer.yelp.com/reference/create_business_update_v1
  baseURL: https://partner-api.yelp.com/v1
  properties:
  - type: OpenAPI
    url: openapi/yelp-data-ingestion-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_business_update_v1
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: JSONSchema
    url: json-schema/yelp-update-schema.json
  - type: JSONSchema
    url: json-schema/yelp-matching-criteria-schema.json
- aid: yelp:yelp-home-services-api
  name: Yelp Home Services API
  description: 'Home Services operations documented in the Yelp developer reference: Get Jobs; Get Survey; Request a Quote.'
  humanURL: https://docs.developer.yelp.com/reference/v3_get_jobs
  baseURL: https://api.yelp.com
  properties:
  - type: OpenAPI
    url: openapi/yelp-home-services-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_get_jobs
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-leads-api
  name: Yelp Leads API
  description: '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.'
  humanURL: https://docs.developer.yelp.com/reference/get-lead-events
  baseURL: https://api.yelp.com/v3
  properties:
  - type: OpenAPI
    url: openapi/yelp-leads-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-lead-events
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: JSONSchema
    url: json-schema/yelp-lead-object-schema.json
  - type: JSONSchema
    url: json-schema/yelp-mark-lead-event-as-read-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-write-lead-event-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-get-events-response-schema.json
  - type: JSONSchema
    url: json-schema/yelp-mark-lead-as-replied-request-schema.json
- aid: yelp:yelp-listing-management-api
  name: Yelp Listing Management API
  description: 'Listing Management operations documented in the Yelp developer reference: Add subscriptions; Delete subscriptions;
    Retrieve subscriptions.'
  humanURL: https://docs.developer.yelp.com/reference/add_listing_management_subscriptions_v1
  baseURL: https://partner-api.yelp.com/listing_management
  properties:
  - type: OpenAPI
    url: openapi/yelp-listing-management-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_listing_management_subscriptions_v1
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-oauth-authorization-v2-api
  name: Yelp OAuth Authorization v2 API
  description: 'OAuth Authorization v2 operations documented in the Yelp developer reference: Revoke Access Token; Get Access
    Token v2; Get Access Token v3.'
  humanURL: https://docs.developer.yelp.com/reference/oauth2_revoke
  baseURL: https://api.yelp.com/oauth2
  properties:
  - type: OpenAPI
    url: openapi/yelp-oauth-authorization-v2-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/oauth2_revoke
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: JSONSchema
    url: json-schema/yelp-token-authorization-code-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-token-authorization-code-response-schema.json
  - type: JSONSchema
    url: json-schema/yelp-token-refresh-token-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-token-refresh-token-response-schema.json
  - type: JSONSchema
    url: json-schema/yelp-client-secret-schema.json
  - type: JSONSchema
    url: json-schema/yelp-client-id-schema.json
- aid: yelp:yelp-partner-support-api
  name: Yelp Partner Support API
  description: 'Partner Support operations documented in the Yelp developer reference: Program List All; Business Info; Business
    Migration Info; Program Info; Program List.'
  humanURL: https://docs.developer.yelp.com/reference/get_business_info
  baseURL: https://partner-api.yelp.com
  properties:
  - type: OpenAPI
    url: openapi/yelp-partner-support-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get_business_info
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-program-feature-api
  name: Yelp Program Feature API
  description: 'Program Feature operations documented in the Yelp developer reference: Create a portfolio project draft; Retrieve
    Program Feature; Add Program Feature; Delete Program Feature; Get Portfolio Photos; Upload Portfolio Photos; Delete Portfolio
    Photo; Retrieve Portfolio Project Info; Update Portfolio Project; Delete Portfolio Project.'
  humanURL: https://docs.developer.yelp.com/reference/add_program_feature
  baseURL: https://partner-api.yelp.com/program
  properties:
  - type: OpenAPI
    url: openapi/yelp-program-feature-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_program_feature
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-respond-to-reviews-api
  name: Yelp Respond to Reviews API
  description: '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 Owner Information.'
  humanURL: https://docs.developer.yelp.com/reference/create_review_response
  baseURL: https://partner-api.yelp.com
  properties:
  - type: OpenAPI
    url: openapi/yelp-respond-to-reviews-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_review_response
  - type: Documentation
    url: https://docs.developer.yelp.com/
- aid: yelp:yelp-webhooks-api
  name: Yelp Webhooks API
  description: 'Webhooks operations documented in the Yelp developer reference: Subscribe to Webhooks; Linkout Attribution;
    Get Webhook Signing Keys; Add Business IDs to Allow List; Remove Business IDs from Allow List; Unsubscribe to Webhook.'
  humanURL: https://docs.developer.yelp.com/reference/add_businesses_to_allow_list
  baseURL: https://api.yelp.com/v3/webhooks
  properties:
  - type: OpenAPI
    url: openapi/yelp-webhooks-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_businesses_to_allow_list
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: JSONSchema
    url: json-schema/yelp-generic-attribution-webhook-request-schema.json
  - type: JSONSchema
    url: json-schema/yelp-webhook-key-set-schema.json
  - type: JSONSchema
    url: json-schema/yelp-add-remove-businesses-to-allow-list-response-schema.json
- aid: yelp:yelp-access-token-api
  name: Yelp Access Token API
  description: The Access Token API from Yelp — 1 operation(s) for access token.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://partner-api.yelp.com/
  tags:
  - Access Token
  properties:
  - type: OpenAPI
    url: openapi/yelp-access-token-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/reservation_availability_update_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-quota
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_business_subscriptions_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_waitlist_info-1
- aid: yelp:yelp-add-api
  name: Yelp Add API
  description: The Add API from Yelp — 1 operation(s) for add.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://partner-api.yelp.com/syndication/feed
  tags: []
  tags_raw:
  - Add
  properties:
  - type: OpenAPI
    url: openapi/yelp-add-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/reservation_availability_update_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-quota
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_business_subscriptions_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_waitlist_info-1
- aid: yelp:yelp-bookings-api
  name: Yelp Bookings API
  description: The Bookings API from Yelp — 6 operation(s) for bookings.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://api.yelp.com
  tags:
  - Booking
  tags_raw:
  - Bookings
  properties:
  - type: OpenAPI
    url: openapi/yelp-bookings-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/reservation_availability_update_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-quota
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_business_subscriptions_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_waitlist_info-1
- aid: yelp:yelp-checkout-api-api
  name: Yelp Checkout API
  description: The Checkout API API from Yelp — 8 operation(s) for checkout api.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://partner-api.yelp.com/checkout
  tags:
  - Checkout API
  properties:
  - type: OpenAPI
    url: openapi/yelp-checkout-api-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/reservation_availability_update_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-quota
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_business_subscriptions_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_waitlist_info-1
- aid: yelp:yelp-daily-reports-api
  name: Yelp Daily Reports API
  description: The Daily Reports API from Yelp — 4 operation(s) for daily reports.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://partner-api.yelp.com/analytics
  tags:
  - Daily Reports
  properties:
  - type: OpenAPI
    url: openapi/yelp-daily-reports-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/create_daily_reports_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/reservation_availability_update_v3
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/get-quota
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/add_business_subscriptions_v2
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_business_waitlist_info-1
- aid: yelp:yelp-fulfillment-api-api
  name: Yelp Fulfillment API
  description: The Fulfillment API API from Yelp — 1 operation(s) for fulfillment api.
  humanURL: https://docs.developer.yelp.com/
  baseURL: https://partner_base_url
  tags:
  - Fulfillment API
  properties:
  - type: OpenAPI
    url: openapi/yelp-fulfillment-api-api-openapi.yml
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/cancel_order
  - type: Documentation
    url: https://docs.developer.yelp.com/
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/check_fulfillment_availability
  - type: APIReference
    url: https://docs.developer.yelp.com/reference/v3_autocomplete


# --- truncated at 32 KB (44 KB total) ---
# Full source: https://artifacts.apis.io/yelp/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.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this
  • find_providersBrowse and filter every provider in the catalog.
  • get_provider_artifactsEvery artifact this provider publishes, grouped by type.
  • get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
  • get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
  • get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
  • get_provider_ratingPRO — composite, band, trend and facet scores.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This provider
curl "https://apis.io/api/v1/providers/yelp"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/yelp/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/yelp/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.