Yelp

Yelp Listing Management API

Listing Management operations documented in the Yelp developer reference: Add subscriptions; Delete subscriptions; Retrieve subscriptions.

GitHub OpenAPI

Operations 3

POST /businesses/add/v1 Add subscriptions #
POST /businesses/remove/v1 Delete subscriptions #
GET /businesses/v1 Retrieve subscriptions #

Documentation

📖
APIReference
https://docs.developer.yelp.com/reference/add_listing_management_subscriptions_v1
📖
Documentation
https://docs.developer.yelp.com/

Specifications

⚙
OpenAPI
https://artifacts.apis.io/yelp/openapi/yelp-listing-management-api-openapi.yml

Work with this as data

Every API 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 apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • 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 API 
curl "https://apis.io/api/v1/apis/yelp:yelp-listing-management-api"
All apis 
curl "https://apis.io/api/v1/apis?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.

OpenAPI Specification

yelp-listing-management-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Listing Management API
  version: '1.0'
servers:
- url: https://partner-api.yelp.com/listing_management
security:
- basic: []
tags:
- name: Listing Management
paths:
  /businesses/add/v1:
    post:
      deprecated: true
      summary: Add subscriptions
      tags:
      - Listing Management
      description: This endpoint creates new business subscriptions for Listing Management.
      operationId: add_listing_management_subscriptions_v1
      requestBody:
        description: Request body
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                business_ids:
                  type: array
                  description: List of Business IDs
                  items:
                    type: string
              required:
              - business_ids
      responses:
        $ref: '#/components/schemas/AddDeleteSubscriptionsResponse'
  /businesses/remove/v1:
    post:
      deprecated: true
      summary: Delete subscriptions
      tags:
      - Listing Management
      description: This endpoint deletes business subscriptions for Listing Management.
      operationId: remove_listing_management_subscriptions_v1
      requestBody:
        description: Request body
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                business_ids:
                  type: array
                  description: List of Business IDs
                  items:
                    type: string
              required:
              - business_ids
      responses:
        $ref: '#/components/schemas/AddDeleteSubscriptionsResponse'
  /businesses/v1:
    get:
      deprecated: true
      summary: Retrieve subscriptions
      tags:
      - Listing Management
      description: This endpoint returns a paginated list of active business subscriptions for Listing Management.
      operationId: get_listing_management_subscriptions_v1
      parameters:
      - in: query
        name: limit
        required: false
        schema:
          type: integer
          max: 10000
          min: 1
          default: 50
        description: Number of business subscriptions to return per page.
      - in: query
        name: offset
        required: false
        schema:
          type: integer
          default: 0
        description: Page offset.
      responses:
        $ref: '#/components/schemas/GetSubscriptionsResponse'
components:
  schemas:
    GetSubscriptionsResponse:
      '200':
        description: '200'
        content:
          application/json:
            schema:
              type: object
              properties:
                total:
                  type: integer
                limit:
                  type: integer
                offset:
                  type: integer
                subscriptions:
                  type: array
                  items:
                    type: object
                    properties:
                      subscribed_at:
                        type: string
                      business_id:
                        type: string
            examples:
              Result:
                value:
                  total: 3
                  limit: 2
                  offset: 0
                  subscriptions:
                  - subscribed_at: '2020-02-21T10:40:50+00:00'
                    business_id: VUMc8yNaIW7E3K19nabXfA
                  - subscribed_at: '2020-02-21T10:43:11+00:00'
                    business_id: bOEsE8ZSp6ltTKB9deFeYw
      '400':
        $ref: '#/components/schemas/400Response'
    400Response:
      description: '400'
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: object
                properties:
                  http_code:
                    type: integer
                  id:
                    type: string
                  description:
                    type: string
          examples:
            Result:
              value:
                error:
                  http_code: 400
                  id: BAD_REQUEST
                  description: A meaningful description of the error.
    AddDeleteSubscriptionsResponse:
      '204':
        description: '204'
      '400':
        $ref: '#/components/schemas/400Response'
  securitySchemes:
    basic:
      type: http
      scheme: basic
x-provenance:
  method: searched
  source: https://docs.developer.yelp.com/reference
  harvested: '2026-11-05'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://docs.developer.yelp.com/reference/add_listing_management_subscriptions_v1.md
  - https://docs.developer.yelp.com/reference/get_listing_management_subscriptions_v1.md
  - https://docs.developer.yelp.com/reference/remove_listing_management_subscriptions_v1.md
  merge:
    pages: 3
    deduped: 5
    conflicts_kept_first: 0