Inicio rápido

Esta guía explica cómo crear y eliminar Publicaciones con la X API.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
Tokens de acceso de usuario (OAuth 1.0a u OAuth 2.0 PKCE)

Crear una Publicación

Prepara tu solicitud

El endpoint POST /2/tweets requiere un cuerpo JSON con al menos text o media:

{
  "text": "Hello from the X API!"
}

Envía la solicitud

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from the X API!"}'

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 Publicación
response = client.posts.create(text="Hello from the X API!")
print(f"Created Post: {response.data.id}")

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 Publicación
const response = await client.posts.create({ text: "Hello from the X API!" });
console.log(`Created Post: ${response.data?.id}`);

Revisa la respuesta

Una respuesta exitosa incluye los campos id y text de la nueva Publicación:

{
  "data": {
    "id": "1445880548472328192",
    "text": "Hello from the X API!"
  }
}

Ejemplos avanzados

Responder a una publicación

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "This is a reply!",
    "reply": {
      "in_reply_to_tweet_id": "1234567890"
    }
  }'

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 respuesta
response = client.posts.create(
    text="This is a reply!",
    reply={"in_reply_to_tweet_id": "1234567890"}
)
print(f"Respuesta creada: {response.data.id}")

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 respuesta
const response = await client.posts.create({
  text: "This is a reply!",
  reply: { inReplyToTweetId: "1234567890" },
});
console.log(`Respuesta creada: ${response.data?.id}`);

Citar una publicación

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "¡Mira esto!",
    "quote_tweet_id": "1234567890"
  }'

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)

# Citar una Publicación
response = client.posts.create(
    text="¡Mira esto!",
    quote_tweet_id="1234567890"
)
print(f"Cita creada: {response.data.id}")

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

// Citar una Publicación
const response = await client.posts.create({
  text: "¡Mira esto!",
  quoteTweetId: "1234567890",
});
console.log(`Cita creada: ${response.data?.id}`);

Publicación con medios

First, upload media using the Media Upload endpoint, then reference the media_id:

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Photo of the day!",
    "media": {
      "media_ids": ["1234567890123456789"]
    }
  }'

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)

# Publicación con contenido multimedia
response = client.posts.create(
    text="Photo of the day!",
    media={"media_ids": ["1234567890123456789"]}
)
print(f"Publicación creada con contenido multimedia: {response.data.id}")

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

// Publicación con contenido multimedia
const response = await client.posts.create({
  text: "Photo of the day!",
  media: { mediaIds: ["1234567890123456789"] },
});
console.log(`Publicación creada con contenido multimedia: ${response.data?.id}`);

Publicación con encuesta

cURL

curl -X POST "https://api.x.com/2/tweets" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "¿Cuál es tu color favorito?",
    "poll": {
      "options": ["Rojo", "Azul", "Verde", "Amarillo"],
      "duration_minutes": 1440
    }
  }'

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)

# Publicación con encuesta
response = client.posts.create(
    text="¿Cuál es tu color favorito?",
    poll={"options": ["Rojo", "Azul", "Verde", "Amarillo"], "duration_minutes": 1440}
)
print(f"Encuesta creada: {response.data.id}")

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

// Publicación con encuesta
const response = await client.posts.create({
  text: "¿Cuál es tu color favorito?",
  poll: { options: ["Rojo", "Azul", "Verde", "Amarillo"], durationMinutes: 1440 },
});
console.log(`Encuesta creada: ${response.data?.id}`);

Eliminar una Publicación

Obtener el identificador de la Publicación

Necesitas el identificador de la Publicación que quieres eliminar. Este se obtiene cuando creas una Publicación.

Enviar una solicitud DELETE

cURL

curl -X DELETE "https://api.x.com/2/tweets/1445880548472328192" \
  -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 Publicación
response = client.posts.delete("1445880548472328192")
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 Publicación
const response = await client.posts.delete("1445880548472328192");
console.log(`Deleted: ${response.data?.deleted}`);

Confirmar la eliminación

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

Solo puedes eliminar Publicaciones que tú hayas creado.

Próximos pasos

Guía de integración

Conceptos clave y prácticas recomendadas

Carga de medios

Sube contenido multimedia para Publicaciones

Referencia de la API

Documentación completa del endpoint

Código de ejemplo

Ejemplos de código listos para usar

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 Publicación

Ejemplos avanzados

Eliminar una Publicación

Próximos pasos

Guía de integración

Carga de medios

Referencia de la API

Código de ejemplo

​Crear una Publicación

​Ejemplos avanzados

​Eliminar una Publicación

​Próximos pasos

Guía de integración

Carga de medios

Referencia de la API

Código de ejemplo

Crear una Publicación

Ejemplos avanzados

Eliminar una Publicación

Próximos pasos