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"}'const { competitor } = await reelspan.request('POST', '/v1/competitors', { json: { account: 'https://www.youtube.com/@rivaltv' } });competitor = reelspan.request("POST", "/v1/competitors", json={"account": "https://www.youtube.com/@rivaltv"})["competitor"]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"{
"success": true,
"competitor": { "id": "cmp_7Hd1…", "platform": "youtube", "handle": "@rivaltv" },
"history": [
{ "date": "2026-10-25", "metrics": { "followers": 48080, "views": 9010000, "posts": 405 } },
{ "date": "2026-10-26", "metrics": { "followers": 48190, "views": 9024000, "posts": 405 } }
]
}Stop following
DELETE /v1/competitors/{id} removes the account and its kept numbers.