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?
- 01
Search related posts
- 02
Compare daily volume
- 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 server02 · 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.
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.
- 01
Find topics and demand
Search posts, semantically similar content and keyword volume.
- 02
Study competitors and accounts
Check recent content, top posts and follower changes.
- 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.
| Tool | Returns | Limit |
|---|---|---|
| search_posts | Keyword search of public posts | 25 per call |
| get_inspiration | Ideas from high-engagement curated posts | 10 results |
| semantic_search_posts | Semantic search of the last 30 days of posts | 10 results |
| get_hot_posts | Trending posts ranking | 50 results |
| get_keyword_trend | Daily keyword volume | 10 keywords × 90 days |
| get_post_like_growth | Viral threads leaderboard | 50 results |
| get_cool_replies | Top replies leaderboard | 50 results |
| get_follower_growth | Follower growth leaderboard | 50 results |
| get_power_hours | Power hours heatmap | Last 28 days |
| get_follower_ladder | Follower ladder | Percentile |
| get_like_ladder | Like ladder | Last 24 hours |
| get_user | Profile and recent posts | 25 each |
| get_user_top_threads | A user's most-liked posts | Up to 720 days |
| get_user_follower_history | Follower count history | Up to 365 days |
| get_user_interactions | Who an account interacts with most | Up to 100 accounts, 90 days |
| forecast_posts | Viral forecast: 48-hour views and milestone odds | 10 posts per call, 1–12 h after posting |
| get_live_posts | Live post stats and images | 10 posts per call |
| get_live_users | Live follower counts and profiles | 10 accounts per call |
| get_balance | Remaining credits | Free |
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.