获取 Threads 帖子 API

价格

$0.0045 / 条帖子

每次运行结果数

10 默认 · 最多 100

账单

只对实际返回的结果计费，失败的运行不收调用费。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里，以及如何使用你的 API 密钥。

Use the Lovely Router data tool "获取 Threads 帖子" (id `threads-posts`, Threads) to get data for me. It returns JSON.

- Docs (read first): https://lovelyrouter.com/docs/tools/run.md and https://lovelyrouter.com/docs/api/tools.md
- Input fields and price: GET https://lovelyrouter.com/v1/tools/threads-posts (public, no key needed). Price: $0.0045 / post.
- Run: POST https://lovelyrouter.com/v1/tools/threads-posts/run with a body like `{"input":{"mode":"posts","usernames":["zuck"],"maxItems":10},"max_results":10}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up (up to 100 per run).
- If you support MCP, you can instead connect the server https://lovelyrouter.com/mcp (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool with tool "threads-posts".
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <describe the data you need, e.g. which places, profiles, keywords or URLs, and the output format>

输入

modestring必填

Posts — an account's own posts, as many as you ask for. Replies / Reposts — what an account answered or boosted. Profile — followers, bio, links and contacts. Search — public posts for keywords and hashtags. Thread — one post with its replies. Accounts — people and brands matching a keyword.

posts · replies · reposts · profile · search · thread · users

usernamesarray

For Posts, Replies, Reposts and Profile. Bare name, with @, or the profile URL: zuck, @natgeo, https://www.threads.net/@nasa.

keywordsarray

For Search and Accounts. AI agents, #nba, coffee roaster brooklyn. The # is optional.

postUrlsarray

For Thread mode: https://www.threads.net/@zuck/post/Dcy_A8pGo-m. Share links from the app (https://www.threads.com/share/CODE) work too. In Posts mode these are fetched too.

postedAfterstring

YYYY-MM-DD. Older posts are dropped and Posts mode stops paging once it reaches them.

postedBeforestring

YYYY-MM-DD. Newer posts are dropped. Together with Posted after this gives a date window, so a scheduled run never re-collects yesterday's posts.

maxItemsinteger

Stop after this many rows in the run.

试一试

输入（JSON）

最多结果数

最多花费 $0.045

注册后运行

在代码中调用

了解运行、轮询与计费 →

curl https://lovelyrouter.com/v1/tools/threads-posts/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input":{"mode":"posts","usernames":["zuck"],"maxItems":10},"max_results":10}'

# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
  "tool": "threads-posts",
  "input": {"mode":"posts","usernames":["zuck"],"maxItems":10},
  "max_results": 10
})

费用示例

结果	运行次数（每次最多 100 条）	成本
100	1	$0.45
1,000	10	$4.50
10,000	100	$45.00

预付费，无需订阅。返回的结果少于请求数量时费用更低。价格

适用场景

社媒监听 Monitor Reddit for brand and category mentions with an API Monitor public Telegram channels for announcements and news Track brand and keyword conversations on Threads

常见问题