Gestionar Pinned Lists

Esta guía te guía en el proceso de fijar y desfijar Lists.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
User Access Token (OAuth 1.0a u OAuth 2.0 PKCE)

Fijar una List

Obtén tu user ID y el ID de la List

Necesitas el ID de tu usuario autenticado y el ID de la List que quieres fijar. Encuentra los IDs de List en la URL al ver una List.

Fija la 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)

# Fijar una 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 });

// Fijar una List
const response = await client.lists.pin("2244994945", {
  listId: "1454155907651158017",
});

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

Revisa la respuesta

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

Desfijar una 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)

# Desfijar una 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 });

// Desfijar una List
const response = await client.lists.unpin("2244994945", "1454155907651158017");

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

Respuesta:

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

Notas importantes

Solo puedes fijar Lists que sigues o de las que eres propietario
Las Lists fijadas aparecen en la parte superior de tus Lists en la app de X
Existe un límite en la cantidad de Lists que puedes fijar

Próximos pasos

Pinned Lists lookup

Obtén tus Lists fijadas

List lookup

Obtén detalles de una List

Referencia de la API

Documentación completa del endpoint

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Gestionar Pinned Lists

Fijar una List

Desfijar una List

Notas importantes

Próximos pasos

Pinned Lists lookup

List lookup

Referencia de la API

​Fijar una List

​Desfijar una List

​Notas importantes

​Próximos pasos

Pinned Lists lookup

List lookup

Referencia de la API

Fijar una List

Desfijar una List

Notas importantes

Próximos pasos