Birdeye

Birdeye Social API

Create and track Social posting for all channels.

GitHub OpenAPI
Business capability
Digital Marketing Management BC-400.60

Operations 8

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/social/{accountNumber}/schedule Schedule a social media post · Schedule Social Post #
Ask an LLM
“Can I schedule a social media post for a future time?”
“Can one scheduled post go out to several locations with media?”
Tell an agent
Schedule post {text} on {socialSite} for account {accountNumber} at {scheduleTimestamp}.
Schedule a {socialSite} post saying {text} for locations {subBusinessNumbers} under {accountNumber}.
POST /v1/social/post/public/scheduled/edit/{accountNumber} Edit a scheduled social post · Edit Scheduled Social Post #
Ask an LLM
“Can I change a post that's scheduled but not yet published?”
“Is it possible to move a scheduled post to a different time?”
Tell an agent
Edit scheduled post {trackingId} on account {accountNumber} to say {text}.
Reschedule post {trackingId} for {accountNumber} to {scheduleTimestamp}.
POST /v1/social/post/public/published/edit/{accountNumber} Edit a published social post · Edit Published social Post #
Ask an LLM
“Can I edit a social post after it has already been published?”
“Is there a way to fix a typo in a live post?”
Tell an agent
Edit published post {trackingId} on account {accountNumber} to read {text}.
Update the live {socialSite} post {trackingId} for {accountNumber}.
POST /v1/social/post/public/delete/{accountNumber} Delete a social post · Delete public social Post #
Ask an LLM
“Can I delete a social post from specific locations?”
“Is there a way to take down a post that went out?”
Tell an agent destructive · confirm first
Delete social post {trackingId} from locations {subBusinessNumbers} on account {accountNumber}.
Take down post {trackingId} for account {accountNumber}.
GET /v1/social/{accountNumber}/post/track/{trackingId} Track a social post's status · Track Social Post #
Ask an LLM
“Did my social post publish successfully?”
“Can I check a post's status with its tracking ID?”
Tell an agent
Track post {trackingId} on account {accountNumber}.
Check the publish status of post {trackingId} for {accountNumber}.
POST /v1/social/open-url/performance/report Get the social open URL performance report · Social Open URL Performance Report #
Ask an LLM
“Can I get the social open URL performance report for a date range?”
“Can I compare open URL performance with a previous period by channel?”
Tell an agent
Get the social open URL performance report from {startDate} to {endDate}.
Show open URL performance for {sourceNames} between {startDate} and {endDate}.
POST /v1/social/post/public/media/upload Upload images or videos to the media library · Upload Social Media #
Ask an LLM
“Can I upload images or videos from URLs into the social media library?”
“How many media URLs can I upload in one batch, and which formats work?”
Tell an agent
Upload media {media_urls} to the social library for business {businessNumber} with key {apiKey}.
Queue image URLs {media_urls} into folder {folder_id} for business {businessNumber}.
GET /v1/social/post/public/media/track/{batch_id} Check a media upload batch's status · Track Social Media Upload #
Ask an LLM
“Has my media upload batch finished processing?”
“Where do I get asset IDs for uploaded media to attach to a post?”
Tell an agent
Track media upload batch {batch_id}.
Check the status of upload batch {batch_id} for business {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-social-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/json-schema/birdeye-apiary-track-social-media-upload-response200-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/json-schema/birdeye-apiary-upload-social-media-request-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/json-schema/birdeye-apiary-upload-social-media-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-social-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-social-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Birdeye Social API
  version: '1.0'
  description: 'Operations tagged Social 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 (37 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/birdeye/refs/heads/main/openapi/birdeye-social-api-openapi.yml