TikTok Competitor Analysis API
See which TikToks are breaking out in your niche, and why
Name your competitors, keywords and hashtags once. Every day postpeg ranks their new videos by outlier score (views ÷ the creator’s median views) and breaks down the best ones: the hook, the format, the call to action, and why it worked. From your code, or from an AI agent over MCP.
{
"data": [
{
"id": "7429108866120059158",
"author": {
"handle": "smallbatchroaster"
},
"views": 412000,
"author_median_views": 9800,
"outlier_score": 42,
"source": "competitor",
"matched": "smallbatchroaster",
"slides": 7,
"format": "list"
}
],
"refreshed_at": "2026-09-30T04:12:09Z",
"warnings": []
}Why outlier score beats raw views
A big account’s ordinary day tops any “most viewed” list and tells you nothing. A small account whose video did 40 times its usual has found something repeatable. postpeg divides each video’s views by its creator’s median over their recent videos, so the breakouts rise to the top whatever the account’s size.
Filter by where a video was found (competitor, keyword or hashtag) and by how recent it is.
Why it worked, in fields you can use
POST /v1/tiktok/breakdowns reads a video’s transcript and caption and returns the hook from its first 3 seconds, hook_type, format, call_to_action, length and 2–4 plain reasons. Structured, so your app or agent can compare patterns across a niche. Try it on one video with the free hook analyzer.
Write your version, then pick the hour
POST /v1/tiktok/scripts takes a breakdown (or just a topic) and writes your version: a hook, the beats after it, a call to action and a caption with hashtags, in the same format and length, in your brand’s voice and language. Plans include 10 on the trial, 100 on Starter, 500 on Pro, 1,500 on Scale scripts a month, and a failed attempt isn’t counted.
No time to film? POST /v1/tiktok/carousels turns the same breakdown or topic into a photo carousel: 4 to 10 slides styled after what the niche saves on Pinterest, with the words set by postpeg so each one is exact and editable. Plans include 3 on the trial, 5 on Starter, 20 on Pro, 45 on Scale carousels a month, counted when one is ready.
GET /v1/tiktok/niches/{id}/best-times answers when to post: the hours at which the niche’s over-performing videos of the last 30 days went up, in the time zone you ask for. It reads the niche, not your own account, and flags low_data until there are about 30 videos to go on.
Set up a niche in one call, or from a website
Create a niche with up to 10 competitors, 3 keywords and 3 hashtags. Or send a website or App Store link to POST /v1/tiktok/onboarding/suggest and postpeg proposes niches, keywords, hashtags and real competitor accounts, in the brand’s own language. Niches per plan: 1 on the trial, 1 on Starter, 5 on Pro, 15 on Scale.
Close the loop
Post your version with the TikTok posting API, and postpeg benchmarks it at 24 hours and 7 days against the niche. Every Monday a report sums up the week’s best videos, what they shared, and how your posts did.
Questions
- Where does the TikTok data come from?
- Public TikTok data (profiles, videos, search, hashtags and transcripts) collected by postpeg’s data partner and refreshed daily. postpeg never needs access to your competitors’ accounts.
- Does it work with Claude, ChatGPT and other agents?
- Yes. The MCP server exposes list_niches, create_niche, find_top_tiktoks, break_down_tiktok, write_tiktok_script, make_tiktok_carousel, best_times_to_post and benchmark_post, so an agent can find the breakouts, explain them, write your version or make it a carousel, and suggest when to post from one prompt.
- Can it tell me the best time to post?
- Yes, for a niche. It reads when the niche’s over-performing videos of the last 30 days were posted, in your time zone. It is based on the niche, not your own posting history, and says so when there are too few videos to trust.
- Which languages and countries does it cover?
- Any language TikTok has. Keywords and hashtags are searched as you write them, and breakdowns are written in the video’s own language.
- What happens at my plan’s limit?
- The call answers
402 limit_reachedand nothing is charged; there are no overage fees. After a downgrade the oldest niches keep refreshing and the rest pause.
More for TikTok
Send your first post in a few minutes
The 7-day trial has every feature and 3 connected accounts, with no card. It also posts to Instagram, YouTube, LinkedIn and more through your own Zernio account (its first 2 accounts are free). On TikTok, postpeg also shows what’s working in your niche: TikTok growth.