x/
mentions

対象ユーザーのハンドルをメンションした公開ポストを取得します。期間による絞り込みとエンゲージメント指標に対応しています。

Twitter Mentions API

ブランドへの言及
外部からの反応
メンションのモニタリング
結果1件あたり0.7クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Twitter Mentions

公開メンションを追跡すると、X上でのブランドの評判、顧客からの問い合わせ、外部から寄せられる会話を把握できます。正規化されたメンションレコードには、プラットフォームの認証なしで、ポスト本文、投稿者のハンドル、タイムスタンプ、添付メディア、公開エンゲージメントのカウントが記録されます。

Twitter Mentions API の主な機能

  • 公開メンションの追跡対象アカウントのログイン情報を必要とせずに、任意のユーザー名をメンションした公開ポストを取得します。
  • 期間による絞り込みISO形式の日付またはUnix秒で指定した start_date と end_date のフィルターで、メンションの取得範囲を絞り込みます。
  • 投稿者とポストの詳細ポストの全文、投稿者のプロフィール、添付メディア、パーマリンクを含む正規化ポストレコードを受け取れます。
  • エンゲージメント指標見つかった各メンションについて、いいね数、コメント数、リポスト数、引用数、ブックマーク数、表示回数を取得します。

Twitter Mentions API のパラメータ

パラメータ必須説明
usernames必須メンションを取得する対象の公開Xユーザー名の配列です。先頭の @ は付けても付けなくてもかまいません。
results_limit任意ユーザー名ごとに返すメンションの最大数です。20から2,000までの20の倍数である必要があります。
start_date任意任意。ISO形式(YYYY-MM-DD)またはUnix秒で指定する開始日時で、この日時以降のメンションに絞り込みます。
end_date任意任意。ISO形式(YYYY-MM-DD)またはUnix秒で指定する終了日時で、この日時より前のメンションに絞り込みます。

Twitter Mentions API の使い方

対象ユーザー名と任意の期間を非同期タスクとして送信し、ポーリングしてメンションレコードを取得します。

  1. usernames に1つ以上のユーザー名を指定し、results_limit を20の倍数(最大2,000)で設定します。
  2. 必要に応じて start_date と end_date を指定し、メンションの取得期間を限定します。
  3. SocQのAPIキーを付けて /v1/x/mentions に POST リクエストを送信します。
  4. /v1/tasks/{task_id} をポーリングし、next_cursor を使って data.results.items をページ送りします。
curl -X POST "https://api.socq.ai/v1/x/mentions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["@OpenAI"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}, then fetch data.results.items.

Twitter Mentions API の主なユースケース

  • ブランドの評判モニタリング: 自社アカウントのハンドルに寄せられるメンション、レビュー、感情をほぼリアルタイムで追跡します。
  • カスタマーサポートの仕分け: サポートアカウントに寄せられた未対応の顧客の苦情、製品の不具合、フィードバックを特定します。
  • 経営陣への反応のリスニング: 経営陣のアカウントに向けられたメンションや返信をモニタリングし、発表に対する業界の反応を評価します。

Twitter Mentions API 活用のヒント

  • 取得元のページサイズに合わせるため、results_limit は20の倍数(例:20、40、100)で指定してください。
  • 2026-09-01 のようなISO形式の日付文字列は、バックエンドで自動的にUTCのUnixタイムスタンプに変換されます。
  • このエンドポイントはアカウントをメンションしたポストを返します。アカウント自身が投稿したポストを取得するには X User Posts を使用してください。
  • X Post Replies と組み合わせると、重要なメンションポストから派生した会話スレッドを詳細に追跡できます。

Twitter Mentions API 以外に別の種類の公開Xデータが必要な場合は、これらのAPIをご利用ください。

  • Twitter Tweet Scraper API — x.comまたはtwitter.comのステータスURLから、公開ポストのテキスト、投稿者、エンゲージメント、メディア、ハッシュタグ、メンション、会話の関係を取得します。
  • Twitter Profile Scraper API — ユーザー名から、公開アカウントの情報、プロフィール文、アバター、カバー画像、アカウントの状態、表示中のオーディエンス統計を取得します。
  • Twitter User Tweets Scraper API — ユーザー名から、返信を除く最近の公開ポストを、投稿者、メディア、ハッシュタグ、メンション、エンゲージメントとともに取得します。
  • X Post Quotes API — 既知のステータスURLについて公開引用ポストを取得し、コメント、投稿者、エンゲージメント、メディア、タイムスタンプ、元のポストの情報を返します。
  • X Community Posts API — コミュニティで共有された公開ポストを、テキスト、投稿者、インタラクション数とともに取得します。
  • X Thread Context API — ポストと、その返信チェーンをさかのぼった過去のメッセージ、公開返信、関連IDを取得します。

他のプラットフォームを見る

Xのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Twitter Mentions API — よくある質問

Twitter Mentions APIは、X上で指定したユーザーのハンドルをメンションした公開ポストを取得するAPIです。任意の期間内で、正規化されたポストデータ、投稿者情報、タイムスタンプ、エンゲージメント指標を返します。

いいえ。このエンドポイントは公開ユーザー名のみを使って公開されているメンションを照会するため、顧客アカウントのOAuthやユーザーのログイントークンは不要です。

取得元のデータプロバイダーはメンションを20件ずつのページ単位で提供するため、リクエストもこの単位に合わせる必要があります。