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

​
概要

固定済みリストを表示

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

リストを固定

リストを固定する

リストの固定を解除

リストの固定を解除する

​
エンドポイント

MethodEndpointDescription
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"}'

​
はじめに

前提条件

Lookup クイックスタート

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

Manage クイックスタート

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

Integration ガイド

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

APIリファレンス

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