Manage Pinned Lists

このガイドでは、List のピン留めおよびピン留め解除の手順を説明します。

前提条件始める前に、以下が必要です:

承認済みの App がある developer account
ユーザー Access Token (OAuth 1.0a または OAuth 2.0 PKCE)

List をピン留め

user ID と List ID を取得

認証済みユーザーの ID と、ピン留めしたい List の ID が必要です。List ID は List 表示時の URL で確認できます。

List をピン留め

cURL

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

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# List をピン留め
response = client.lists.pin(
    user_id="2244994945",
    list_id="1454155907651158017"
)

print(f"Pinned: {response.data.pinned}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// List をピン留め
const response = await client.lists.pin("2244994945", {
  listId: "1454155907651158017",
});

console.log(`Pinned: ${response.data?.pinned}`);

レスポンスを確認

{
  "data": {
    "pinned": true
  }
}

List のピン留めを解除

cURL

curl -X DELETE "https://api.x.com/2/users/2244994945/pinned_lists/1454155907651158017" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

from xdk import Client
from xdk.oauth1_auth import OAuth1

oauth1 = OAuth1(
    api_key="YOUR_API_KEY",
    api_secret="YOUR_API_SECRET",
    access_token="YOUR_ACCESS_TOKEN",
    access_token_secret="YOUR_ACCESS_TOKEN_SECRET"
)

client = Client(auth=oauth1)

# List のピン留めを解除
response = client.lists.unpin(
    user_id="2244994945",
    list_id="1454155907651158017"
)

print(f"Pinned: {response.data.pinned}")

import { Client, OAuth1 } from "@xdevplatform/xdk";

const oauth1 = new OAuth1({
  apiKey: "YOUR_API_KEY",
  apiSecret: "YOUR_API_SECRET",
  accessToken: "YOUR_ACCESS_TOKEN",
  accessTokenSecret: "YOUR_ACCESS_TOKEN_SECRET",
});

const client = new Client({ oauth1 });

// List のピン留めを解除
const response = await client.lists.unpin("2244994945", "1454155907651158017");

console.log(`Pinned: ${response.data?.pinned}`);

レスポンス:

{
  "data": {
    "pinned": false
  }
}

重要なポイント

ピン留めできるのは、フォローしているか自分が所有する List に限られます
ピン留めした List は X アプリの List の最上部に表示されます
ピン留めできる List の数には上限があります

次のステップ

Pinned Lists lookup

ピン留めした List を取得

List lookup

List の詳細を取得

API リファレンス

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

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Manage Pinned Lists

List をピン留め

List のピン留めを解除

重要なポイント

次のステップ

Pinned Lists lookup

List lookup

API リファレンス

​List をピン留め

​List のピン留めを解除

​重要なポイント

​次のステップ

Pinned Lists lookup

List lookup

API リファレンス

List をピン留め

List のピン留めを解除

重要なポイント

次のステップ