Inicio rápido

Esta guía te mostrará cómo crear, actualizar y eliminar Listas.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Un token de acceso de usuario (OAuth 1.0a o OAuth 2.0 PKCE)

Crear una Lista

Prepara tu solicitud

Define el nombre de la Lista (obligatorio) y, de forma opcional, la descripción y la configuración de privacidad:

{
  "name": "Tech News",
  "description": "Top tech journalists and publications",
  "private": false
}

Envía la solicitud

cURL

curl -X POST "https://api.x.com/2/lists" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News",
    "description": "Top tech journalists and publications",
    "private": false
  }'

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)

# Crear una nueva Lista
response = client.lists.create(
    name="Tech News",
    description="Top tech journalists and publications",
    private=False
)

print(f"List created: {response.data.id} - {response.data.name}")

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

// Crear una nueva Lista
const response = await client.lists.create({
  name: "Tech News",
  description: "Top tech journalists and publications",
  private: false,
});

console.log(`List created: ${response.data?.id} - ${response.data?.name}`);

Revisa la respuesta

{
  "data": {
    "id": "1441162269824405510",
    "name": "Tech News"
  }
}

Guarda el id para poder actualizar o eliminar la Lista más adelante.

Actualizar una Lista

Actualiza el nombre, la descripción o la privacidad de una Lista:

cURL

curl -X PUT "https://api.x.com/2/lists/1441162269824405510" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Tech News & Insights",
    "description": "Updated description"
  }'

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)

# Actualizar una Lista
response = client.lists.update(
    "1441162269824405510",
    name="Tech News & Insights",
    description="Updated description"
)

print(f"Updated: {response.data.updated}")

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

// Actualizar una Lista
const response = await client.lists.update("1441162269824405510", {
  name: "Tech News & Insights",
  description: "Updated description",
});

console.log(`Updated: ${response.data?.updated}`);

Respuesta:

{
  "data": {
    "updated": true
  }
}

Eliminar una Lista

Obtener el ID de la Lista

Necesitas el ID de la Lista que quieres eliminar.

Enviar la solicitud de eliminación

cURL

curl -X DELETE "https://api.x.com/2/lists/1441162269824405510" \
  -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)

# Eliminar una Lista
response = client.lists.delete("1441162269824405510")
print(f"Deleted: {response.data.deleted}")

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

// Eliminar una Lista
const response = await client.lists.delete("1441162269824405510");
console.log(`Deleted: ${response.data?.deleted}`);

Confirmar la eliminación

{
  "data": {
    "deleted": true
  }
}

Solo puedes eliminar las Listas de las que seas propietario.

Próximos pasos

Miembros de la Lista

Agregar y eliminar miembros de la Lista

Consulta de Listas

Obtener detalles de la Lista

Guía de integración

Conceptos clave y buenas prácticas

Referencia de la API

Documentación completa del endpoint

Descripción general

Publicaciones

Usuarios

Mensajes directos

Me gusta

Listas

Spaces

Comunidades

Notas de la comunidad

Tendencias

Noticias

Contenido multimedia

Actividad en X

Uso

Conexiones de streaming

Cumplimiento

Enterprise v2

Flujos de Me gusta

GNIP 2.0

Inicio rápido

Crear una Lista

Actualizar una Lista

Eliminar una Lista

Próximos pasos

Miembros de la Lista

Consulta de Listas

Guía de integración

Referencia de la API

​Crear una Lista

​Actualizar una Lista

​Eliminar una Lista

​Próximos pasos

Miembros de la Lista

Consulta de Listas

Guía de integración

Referencia de la API

Crear una Lista

Actualizar una Lista

Eliminar una Lista

Próximos pasos