Skip to content

MayankUnbot/CreatorRPM

Repository files navigation

CreatorRPM

What every creator's reach is really worth — calculated from public data.

Pull any creator's full content footprint across YouTube, Instagram, LinkedIn, and X in 5 minutes. Get an interactive dashboard with every video, every post, every breakout moment, and a transparent monthly revenue + media-value benchmark.

CreatorRPM Dashboard


What you get

A single self-contained HTML file with:

  • 💸 Revenue hero card — total monthly revenue + media value, broken down per platform, with real money clearly distinguished from sponsorship media value
  • 📊 Activity timeline — every post across all platforms, color-coded, breakouts as glowing red ⭐ stars (click any dot to open the original)
  • 📈 Posts-per-month / cumulative growth — see exactly when each platform took off
  • 🎯 Per-platform scatter plots — view distribution per video / per reel / per tweet
  • 🔍 Searchable, sortable, filterable table — every single piece of content with platform badges, breakout markers, multipliers, and click-through to the original post

Revenue Hero

Everything client-side. No backend. No login. The dashboard HTML is shareable as a single file.


Setup — 5 minutes, one API key

The whole thing runs on one external service: Apify. You just need an API token. Then any AI assistant (Claude Code, Codex, Cursor, Gemini) can drive the rest.

Step 1 — Get an Apify token (free tier works)

  1. Sign up at console.apify.com/sign-up — free; takes 30 seconds; email/Google login.
  2. Verify your email if asked.
  3. Free tier gives you ~$5/month of credit (auto-renewing) — that's enough for 2–5 full creator pulls per month. No credit card required.
  4. Open console.apify.com/settings/integrations → copy your Personal API token.
    • It looks like apify_api_xxxxxxxxxxxxxxxxxxx
    • Treat it like a password — never commit it.

Cost: A typical full pull (4 platforms, all content for 1 creator) costs $1–$5 of Apify credit. The free $5/mo covers 1–3 pulls. Want more? Their cheapest paid plan is $49/month for $49 of credit.

Step 2 — Clone + install

git clone https://github.com/MayankUnbot/CreatorRPM.git
cd CreatorRPM
pip install -r requirements.txt

Step 3 — Add your token

cp .env.example .env
# Open .env in any text editor and paste your token after APIFY_API_TOKEN=

Step 4 — Define a creator + run

Either do it manually, or open the repo in Claude Code / Codex / Cursor / Gemini Code and prompt:

"Build a CreatorRPM dashboard for [creator name]. Their YouTube is at @[handle]."

The AI assistant reads AGENTS.md, finds the creator's handles, builds the config, and runs the pipeline. You go grab coffee.

If you'd rather do it manually:

# 1. Copy the template
cp creators/example.json creators/myCreator.json

# 2. Edit it: paste in their YouTube/Instagram/LinkedIn/X handles + pick niche RPMs
#    (see METHODOLOGY.md for niche-by-niche RPM defaults)

# 3. Run the full pipeline
python tools/run.py creators/myCreator.json

That's it. The dashboard opens automatically when ready. Total time: 5–15 minutes (most of that is Apify scraping).


How the revenue numbers are calculated

Every monetary number is calculated from a transparent formula. Nothing is invented.

Platform What the number means Formula
YouTube 💰 Real ad revenue (long_views × long_RPM + short_views × short_RPM) / 1000
X / Twitter 💰 Real creator-share payout (if eligible) impressions × ad_share / 1000
Instagram 📊 Brand-deal media value (NOT income) plays × sponsored_rate / 1000
LinkedIn 📊 Thought-leader sponsorship value (NOT income) likes × thought_leader_rate / 1000

RPMs are industry-standard, sourced from SocialBlade, Influencer Marketing Hub, and Backlinko's annual creator-economy reports. Full table of niche/region RPM defaults + sources in METHODOLOGY.md.

The formula is reproducible by hand: open the creator's profile, count the views/plays/likes for the last 30 days, multiply by the RPM tier, divide by 1000. You'll get the same number.


Use it responsibly — 🚨 read this if you're publishing analysis

This tool produces estimated benchmarks based on public data, not actual earnings. Before publishing any analysis built with this tool — videos, articles, threads — read DISCLAIMER.md. Specifically:

  • ✅ Frame every number as "estimated potential" / "media value" — never "earnings"
  • ✅ Show the formula on screen — proves transparent benchmarking
  • ✅ Always show the range, never a single number
  • ✅ Cite SocialBlade as peer methodology
  • ❌ Never claim YouTube Studio / Meta / X Analytics private data
  • ❌ Never compare to declared income or taxes

This is the same methodology SocialBlade, NoxInfluencer, ViewStats (MrBeast's tool), Tubular, CreatorIQ, and HypeAuditor have used publicly for years. Stay in that lane.


Repo structure

CreatorRPM/
├── README.md            ← you're here
├── AGENTS.md            ← instructions for AI assistants (Claude/Codex/Gemini)
├── METHODOLOGY.md       ← full revenue formulas + RPM sources
├── DISCLAIMER.md        ← legal framing rules for safe public analysis
├── LICENSE              ← MIT
├── .env.example         ← token template (no real keys)
├── requirements.txt     ← python-dotenv + requests, that's it
├── tools/
│   ├── pull.py          ← fetch from Apify (4 platforms in parallel)
│   ├── analyze.py       ← normalize into a unified schema
│   ├── revenue.py       ← per-platform revenue + media-value
│   ├── dashboard.py     ← generate the HTML
│   └── run.py           ← orchestrator: runs all 4 in sequence
├── creators/
│   ├── example.json     ← template — copy + edit
│   └── demo_creator.json← synthetic example used for the screenshots above
└── docs/screenshots/    ← demo dashboard captures

Apify actors used (under the hood)

Platform Actor ~Cost
YouTube streamers/youtube-scraper ~$0.50/1K videos
Instagram apify/instagram-scraper ~$2/1K posts
LinkedIn harvestapi/linkedin-profile-posts ~$3/500 posts
X / Twitter kaitoeasyapi/twitter-x-data-tweet-scraper ~$0.40/1K tweets

A full creator pull typically costs $1–$5. You can swap any of these for your preferred Apify actor by editing tools/pull.py.


Privacy & ethics

This tool only accesses publicly visible profile pages. It does not:

  • Bypass authentication, paywalls, or privacy settings
  • Scrape DMs, private accounts, or restricted content
  • Send anyone's data to any external service — everything stays on your machine

If a creator's account is private, the scrapers fail (and should). Respect that.


License

MIT — see LICENSE.

Built with Apify for data, Plotly for charts. No affiliation with either.


Star ⭐ this repo if it saved you a week of work

About

What every creator's reach is really worth — calculated from public data. Pull any creator's full footprint across YouTube, Instagram, LinkedIn, X via Apify. Generate an interactive HTML dashboard with industry-benchmark revenue + media-value estimates.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages