メインコンテンツへスキップ
このガイドでは、アプリケーションにリスト取得エンドポイントを統合するために必要な主要な概念を説明します。

​
認証

リスト参照エンドポイントは複数の認証方法をサポートしています：
方法推奨用途非公開リストへのアクセスは可能ですか？
OAuth 2.0 App-Only公開リストのデータいいえ
OAuth 2.0 Authorization Code with PKCEユーザー向け Appはい (所有/フォロー中)
OAuth 1.0a User Contextレガシーな統合はい (所有/フォロー中)

​
リクエスト例

cURL
curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,private" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
エンドポイント概要

メソッドエンドポイント説明
GET/2/lists/:idID で指定したリストを取得
GET/2/users/:id/owned_lists指定ユーザーが所有するリストを取得

​
フィールドとexpansions

​
既定のレスポンス

{
  "data": {
    "id": "84839422",
    "name": "Tech News"
  }
}

​
利用可能なフィールド

フィールド説明
created_atリストが作成された日時
descriptionリストの説明
follower_countフォロワー数
member_countメンバー数
owner_idオーナーのユーザーID
privateリストが非公開かどうか
フィールド説明
usernameオーナーの @handle
nameオーナーの表示名
verifiedオーナーの認証ステータス
profile_image_urlオーナーのプロフィール画像の URL

​
expansions を利用した例

cURL
curl "https://api.x.com/2/lists/84839422?\
list.fields=description,member_count,follower_count,owner_id&\
expansions=owner_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

​
expansions を含むレスポンス

{
  "data": {
    "id": "84839422",
    "name": "Tech News",
    "description": "Top tech journalists",
    "member_count": 50,
    "follower_count": 1250,
    "owner_id": "2244994945"
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

Fields と expansions のガイド

レスポンスのカスタマイズ方法について詳しく学びましょう
所有しているリストを取得する場合、結果はページネーション形式で返されます:
cURL
# 最初のリクエスト
curl "https://api.x.com/2/users/123/owned_lists?max_results=100" \
  -H "Authorization: Bearer $BEARER_TOKEN"

# ページネーショントークンを指定した後続リクエスト
curl "https://api.x.com/2/users/123/owned_lists?max_results=100&pagination_token=NEXT_TOKEN" \
  -H "Authorization: Bearer $BEARER_TOKEN"

ページネーションガイド

ページネーションの詳細はこちら

​
非公開リスト

  • 非公開リストは、所有者にのみ表示されます
  • 非公開リストの詳細を取得するには、所有者として認証されている必要があります
  • private フィールドは、リストが非公開かどうかを示します

​
エラー処理

ステータスエラー解決策
400無効なリクエストリスト ID の形式を確認してください
401認証されていません認証情報を確認してください
403アクセスが禁止されていますリストが非公開である可能性があります
404見つかりませんリストが存在しません
429リクエストが多すぎます待機してから再試行してください

​
次のステップ

クイックスタート

最初のリスト検索リクエストを行う

リストの投稿

リストから投稿を取得する

APIリファレンス

エンドポイントの完全なドキュメント

Sample code

動作するコード例