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 の使い方
対象ユーザー名と任意の期間を非同期タスクとして送信し、ポーリングしてメンションレコードを取得します。
- usernames に1つ以上のユーザー名を指定し、results_limit を20の倍数(最大2,000)で設定します。
- 必要に応じて start_date と end_date を指定し、メンションの取得期間を限定します。
- SocQのAPIキーを付けて /v1/x/mentions に POST リクエストを送信します。
- /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 と組み合わせると、重要なメンションポストから派生した会話スレッドを詳細に追跡できます。
関連API
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を取得します。
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Replies API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API