Skip to content
reelspanDocs

Media and analytics

Competitors

Follow public YouTube, Bluesky and Mastodon accounts and track their followers, posts and views over time.

GETapi.reelspan.com/v1/competitorsTry it →

Follow other accounts, a rival brand, a creator in your niche, a partner, and see how fast they grow next to you. They don't connect anything and don't know: Reelspan reads the numbers their network shows publicly, once a day, and keeps each day's reading.

Networks

Network Numbers How to name the account
YouTube Subscribers (unless the channel hides them), views, videos youtube.com/@name, youtube.com/channel/UC…, or the handle with platform: youtube
Bluesky Followers, following, posts bsky.app/profile/name.bsky.social, or the handle with platform: bluesky
Mastodon Followers, following, posts mastodon.social/@name, or @name@server

Other networks don't let apps read other accounts' numbers without an approval Reelspan doesn't have, or at all: X charges for it, Instagram and Facebook need Meta's approval for public account data, TikTok needs its Research API, and Threads, LinkedIn and Pinterest have no way to do it. Adding one of their links answers 400 with error_code: UNSUPPORTED_NETWORK and the reason.

YouTube channels are read with the server's YouTube API key, or, on servers without one, through a YouTube account connected to any of your profiles.

How many

Plan Accounts followed
Free 3
Starter 10
Pro 25
Agency 50
Scale 100

Past the allowance the call answers 403 with error_code: COMPETITOR_LIMIT_REACHED.

Follow an account

curl -X POST https://api.reelspan.com/v1/competitors \
  -H "Authorization: Bearer $REELSPAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account": "https://www.youtube.com/@rivaltv"}'

Today's numbers are read at once. A bare handle needs the network: {"account": "rival", "platform": "bluesky"}.

List them, with growth

GET /v1/competitors gives every followed account with its latest numbers and the change over the last 7 and 30 days. A change is null until that many days have been kept.

{
  "success": true,
  "limit": 10,
  "networks": ["youtube", "bluesky", "mastodon"],
  "competitors": [
    {
      "id": "cmp_7Hd1…",
      "platform": "youtube",
      "handle": "@rivaltv",
      "display_name": "Rival TV",
      "avatar_url": "https://yt3.ggpht.com/…",
      "url": "https://www.youtube.com/@rivaltv",
      "metrics": { "followers": 51200, "views": 9340000, "posts": 412 },
      "change": { "followers": { "d7": 830, "d30": 3120 }, "views": { "d7": 210000, "d30": null }, "posts": { "d7": 3, "d30": null } },
      "last_checked_at": "2026-11-17T04:00:12.000Z",
      "last_error": null,
      "created_at": "2026-10-25T09:14:00.000Z"
    }
  ]
}

last_error says in plain words when the last daily reading failed (the network didn't answer, the account was deleted); the account stays followed and is read again the next day.

History

GET /v1/competitors/{id}/history?days=90 gives one reading per day, oldest first (up to 365 days). Days with no reading are left out.

curl "https://api.reelspan.com/v1/competitors/cmp_7Hd1…/history?days=90" \
  -H "Authorization: Bearer $REELSPAN_API_KEY"

Stop following

DELETE /v1/competitors/{id} removes the account and its kept numbers.

GETapi.reelspan.com/v1/competitorsTry it →

Responses

200 Followed accounts

{
  "success": true,
  "competitors": [
    {
      "id": "string",
      "platform": "youtube",
      "handle": "string",
      "display_name": "string",
      "avatar_url": "string",
      "url": "string",
      "metrics": {},
      "change": {},
      "last_checked_at": "string",
      "last_error": "string",
      "created_at": "string"
    }
  ],
  "limit": 0,
  "networks": [
    "string"
  ]
}
POSTapi.reelspan.com/v1/competitorsTry it →

Request body

application/json

  • accountstringrequired

    A link (youtube.com/@name, bsky.app/profile/name.bsky.social, mastodon.social/@name) or a handle

  • platformstring

    youtube, bluesky or mastodon: needed for a bare handle

Responses

201 Following

{
  "success": true,
  "competitor": {
    "id": "string",
    "platform": "youtube",
    "handle": "string",
    "display_name": "string",
    "avatar_url": "string",
    "url": "string",
    "metrics": {},
    "change": {},
    "last_checked_at": "string",
    "last_error": "string",
    "created_at": "string"
  }
}

400 Not a supported account (`UNSUPPORTED_NETWORK`, `INVALID_ACCOUNT`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

403 Your plan’s allowance is used (`COMPETITOR_LIMIT_REACHED`)

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
GETapi.reelspan.com/v1/competitors/{id}/historyTry it →

Parameters

  • idstring · pathrequired
  • daysstring · query

    1 to 365, default 30

Responses

200 Daily numbers, oldest first

{
  "success": true,
  "competitor": {
    "id": "string",
    "platform": "youtube",
    "handle": "string",
    "display_name": "string",
    "avatar_url": "string",
    "url": "string",
    "metrics": {},
    "change": {},
    "last_checked_at": "string",
    "last_error": "string",
    "created_at": "string"
  },
  "history": [
    {
      "date": "string",
      "metrics": {}
    }
  ]
}

404 Not followed

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}
DELETEapi.reelspan.com/v1/competitors/{id}Try it →

Parameters

  • idstring · pathrequired

Responses

200 Removed

{
  "success": true,
  "id": "string"
}

404 Not followed

{
  "success": false,
  "message": "string",
  "error": "string",
  "error_code": "string"
}

Something unclear or missing? Write to [email protected] and we’ll fix the page.