explaingit

guasi18587278913/creator-breakout-finder

Analysis updated 2026-07-25

0PythonAudience · researcherComplexity · 2/5Setup · moderate

TLDR

A tool that analyzes social media profiles to find posts that performed unusually well compared to a creator's own typical baseline, rather than just looking at raw view or like counts.

Mindmap

mindmap
  root((repo))
    What it does
      Finds standout posts
      Compares to creator baseline
      Exports reports
    Supported platforms
      Xiaohongshu
      Douyin
      Bilibili and TikTok
      YouTube and X
    How it works
      Uses TikHub API
      Likes or views metric
      Three breakout conditions
    Use cases
      Creator research
      Content analysis
      Offline demos
    Security
      Local API keys only
      Rejects bad URLs
      No raw data saved

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Find which posts from a creator performed unusually well relative to their own baseline.

USE CASE 2

Compare content performance across six major social media platforms using a consistent method.

USE CASE 3

Export a research report and raw data for deeper analysis of breakout content.

USE CASE 4

Try the full workflow offline with built-in demo data before connecting an API key.

What is it built with?

PythonMarkdownCSV

How does it compare?

guasi18587278913/creator-breakout-finder0xallam/my-recipe0xhassaan/nn-from-scratch
Stars00
LanguagePythonPythonPython
Last pushed2022-11-22
MaintenanceDormant
Setup difficultymoderatemoderatemoderate
Complexity2/52/54/5
Audienceresearchergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 5min

Requires a TikHub API key for live data, but ships with fully offline demo data so you can try it instantly without one.

In plain English

Creator Breakout Finder is a tool for anyone who studies social media accounts and wants to know which posts performed unusually well, not just which ones had the highest raw numbers. When you are comparing accounts, the real question is which posts stood out relative to that creator's own typical performance. This tool answers that by reading a creator's recent public posts and comparing each one against their own baseline, so you are not comparing a small account against a massive one. You paste a profile URL from one of six supported platforms: Xiaohongshu, Douyin, Bilibili, TikTok, YouTube, or X. The tool fetches recent public posts using the user's own TikHub API key. For most platforms it looks at likes, and for Bilibili and YouTube it looks at view counts. It estimates what normal performance looks like for that specific account, then flags posts that clearly exceed that baseline. A post must meet three conditions to be flagged as a breakout: its metric must be at least double the account's historical median, it must rank in the top 10 percent of the sampled posts, and it must hit a minimum threshold of 500 views or 20 likes. Confidence is reported as low, medium, or high depending on how many posts were available. The tool exports a Markdown research report and a CSV file with all the sample data. It also ships with fully offline demo data, so you can try the entire workflow without a key. The tool deliberately rejects individual post links, short links, non-HTTPS URLs, and URLs with embedded credentials or custom ports. API keys are read only from a local environment variable, never exposed in browser forms, error messages, or exported reports. Raw API responses are kept in memory only and never written to disk. Anyone deploying this publicly must add their own authentication and rate limiting. The README is honest about limitations. The analysis is a one-time historical snapshot, not a real-time growth curve. Older posts have had more time to accumulate views and likes, so results are best used as a starting point for deeper research, not as proof of why something went viral.

Copy-paste prompts

Prompt 1
Using the Creator Breakout Finder tool, fetch recent posts for this YouTube profile URL and show me which videos are flagged as breakouts: [paste URL here]
Prompt 2
Run the Creator Breakout Finder offline demo and show me an example Markdown report so I can understand the output format before using my own API key.
Prompt 3
Using Creator Breakout Finder, analyze this TikTok profile URL and tell me which posts had at least double the creator's median likes, ranked in the top 10 percent: [paste URL here]
Prompt 4
I have a TikHub API key set up. Use Creator Breakout Finder to pull posts from this Bilibili profile and export the results as a CSV file: [paste URL here]

Frequently asked questions

What is creator-breakout-finder?

A tool that analyzes social media profiles to find posts that performed unusually well compared to a creator's own typical baseline, rather than just looking at raw view or like counts.

What language is creator-breakout-finder written in?

Mainly Python. The stack also includes Python, Markdown, CSV.

How hard is creator-breakout-finder to set up?

Setup difficulty is rated moderate, with roughly 5min to a first successful run.

Who is creator-breakout-finder for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.