Throk

API · MCP

Public Threads data,in your agent and your product.

Post search, keyword trends, trending boards, accounts and follower history: plug them into Claude, ChatGPT or Cursor with MCP, or into your own service with REST. Every answer comes with numbers you can check.

One query

Throk MCP

Which brand terms heated up over the past 7 days?

  1. 01

    Search related posts

  2. 02

    Compare daily volume

  3. 03

    Write up findings you can check

Public Threads posts in Traditional and Simplified Chinese, Cantonese, English, Japanese and Korean. Keyword trends go back 90 days, follower history 365 days. From US$30/month.

AGENT IN ACTION

How does an agent use this data?

Ask a real question and watch the agent call tools, read the data back and give advice grounded in it. Below is a sample conversation.

mcp · throk

Sample data

Is job switching still worth a post on Threads right now?

⚙ get_hot_posts⚙ get_keyword_trend⚙ search_posts

Still heating up. Posts about job switching are up 3.1x over the past 7 days, and no breakout post over 50,000 likes has capped it yet:

6/07

6/09

6/11

6/13

Suggested angle: skip “I quit my job” and write what the people who stayed are thinking. 38% of high-engagement replies come from people who haven't quit and are still on the fence. They're looking for someone to speak for them.

HOW TO CONNECT

MCP or REST

MCP for agents, REST for services.

01 · THROK MCP

MCP server

Connect Claude, Cursor or any other MCP client with one command.

About the Threads MCP server

02 · REST API

REST API

Or call REST directly

THREADS API PRICING

From US$30/mo. Pick a plan by monthly credits.

All four plans include every data endpoint and MCP; Standard and above add webhooks. Throk MCP and the REST API draw on the same developer credits.

See Throk API pricing →

WHAT IT CAN ANSWER

What can your AI agent answer with Throk?

Start from the decision you need to make, then pick the Threads data for it. Tool names and query limits live in the technical reference.

  1. 01

    Find topics and demand

    Search posts, semantically similar content and keyword volume.

  2. 02

    Study competitors and accounts

    Check recent content, top posts and follower changes.

  3. 03

    Catch trends and timing

    Check trending rankings, growth leaderboards and the best times to post.

See all 19 tools and query limits+

FULL TOOL LIST

Nineteen tools, one key

Keyword and semantic search, trending and viral leaderboards, top replies and follower growth, power hours heatmaps, follower and like ladders, user profiles, follower history, live data and viral forecasts. It's all there.

ToolReturnsLimit
search_postsKeyword search of public posts25 per call
get_inspirationIdeas from high-engagement curated posts10 results
semantic_search_postsSemantic search of the last 30 days of posts10 results
get_hot_postsTrending posts ranking50 results
get_keyword_trendDaily keyword volume10 keywords × 90 days
get_post_like_growthViral threads leaderboard50 results
get_cool_repliesTop replies leaderboard50 results
get_follower_growthFollower growth leaderboard50 results
get_power_hoursPower hours heatmapLast 28 days
get_follower_ladderFollower ladderPercentile
get_like_ladderLike ladderLast 24 hours
get_userProfile and recent posts25 each
get_user_top_threadsA user's most-liked postsUp to 720 days
get_user_follower_historyFollower count historyUp to 365 days
get_user_interactionsWho an account interacts with mostUp to 100 accounts, 90 days
forecast_postsViral forecast: 48-hour views and milestone odds10 posts per call, 1–12 h after posting
get_live_postsLive post stats and images10 posts per call
get_live_usersLive follower counts and profiles10 accounts per call
get_balanceRemaining creditsFree

What you can build

What people build with it

Each one uses only existing tools and endpoints.

Brand mention dashboard

Pull daily volume for your brand terms with get_keyword_trend, and push posts that cross a threshold to your team with a webhook.

Weekly competitor report

Call get_user and follower history on a schedule or from n8n, and turn the results into a weekly report.

Creator vetting

Use the follower ladder to see where an account stands, then check who it interacts with most to see its circle.

AI writer

In Claude, look up trending posts and top replies first, then have it draft from the data.

FAQ

Are API credits the same as Throk subscription credits?
No. The developer platform has its own API plans and credits, completely separate from the Free / Creator / Creator+ web plans, and the two can't be mixed. You subscribe to an API plan in the developer console.
How is the Throk API different from Meta's official Threads API?
Meta's official Threads API is for publishing posts and managing your own account, and it requires Meta's app review. The Throk API is for querying public Threads data: post search, keyword trends, leaderboards and follower history for any public account. They do different jobs and can be used together.
Is there a free tier? How is it priced?
Plans are priced by monthly credits, from API Lite (15,000 credits/month) to Premium (6,000,000 credits/month); pick one on the developer platform. Checking your balance and usage history, and webhook test events, cost no credits.
When do credits expire?
Credits are valid for one month from purchase, and unused credits don't roll over. If you need more, upgrade or buy a one-off top-up at your plan's rate (API Standard US$10, Plus US$5, Premium US$4 per 10,000 credits). Top-ups reset when the current billing cycle ends.
MCP or REST? Which clients are supported?
Use MCP when an AI agent will do the work: Claude, ChatGPT, Codex, Cursor and other clients connect with one command. Use REST to call it straight from your own service. Every feature is available through both.
What data does it cover?
Public Threads posts: keyword search, trending rankings, keyword trends, user profiles and follower history. Posts are grouped by the language they're written in, not where the author is. Each call takes one language parameter: zh (Chinese, all), zh-Hant (Traditional Chinese), zh-Hans (Simplified Chinese), yue (Cantonese), en (English), ja (Japanese) or ko (Korean). It defaults to zh, so pass en, ja or ko to get English, Japanese or Korean posts, and make one call per language to compare them. Every search, trend, leaderboard and ladder endpoint supports all 7 languages; webhook rules support Chinese, Japanese and Korean posts. Other languages aren't covered.
How do I get started?
Sign up at developer.throk.ai, create an API key, pick a plan and start making calls. For MCP you can skip the key and sign in with your Throk account instead.

Let your agent start reading Threads.

Pick a plan and create a key on the developer platform. With MCP you can also just sign in with your Throk account.