The TikTok videos that outperform, for your agent or your app
Search a TikTok video base refreshed every day. Each video comes measured: its views against the creator's usual views, shares per 1,000 views, and the view history we recorded. One key, plugged into Claude, Cursor or your code. $0.005 a call, $1.00 of credit free to start.
Install
Give it to your agent
Create a key in Settings > API & MCP, replace vf_live_YOUR_KEY, paste, done.
claude mcp add --transport http viewlify https://viewlify.app/api/mcp \
--header "Authorization: Bearer vf_live_YOUR_KEY"One command in your terminal. Add --scope user to use it in every project.
Then paste this prompt
Use Viewlify to find the skincare TikTok videos from the last 30 days that beat their creator's usual views by the widest margin. For the top 10, show the multiple, shares per 1,000 views and how fast the views grew, then tell me what the hooks and hashtags have in common.Or from the command line
npx viewlify login
npx viewlify search "skincare" --sort outlier --limit 5
npx viewlify balance
npx viewlify topup 10Top up from your terminal
Your agent can check the balance and get a payment link itself. Tell Claude “top up my Viewlify credits by $10”: the MCP tools get_balance and top_up return the balance and a Stripe link to click. When the credit runs out, every call answers 402 with the balance and a link that pays directly.
# balance in dollars, calls left, usage per day
curl https://viewlify.app/api/v1/balance -H "Authorization: Bearer vf_live_YOUR_KEY"
# returns { "checkout_url": "https://checkout.stripe.com/..." } to open and pay
curl -X POST https://viewlify.app/api/v1/topup -d '{"amount":10}' \
-H "Authorization: Bearer vf_live_YOUR_KEY" -H "Content-Type: application/json"What a call returns
Not just views: how far above normal
A million views means little on an account that always gets a million. Every video is measured against its own creator, the method behind our 2026 study of 38,455 videos.
vsUsualViews divided by the creator's usual views (the median of their other videos in the base). 3 or more is a breakout. It is what separates a hit from a big account's routine post.
viewHistoryThe view count at each scan, one point per day, when we scanned the video more than once. You see whether it took off in a day or kept climbing for weeks.
sharesPer1kShares for every 1,000 views. In our data, a video at twice its creator's usual share rate is in their top fifth: the clearest sign people sent it on.
viewsPerDayViews per day since publication, the speed the default trending sort is built on, with hashtags, sound, likes, comments and engagement rate.
Example response (trimmed, illustrative numbers)
{
"query": "skincare",
"sort": "outlier",
"days": 30,
"matches": 41,
"videos": [
{
"url": "https://www.tiktok.com/@example.creator/video/7561…",
"handle": "example.creator",
"caption": "the 3 step routine my derm told me to stop overcomplicating",
"publishedAt": "2026-10-21T17:04:00Z",
"views": 1840000,
"likes": 212000,
"shares": 31400,
"vsUsual": 23.6,
"creatorUsualViews": 78000,
"sharesPer1k": 17.07,
"viewsPerDay": 122667,
"tooEarlyToJudge": false,
"viewHistory": [
{ "date": "2026-10-23", "views": 412000 },
{ "date": "2026-10-28", "views": 1350000 },
{ "date": "2026-11-04", "views": 1840000 }
],
"hashtags": ["skincare", "skincareroutine", "dermatologist"],
"sound": "original sound - example.creator"
}
],
"hashtags": [{ "tag": "skincareroutine", "count": 17 }],
"usage": { "billing": "credit", "charged_usd": 0.005, "balance_usd": 0.87 }
}Endpoints
Everything the key opens
Read-only. Same data over REST and MCP, JSON out.
Viewlify's video base
GET /api/v1/trending/search?q=&sort=&niche=&days=&limit=MCP: search_trending_videosSearch every video in the base by keyword, @creator or #hashtag. Sort by trending, outlier, views, recent, engagement or shares; filter by niche and period; up to 50 videos a call, plus the hashtags recurring among the matches.
GET /api/v1/outliers?search=&limit=MCP: get_outliersThe breakouts: videos at 3x or more their creator's usual views, with the multiple and the baseline.
MCP: get_trending, get_trending_hashtagsWhat is gaining views fastest right now, by niche, with its hashtags and sounds. MCP only, works without a key.
Your own Viewlify data
GET /api/v1/accountsMCP: list_my_accountsThe accounts you track: followers, 7 and 30 day change, usual views per video.
GET /api/v1/accounts/{handle}/growth?days=90MCP: get_account_growthDaily followers, likes and video count of a tracked account.
GET /api/v1/accounts/{handle}/videos?limit=50MCP: get_account_videosEvery analyzed video with views, likes, comments, shares and its multiple over the account's usual views.
GET /api/v1/nicheMCP: get_my_niche_watchYour niche keywords and the videos breaking out on each.
GET /api/v1/diagnoses?limit=20MCP: get_my_video_checksYour AI video checks: a score out of 100, six axes, what held the video back and the fixes.
Pricing
Pay per call, or take a plan
Pay as you go
Any account, no subscription. Prepaid credit in dollars, valid 12 months.
$0.005 per call
$5 for 1,000 calls, up to 50 videos each. $1.00 of credit free when you sign up (200 calls).
Top up
One-time payment by card, Apple Pay or Google Pay. +10% credit from $50. No sign-up yet? You create your account first, then pay.
Included in a plan
The API comes with the app: analyses, tracking, AI video checks.
Pro
1,000 searches a day included
$69/mo
Agency
5,000 searches a day included
$299/mo
Past the daily searches, calls use your credit if you have some.
See all plansQuestions
Where does the data come from?
From public TikTok data. Viewlify scans the public profiles and videos its users analyze and track, plus a daily feed of popular videos, and keeps one row per video with its latest counts. Videos seen in several scans also get a view history. Nothing private: no audience, watch time or account owner data.
How fresh is it?
The base grows and refreshes every day: tracked accounts are rescanned when they post and again 48 hours later, and new popular videos are added daily. Each video says when it was published, and its view history shows when we read it.
Is this a live TikTok scraper?
No. It searches Viewlify's own base, so a call answers in well under a second and never fails on a TikTok block. If you need any profile live, right now, a raw scraper is the right tool. If you want the videos that outperform, already measured against their creator's usual views, this is.
How much does it cost?
$0.005 per call ($5 for 1,000 calls), from a prepaid credit in dollars. Every account gets $1.00 free (200 calls). Top up $5, $10, $25, $50 or $100 (+10% credit from $50); credit lasts 12 months. Pro ($69/month) and Agency ($299/month) include 1,000 and 5,000 searches a day, then use the credit.
How do I get a key?
Sign in, then create one in Settings > API & MCP. Any account can, free plan included. The three public MCP tools (get_trending, get_outliers, get_trending_hashtags) also answer without a key, as a 5-result preview.
What happens when my credit runs out?
The call answers 402 with your balance, the cost of a call and a payment link that tops up your account directly, so an agent can hand it to you. Nothing is charged automatically: you only pay when you top up.
What are the limits?
60 calls a minute per key, up to 50 videos per call. Over the minute limit the API answers 429 with a Retry-After header. A call that fails (bad parameters, limit, server busy) is not charged.
Can I get a refund on credit?
Credit is not refundable, except if we charged you by mistake: write to contact@viewlify.app. Unused credit expires 12 months after the top-up. Full terms in section 9 of our terms of service.
Can I resell the data?
Use it in your own product, agent or analysis. Reselling or republishing the raw dataset is not allowed (terms of service, section 9). Write to contact@viewlify.app if you need a data licence.