Birdeye

Birdeye Competitor API

Make competitive insights your unfair advantage.

GitHub OpenAPI
Business capability
Market Intelligence Management BC-400.30

Operations 10

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

GET /v1/business/{EnterpriseBusinessNumber}/child List an enterprise's competitor businesses · Get Competitor Business #
Ask an LLM
“Which competitor businesses are tracked for my enterprise?”
“Can I list the competitors attached to an enterprise account?”
Tell an agent
List competitor businesses for enterprise {EnterpriseBusinessNumber} with isCompetitor {isCompetitor}.
Show enterprise {EnterpriseBusinessNumber}'s competitor businesses.
GET /v1/business/{EnterpriseCompetitorBusinessId}/child List a competitor enterprise's locations · Get Competitor Child Business #
Ask an LLM
“Can I list the child locations under a competitor enterprise?”
“What locations belong to a competitor brand I track?”
Tell an agent
List the child locations of competitor enterprise {EnterpriseCompetitorBusinessId} with isCompetitor {isCompetitor}.
Get the locations inside tracked competitor brand {EnterpriseCompetitorBusinessId}.
GET /v1/business/{businessId}/competitors List competitors for one location · Get Business Competitors #
Ask an LLM
“Who are the competitors configured for a single location?”
“Can I see the competitor list for one business rather than the whole enterprise?”
Tell an agent
Get the competitors of business {businessId}.
List competitors configured for location {businessId}.
POST /v1/signup/competitor/{businessNumber} Add a competitor to track · Create New Competitor Enterprise #
Ask an LLM
“Can I add a new competitor to track for my account?”
“What details do I need to create a competitor enterprise?”
Tell an agent
Create competitor enterprise {businessName} under account {businessNumber}.
Add competitor {businessName} with zip {zip} to account {businessNumber}.
POST /v1/signup/competitor/{businessId} Add a location to a competitor enterprise · Create New Child Business in Competitor Enterprise #
Ask an LLM
“Can I add another location to a competitor I already track?”
“Is it possible to create a child business inside a competitor enterprise?”
Tell an agent
Create a child business in competitor enterprise {businessId}.
Add a new location to competitor enterprise {businessId}.
POST /v1/aggregation/competitor/{compAccountId}/{businessNumber} Add a review source URL for a competitor · Add new Competitor Aggregation URL #
Ask an LLM
“Can I point Birdeye at a competitor's review site page to collect their reviews?”
“What do I need to add a review source URL for a competitor account?”
Tell an agent
Add competitor aggregation URL {url} for {sourceAlias} to competitor {compAccountId} of business {businessNumber}.
Start collecting {sourceAlias} reviews for competitor account {compAccountId} under {businessNumber}.
POST /v1/review/businessId/{CompetitorEnterpriseBusinessId} Get a competitor enterprise's reviews · Get Competitor Reviews #
Ask an LLM
“Can I read a competitor enterprise's reviews filtered by rating and source?”
“Is there a way to search competitor review text for a keyword?”
Tell an agent
Get {count} reviews of competitor enterprise {CompetitorEnterpriseBusinessId} starting at {sindex} with isCompetitor {isCompetitor}.
Search reviews of competitor {CompetitorEnterpriseBusinessId} for {searchStr} with ratings {ratings}.
POST /v1/competitors/competitive-insight/categories/{businessNumber} Get competitive category scores · Get Score #
Ask an LLM
“What is my competitive insight score by category compared with competitors?”
“Can I compare category scores against specific competitors for a time period?”
Tell an agent
Get competitive category scores for {businessNumber} against {competitors}.
Show category scores for {businessNumber} from {startDate} to {endDate}.
POST /v1/competitors/competitive-insight/themes/{businessNumber} Compare review themes with competitors · Get Theme Statistics #
Ask an LLM
“Which review themes come up most for me versus my competitors?”
“Can I filter competitive themes by positive or negative sentiment?”
Tell an agent
Get the top {topThm} competitive themes for {businessNumber}.
Show {sentiment} theme statistics for {businessNumber} against {competitors}.
POST /v1/competitors/competitive-insight/keywords/{businessNumber} Compare review keywords with competitors · Get Keyword Statistics #
Ask an LLM
“Which keywords do reviewers use about me compared with competitors?”
“Can I limit competitive keyword stats to the top keywords by sentiment?”
Tell an agent
Get the top {topKW} competitive keywords for {businessNumber}.
Show {sentiment} keyword statistics for {businessNumber} versus {competitors}.

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-competitor-api-openapi.yml

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-competitor-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-competitor-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Birdeye Competitor API
  version: '1.0'
  description: 'Operations tagged Competitor 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 (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/openapi/birdeye-competitor-api-openapi.yml