メインコンテンツへスキップ
このガイドでは、ユーザーのピン留めされたリストを取得する方法を説明します。
前提条件作業を始める前に、以下が必要です：
  • 承認済みの App を持つ開発者アカウント
  • ユーザーアクセストークン (OAuth 1.0a または OAuth 2.0 PKCE)

​
ピン留めされたリストを取得する

1

自分のユーザーIDを取得する

認証済みユーザーの ID が必要です。ユーザールックアップエンドポイントを使うか、アクセストークンから確認できます (数値の部分がユーザーIDです) 。
2

ピン留めされたリストをリクエストする

cURL
curl "https://api.x.com/2/users/2244994945/pinned_lists?\
list.fields=follower_count,member_count,owner_id&\
expansions=owner_id&\
user.fields=created_at,username" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"
3

レスポンスを確認する

{
  "data": [
    {
      "id": "1454155907651158017",
      "name": "Tech News",
      "follower_count": 150,
      "member_count": 25,
      "owner_id": "2244994945"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "name": "X Developers",
        "created_at": "2013-12-14T04:35:55.000Z"
      }
    ]
  },
  "meta": {
    "result_count": 1
  }
}

​
利用可能なリストフィールド

FieldDescription
descriptionリストの説明
owner_id所有者のユーザーID
privateリストが非公開かどうか
member_countメンバー数
follower_countフォロワー数
created_atリストの作成日時

​
次のステップ

ピン留め済みリストを管理

リストをピン留め・ピン留め解除する

リストのルックアップ

リストの詳細を取得

APIリファレンス

エンドポイントの詳細なドキュメント