メインコンテンツへスキップ
このガイドでは、特定のユーザーがメンションされている投稿を取得する方法を説明します。
前提条件始める前に、次のものが必要です。
  • 承認済みの App を持つ開発者アカウント
  • App のベアラートークン (公開データ用) またはユーザーアクセストークン (非公開のメトリクス用)

​
ユーザーへのメンションを取得する

1

ユーザーIDを取得する

ユーザー照会エンドポイントを使ってユーザーIDを特定します。たとえば、@XDevelopers のユーザーIDは 2244994945 です。
2

メンションタイムラインをリクエストする

cURL
curl "https://api.x.com/2/users/2244994945/mentions?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"
3

レスポンスを確認する

{
  "data": [
    {
      "id": "1301573587187331074",
      "text": "Hey @XDevelopers、新しい API がとても気に入っています！",
      "author_id": "1234567890",
      "created_at": "2024-01-15T10:30:00.000Z",
      "public_metrics": {
        "retweet_count": 5,
        "reply_count": 2,
        "like_count": 42,
        "quote_count": 1
      }
    }
  ],
  "includes": {
    "users": [
      {
        "id": "1234567890",
        "username": "developer",
        "name": "Dev Person",
        "verified": false
      }
    ]
  },
  "meta": {
    "newest_id": "1301573587187331074",
    "oldest_id": "1301573587187331074",
    "result_count": 1,
    "next_token": "t3buvdr5pujq9g7bggsnf3ep2ha28"
  }
}

​
メンションをフィルタリングする

​
返信を除外する

ユーザーへのメンションのうち、返信ではない元のポストのみを取得します:
cURL
curl "https://api.x.com/2/users/2244994945/mentions?\
exclude=replies&\
max_results=10" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
特定の期間内のメンションを取得

cURL
curl "https://api.x.com/2/users/2244994945/mentions?\
start_time=2024-01-01T00%3A00%3A00Z&\
end_time=2024-01-31T23%3A59%3A59Z" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
共通パラメーター

パラメーター説明デフォルト
max_results1 ページあたりの結果数 (1-100)10
start_time最も古いポストのタイムスタンプ (ISO 8601)—
end_time最も新しいポストのタイムスタンプ (ISO 8601)—
since_idこの ID 以降の投稿を返す—
until_idこの ID 以前の投稿を返す—
excluderetweets、replies、またはその両方を除外—
pagination_token次ページ用のトークン—

​
次のステップ

ホームタイムライン

ユーザーのホームタイムラインを取得する

インテグレーションガイド

基本概念とベストプラクティスを理解する

APIリファレンス

エンドポイントの完全なドキュメントを確認する

ページネーションガイド

大規模な結果セットを扱う