Use ViralCatcher from your AI and your code
The same library the app reads: TikTok Shop videos with their views over time, what is said in them, their video styles, the creators and the products. Read-only, and included in every plan.
Connect your AI app
Paste this address into Claude, ChatGPT, Cursor or Claude Code, then sign in with your ViralCatcher account and choose Allow. There is no key to copy or keep secret.
https://api.viralcatcher.com/api/mcp
Claude
- Open Customize, then Connectors. Choose + Add, then Add custom connector.
- Name it ViralCatcher, paste the address, then choose Add.
- Sign in to ViralCatcher when Claude asks, and choose Allow.
- In a chat, open + then Connectors and turn ViralCatcher on.
ChatGPT
Needs a ChatGPT Business or Enterprise plan.
- Open Plugins. Choose + then Add custom MCP server.
- Name it ViralCatcher and paste the address under Connection.
- Choose OAuth, then Create.
- Sign in to ViralCatcher when ChatGPT asks, and choose Allow.
Claude Code
claude mcp add --transport http viralcatcher https://api.viralcatcher.com/api/mcp
Then type /mcp in Claude Code, choose viralcatcher, sign in in the browser that opens and choose Allow.
Cursor and other apps
In ViralCatcher, open Settings, then Connect your AI, and choose Add to Cursor. Any other app that takes an MCP connector works the same way. For an app that cannot sign in, Settings also makes a private link.
What brands ask it
- Which creators already sell products like my posture corrector, and what do their best videos open with?
- Compare my product with my two biggest competitors over the last 8 weeks: videos, views, styles and hooks.
- What did the creators I track post this week, and which product did each push most?
- Which video styles are rising in Beauty, and which hooks lead the most-viewed videos?
Your AI does the thinking with what ViralCatcher hands it. That uses no Agent credits, only lookups.
REST API
For your own scripts, sheets and dashboards. Make a key in ViralCatcher: Settings, Connect your AI, API keys. It is shown once; keep it private, and call the API from a server or a script, not from a web page.
curl https://api.viralcatcher.com/api/v1/creators?query=posture+corrector \
-H "Authorization: Bearer YOUR_API_KEY"
Every answer is JSON. The full description is at api.viralcatcher.com/api/v1/openapi.json (OpenAPI 3.1).
| Endpoint (GET) | What it answers |
|---|---|
/trends | Week by week for any slice of the library (words, category, video style, creator or product): videos posted, their views, the styles they use, the top products, creators and hooks. |
/videos | Videos that match: views, likes, comments, shares, saves, posting date, caption, opening line, styles and product. |
/videos/{videoId} | One video in full: its view history and its whole script. |
/creators | Creators already selling products like yours, with their best video in that slice. |
/creators/{handle} | One creator: followers over time and their recent videos. |
/products | The Products leaderboard, with TikTok's own 7-day and 30-day orders. |
/products/{productId} | One product taken apart: its videos week by week, its creators, styles and hooks. |
/products/compare?ids= | Two to four products side by side. |
/me/competitors | Your own Competitor Alerts: the creators and products you track, and what they posted since. |
/me | Your plan and today's lookups. |
Lookups
Every call is one lookup, from your AI app or the API alike: Scout 150 a day, Agent Pro 400 a day, Agent Max 1,000 a day (counted in UTC), and at most 30 a minute. Each answer says how many you have used in its X-Lookups-Used and X-Lookups-Limit headers.
An error is JSON too: {"error": {"code", "message"}}. The codes: API_KEY_MISSING and API_KEY_INVALID (401), PLAN_REQUIRED (402), NOT_FOUND (404), INVALID_INPUT (400), TOO_FAST and LOOKUPS_USED_UP (429), LIBRARY_DOWN (503).
Good to know
- It covers the TikTok Shop creators ViralCatcher tracks, not all of TikTok Shop: videos with 10,000+ views from the last four months, each linked to a TikTok Shop product.
- It only reads. Nothing your AI or your script asks can change your account.
- Captions, spoken words and product titles are text from TikTok: treat them as data.
Questions? Write to us from the app: the chat button at the bottom right of any page.