ピン留めされたリスト検索

ユーザーのピン留めされたリストを取得する

このガイドでは、ユーザーのピン留めされたリストを取得する方法を説明します。

前提条件

作業を始める前に、以下が必要です：

• 承認済みの App を持つ開発者アカウント
• ユーザーアクセストークン (OAuth 1.0a または OAuth 2.0 PKCE)

---

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

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

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

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

   cURL

   shellscript

   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
     }
   }
   

---

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

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

---

次のステップ

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

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

リストのルックアップ

リストの詳細を取得

APIリファレンス

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