Popoff.tv Data
PopOff Data connects your agent to the live PopOff.tv dataset — the social-analytics platform for reality TV.
What it can do
- List Shows: List every tracked season across all shows, with computed status (upcoming | airing | ended), air dates, episode counts, and slugs. Start here to discover what data exists.
- Get Show: Get one season's details: title, network, status, air dates, live-tracking window, episode count.
- List Episodes: List a season's episodes with air dates/timestamps and episode types.
What data it sees
Do you need an account
An API key from the service settings is required
PopOff Data connects your agent to the live PopOff.tv dataset — the social-analytics platform for reality TV. Follower counts are tracked at ~30-minute resolution across Instagram and TikTok for every cast member of every tracked season (Love Island, The Traitors, Real Housewives, and more), including archived seasons.
Your agent pulls the data; you decide what to build — season reports, charts, podcast briefs, client dashboards, CSV exports.
What's inside
- Follower time series — ~30-min resolution history for every contestant, per platform
- Growth windows — 24h / 7d / 30d / since-premiere deltas, plus Instagram milestone projections
- Follow Watch — who follows and unfollows whom inside a cast, as a graph and an event ledger
- Trend detections — surge/drop events with episode context
- Engagement rates — current, baseline, and history
- Season CSV exports — citation-ready snapshots, identical to the web export
Also included: the full API reference as a readable resource (popoff://docs/api-reference) and two prompt templates (season_social_report, contestant_deep_dive) that turn the tools into ready-made workflows.
Getting access
Sign up at popoff.tv/data — your API key (popoff_sk_…) is issued immediately after checkout. Paste it into the connection settings here, or point any MCP client at https://popoff.tv/mcp.
Data is collected and served by PopOff.tv. Please attribute published numbers to PopOff.tv.
Server tool list (12)
Raw names from tools/list. Only developers need these.
| list_shows | List every tracked season across all shows, with computed status (upcoming | airing | ended), air dates, episode counts, and slugs. Start here to discover what data exists. |
| get_show | Get one season's details: title, network, status, air dates, live-tracking window, episode count. |
| list_episodes | List a season's episodes with air dates/timestamps and episode types. |
| get_cast | Full cast of a season with per-platform follower counts, baselines, growth windows (24h/7d/30d/since premiere), elimination status, and Instagram milestone projections. Time series are summarized as historyPoints counts — use get_follower_history for the series itself. |
| get_contestant | One contestant's profile and social metrics. Pass show to scope to a season; otherwise their most recent season is used. |
| get_follower_history | Raw follower-count time series for a contestant (per platform, ~30-minute resolution). Best for charts, growth analysis, and before/after comparisons around episodes. |
| get_follow_graph | Who a contestant follows and who follows them among their castmates (Instagram), including unfollows — the data behind Follow Watch. |
| get_follow_events | Confirmed follow/unfollow events among castmates, newest first (up to 200). Filter by season and/or contestant. |
| get_trend_events | Detected follower surges and drops (trend events) with episode context — the headlines behind PopOff trend cards. |
| get_engagement | Engagement rates for a contestant's profiles: current, baseline, and 30-day history (likes/comments-based). |
| export_season_csv | The citation-ready season cast CSV (same file as the web export): identity, elimination, follower counts, growth windows, reach. Returned as CSV text. |
| get_usage | Your MCP usage this billing period: units used vs included quota, overage, and a per-tool breakdown. Not billed as a call. |