viralcatcher

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

  1. Open Customize, then Connectors. Choose + Add, then Add custom connector.
  2. Name it ViralCatcher, paste the address, then choose Add.
  3. Sign in to ViralCatcher when Claude asks, and choose Allow.
  4. In a chat, open + then Connectors and turn ViralCatcher on.

ChatGPT

Needs a ChatGPT Business or Enterprise plan.

  1. Open Plugins. Choose + then Add custom MCP server.
  2. Name it ViralCatcher and paste the address under Connection.
  3. Choose OAuth, then Create.
  4. 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

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
/trendsWeek 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.
/videosVideos 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.
/creatorsCreators already selling products like yours, with their best video in that slice.
/creators/{handle}One creator: followers over time and their recent videos.
/productsThe 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/competitorsYour own Competitor Alerts: the creators and products you track, and what they posted since.
/meYour 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

Questions? Write to us from the app: the chat button at the bottom right of any page.