X（Twitter）の投稿を検索 API

Q: これはツイート 取得 APIですか？

はい。ツイート 取得 API、X 検索 スクレイパー、Twitter 高度な検索 APIをお探しなら、これです：検索語・ハッシュタグ・指定アカウントに一致するツイート：本文、投稿者、エンゲージメント、日付。

価格

$0.000388 / ツイート

1 回あたりの件数

20 既定 · 最大 500

請求

返された結果分のみ課金。失敗した実行には呼び出し料金がかかりません。

AI エージェントに任せる

このプロンプトを Claude Code、Cursor、Codex などのコーディングエージェントに貼り付けてください。ドキュメントの場所と API キーの使い方をエージェントに伝えます。

Use the Lovely Router data tool "X（Twitter）の投稿を検索" (id `x-search`, X (Twitter)) 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/x-search (public, no key needed). Price: $0.000388 / tweet.
- Run: POST https://lovelyrouter.com/v1/tools/x-search/run with a body like `{"input":{"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},"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 500 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 "x-search".
- 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>

入力

searchTermsstring[]

One query per entry, written like X's search box; combine operators with spaces, OR and parentheses. Words and "exact phrase"; a OR b; -word / -"phrase" to exclude; #hashtag; @mention; $cashtag; from:user, to:user (replies to them), -from:user; lang:en; since:2026-10-01 / until:2026-10-15 (UTC dates); min_faves:100, min_retweets:20, min_replies:5; filter:replies or -filter:replies; filter:media, filter:images, filter:videos, filter:links (prefix - to exclude); -filter:retweets; url:example.com; conversation_id:; list:. X API-only operators (is:retweet, has:media, place:) are not applied: use the filter: forms. Example: "gemini argon" min_faves:50 -filter:replies since:2026-10-01 lang:en

maxItemsinteger

Optional result cap across the whole run. Without a spend cap, Xquik uses its built-in default. Diagnostic rows count toward this cap. The form starts at 1,000. A run can return 100,000 rows & more, so raise it for a full export.

queryTypestring

Latest returns newest first. Top is ranked by relevance and is not exhaustive. Latest + Top returns both without duplicates and fills your limit from either. Account timelines ignore this setting.

Latest · Top · Latest + Top

langstring

Filter tweets by language using a 2-letter ISO 639-1 code. Every returned tweet matches this language.

twitterHandlesstring[]

X usernames whose posts to collect. Profile Tweets matches the Posts tab on X, with posts, reposts & the author's replies to their own posts. Add Exclude replies under Tweet type filters for original posts only. Profile With Replies keeps target-authored posts and replies. Add usernames with or without @. For example, elonmusk, @nasa.

試す

入力（JSON）

最大件数

最大費用 $0.00388

登録して実行

コードから呼び出す

実行・ポーリング・課金の仕組み →

curl https://lovelyrouter.com/v1/tools/x-search/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"input":{"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},"max_results":20}'

# MCP (agents): suggest_tools → get_tool → run_tool
run_tool({
  "tool": "x-search",
  "input": {"searchTerms":["\"gemini argon\" min_faves:50 -filter:replies since:2026-10-01 lang:en"],"maxItems":20,"queryType":"Top"},
  "max_results": 20
})

料金の目安

結果	実行回数（1 回あたり最大 500 件）	原価
100	1	$0.039
1,000	2	$0.388
10,000	20	$3.88

プリペイド、サブスクリプションなし。結果が要求より少なければ料金も下がります。料金

用途

ソーシャルリスニング Monitor news mentions of your brand or competitors Benchmark your LinkedIn content against top creators and executives 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 Track what people post about your brand on Weibo Vet X (Twitter) accounts before you sponsor, hire or partner Read the replies to an X post to see how a launch landed Monitor brand mentions on X with advanced search operators

よくある質問