Yelp · OAuth Scopes

Yelp OAuth Scopes

OAuth 2.0 searched

Yelp publishes 3 OAuth 2.0 scopes via the authorizationCode and clientCredentials flows. Scopes are the fine-grained permissions an application requests at authorization time to act against the Yelp API on a user’s behalf.

Tokens are issued from https://api.yelp.com/oauth2/token/v3.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

RestaurantLocal SearchReviewsBusiness DataLocationPlacesGenerative AI

Scopes: 3 Flows: authorizationCode, clientCredentials Method: searched

OAuth endpoints

Authorization URL
https://biz.yelp.com/oauth2/authorize

Token URL
https://api.yelp.com/oauth2/token/v3 https://example.com/oauth2/token

Flows
authorizationCodeclientCredentials

Scopes (3)

Scope	Description	Flows
leads	Access Yelp Leads on your behalf, including reading and responding to messages, and storing message data	authorizationCode
r2r_get_businesses	enables the ability to retrieve a list of businesses that the business owner has "claimed" aka businesses that this user can respond to reviews for.	authorizationCode
r2r_business_owner	enables the ability to retrieve information about the business owner like username and profile photo.	authorizationCode

📄 Provider scope reference: https://docs.developer.yelp.com/docs/partner-integration-guide

Source

OAuth Scopes

generated: '2026-11-05'
method: searched
source: https://docs.developer.yelp.com/docs/partner-integration-guide
schemes:
- name: oauth2
  source: openapi/yelp-businesses-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://biz.yelp.com/oauth2/authorize
    tokenUrl: https://api.yelp.com/oauth2/token/v3
- name: oauth2
  source: openapi/yelp-leads-api-openapi.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://biz.yelp.com/oauth2/authorize
    tokenUrl: https://api.yelp.com/oauth2/token/v3
- name: sec0
  source: openapi/yelp-syndication-api-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://example.com/oauth2/token
- name: sec0
  source: openapi/yelp-syndication-base-api-openapi.yml
  flows:
  - flow: clientCredentials
    tokenUrl: https://example.com/oauth2/token
scopes:
- scope: leads
  description: Access Yelp Leads on your behalf, including reading and responding to messages, and storing message
    data
  flows:
  - authorizationCode
  sources:
  - openapi/yelp-businesses-api-openapi.yml
  - openapi/yelp-leads-api-openapi.yml
  docs_description: '`leads` - enables reading leads and responding to them.'
- scope: r2r_get_businesses
  description: enables the ability to retrieve a list of businesses that the business owner has "claimed" aka businesses
    that this user can respond to reviews for.
  flows:
  - authorizationCode
  sources:
  - https://docs.developer.yelp.com/docs/partner-integration-guide
- scope: r2r_business_owner
  description: enables the ability to retrieve information about the business owner like username and profile photo.
  flows:
  - authorizationCode
  sources:
  - https://docs.developer.yelp.com/docs/partner-integration-guide
docs: https://docs.developer.yelp.com/docs/partner-integration-guide
derived_from:
- openapi/yelp-businesses-api-openapi.yml
- openapi/yelp-leads-api-openapi.yml
- openapi/yelp-syndication-api-openapi.yml
- openapi/yelp-syndication-base-api-openapi.yml
note: The two sec0 clientCredentials schemes in the syndication specs carry a placeholder tokenUrl (example.com)
  from the authored contract; the docs name no client-credentials flow for those APIs. OAuth access is "reserved
  for contracted Yelp partners" (https://docs.developer.yelp.com/docs/oauth-authorization).

Work with this as data

Every scope set 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 oauth scopes

4 MCP tools reach this

find_scopesBrowse and filter every scope set in the catalog.
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 scope set

curl "https://apis.io/api/v1/scopes/yelp-scopes"

All oauth scopes

curl "https://apis.io/api/v1/scopes?limit=25"

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.

GitHub Google LinkedIn

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