ピン留めされたリスト

ピン留めされたリストの表示と管理

Pinned Lists エンドポイントを使用すると、認証済みのユーザーのリストを表示、ピン留め、およびピン留め解除できます。ピン留めされたリストは、そのユーザーの X インターフェース上で目立つ位置に表示されます。

​

概要

固定済みリストを表示

ユーザーの固定済みリストを取得する

リストを固定

リストを固定する

リストの固定を解除

リストの固定を解除する

---

​

エンドポイント

Method	Endpoint	Description
GET	/2/users/:id/pinned_lists	ピン留めされたリストを取得
POST	/2/users/:id/pinned_lists	リストをピン留めする
DELETE	/2/users/:id/pinned_lists/:list_id	リストのピン留めを外す

---

​

例：固定されたリストを取得する

curl "https://api.x.com/2/users/123456789/pinned_lists?\
list.fields=name,description,member_count" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​

例：リストをピン留めする

curl -X POST "https://api.x.com/2/users/123456789/pinned_lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"list_id": "9876543210"}'

---

​

はじめに

前提条件

• 承認済みの 開発者アカウント
• 開発者コンソール内の Project と App
• OAuth 2.0 PKCE を使用して取得したユーザーアクセストークン

Lookup クイックスタート

ピン留めされたリストの取得

Manage クイックスタート

リストのピン留め／ピン留め解除

Integration ガイド

主要な概念とベストプラクティス

APIリファレンス

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