Birdeye

Birdeye Listing API

Keep your business information accurate and consistent across 50+ websites.

GitHub OpenAPI

Operations 16

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /v1/listing/fix Trigger a listing fix for a business · Fix Listing #
Ask an LLM
“Can I trigger a fix for a location's inaccurate listings?”
“Is there a way to push corrections out to a business's listings?”
Tell an agent
Fix listings for business {b_id}.
Run a listing fix on {b_id}.
GET /v1/listing/status/location Get a location's listing status report · Get Location Status Report #
Ask an LLM
“What is the listing status on each site for my location?”
“Can I get a listing status report for one location?”
Tell an agent
Get the listing status report for {businessNumber}.
Show listing sync status for location {businessNumber}.
POST /v1/listing/insights Get listing insights · Listings Insights #
Ask an LLM
“Can I get listing insights for my locations over a date range?”
“Can listing insights be viewed in different view modes?”
Tell an agent
Get listings insights for account {businessId} in view mode {viewMode}.
Show listing insights for {businessNumbers} from {startDate} to {endDate}, account {businessId}, mode {viewMode}.
POST /v1/listing/report/{reportType}/datapoints Get datapoints for a listing report type · Listings Insights Datapoints #
Ask an LLM
“Can I get datapoints for one listing report type, like search views or customer actions?”
“Can I group listing datapoints by a period?”
Tell an agent
Get {reportType} datapoints for account {businessId}.
Pull {reportType} listing datapoints for {businessNumbers} grouped by {groupByType}, account {businessId}.
GET /v1/listing/{businessNumber}/gmb-attributes-list List Google Business Profile attributes · Get GMB Attributes #
Ask an LLM
“Which Google Business Profile attributes apply to my category?”
“Can I list GMB attributes for a particular country and category?”
Tell an agent
Get GMB attributes for {businessNumber} in category {categoryId}, country {countryCode}.
List Google attributes for category {categoryId} in {countryCode} for location {businessNumber}.
GET /v1/listing/{businessNumber}/apple-location-attributes-list List Apple location attributes · Get Apple Attributes #
Ask an LLM
“Which Apple location attributes can I set on my listing?”
“Can I see the attribute options available for an Apple listing?”
Tell an agent
Get Apple location attributes for {businessNumber}.
List the Apple listing attributes available to {businessNumber}.
GET /v1/listing/{businessNumber}/category-list List business categories for a listing source · Get Category List #
Ask an LLM
“Which business categories can I choose on a given listing site?”
“Can I get the category list for a specific country?”
Tell an agent
Get the {sourceName} category list for {businessNumber} in {countryCode}.
List categories from {sourceName} available in {countryCode} for location {businessNumber}.
POST /v1/listing/{businessNumber}/create Create a location listing · Create Listing #
Ask an LLM
“Can I create a listing with business info and media for a new location?”
“Can I set up a new location's listing including Apple and Facebook data?”
Tell an agent
Create a listing for {businessNumber} with business info {businessInfo}.
Set up a new listing on {businessNumber} with media {media}.
PUT /v1/listing/{businessNumber}/update Update an existing listing · Update Listing #
Ask an LLM
“Can I update an existing listing's business info?”
“Can I opt a listing out of certain sites when updating it?”
Tell an agent
Update the listing of {businessNumber} with business info {businessInfo}.
Change the existing listing for {businessNumber}, opting out of {optOut}.
GET /v1/listing/{businessNumber}/get Get a location's listing · Get Listing #
Ask an LLM
“What listing data does Birdeye hold for my location?”
“Can I read back the full listing I set up for a location?”
Tell an agent
Get the listing for {businessNumber}.
Show the current listing details of location {businessNumber}.
GET /v1/listing/{businessNumber}/more-hours-type List more-hours types for a channel · Get More Hours Type #
Ask an LLM
“Which more-hours types are available for Google or Apple listings?”
“Can I fetch more-hours options for one channel?”
Tell an agent
Get more hours types for {businessNumber} on channel {channel}.
List {channel} more-hours types for location {businessNumber}.
POST /v1/listing/{businessNumber}/gmb/keywords Get Google search keyword counts · Get Google Keywords Count #
Ask an LLM
“Which search keywords drove people to my Google profile in a month?”
“Can I see keyword search counts across several locations?”
Tell an agent
Get Google keyword counts for {businessNumber} in {selectedMonth}.
Show Google search keyword counts for {selectedMonth} matching {keywordsSearch} on {businessNumber}.
POST /v1/listing/{businessNumber}/deactivate Deactivate a location's listing · Deactivate Listing #
Ask an LLM
“Can I deactivate a location's listing?”
“Is there a way to stop managing the listing for a closed location?”
Tell an agent destructive · confirm first
Deactivate the listing for {businessNumber}.
Turn off listing management for location {businessNumber}.
POST /v1/listing/menu-details Retrieve listing menu details · Retrieve Menu Details #
Ask an LLM
“Can I pull the menu details stored on my location listings?”
“Which locations have menu information on their listings?”
Tell an agent
Retrieve menu details for {businessNumbers}.
Get listing menus for locations {businessNumbers}.
GET /v1/listing/get/hotel-attributes Get hotel attributes for a business · Get Hotel Attributes #
Ask an LLM
“Which hotel attributes apply to my property's listing?”
“Can I fetch the configured hotel attributes for a business?”
Tell an agent
Get hotel attributes for business {businessNumber}.
List the hotel listing attributes configured for {businessNumber}.

Documentation

📖
Documentation
https://docs.birdeye.com/api/introduction
📖
Authentication
https://docs.birdeye.com/api/authentication

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/openapi/birdeye-listing-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/json-schema/birdeye-apiary-get-hotel-attributes-response200-schema.json

Other Resources

🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/vocabulary/birdeye-vocabulary.yml
🔗
JSONLDContext
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/json-ld/birdeye-context.jsonld

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/birdeye:birdeye-listing-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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

birdeye-listing-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Birdeye Listing API
  version: '1.0'
  description: 'Operations tagged Listing across 2 of this provider''s published API definitions: birdeye-birdeye-api-openapi.yml, birdeye-openapi-original.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.birdeye.com
  description: Production
- url: https://api.birdeye.com/resources
tags:


# --- truncated at 32 KB (161 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/openapi/birdeye-listing-api-openapi.yml