Inicio rápido

Esta guía te muestra cómo hacer tu primera solicitud para consultar una Publicación usando la X API v2.

Requisitos previosAntes de comenzar, necesitarás:

Una cuenta de desarrollador con una App aprobada
El Bearer Token de tu App (se encuentra en la Consola de desarrollador en «Keys and tokens»)

Buscar el id de una Publicación

Cada Publicación tiene un identificador único. Puedes encontrarlo en la URL de la Publicación:

https://x.com/XDevelopers/status/1228393702244134912
                                └── Este es el ID de la Publicación

Realiza una solicitud

cURL

curl "https://api.x.com/2/tweets/1228393702244134912" \
  -H "Authorization: Bearer $BEARER_TOKEN"

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

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.get("1228393702244134912");
console.log(response.data);

Revisa la respuesta

La respuesta predeterminada incluye el id, text y edit_history_tweet_ids de la Publicación:

{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?\n\nwhile(true) {\n    I = Love(You);\n}",
    "edit_history_tweet_ids": ["1228393702244134912"]
  }
}

Solicita campos adicionales

Usa parámetros de consulta para obtener más datos:

cURL

curl "https://api.x.com/2/tweets/1228393702244134912?\
tweet.fields=created_at,public_metrics,author_id&\
expansions=author_id&\
user.fields=username,verified" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtén una Publicación con campos adicionales y expansions relacionadas
response = client.posts.get(
    "1228393702244134912",
    tweet_fields=["created_at", "public_metrics", "author_id"],
    expansions=["author_id"],
    user_fields=["username", "verified"]
)

print(response.data)
print(response.includes)  # Contiene el objeto de usuario del autor

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

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.get("1228393702244134912", {
  tweetFields: ["created_at", "public_metrics", "author_id"],
  expansions: ["author_id"],
  userFields: ["username", "verified"],
});

console.log(response.data);
console.log(response.includes); // Contiene el objeto de usuario del autor

Respuesta:

{
  "data": {
    "id": "1228393702244134912",
    "text": "What did the developer write in their Valentine's card?...",
    "created_at": "2020-02-14T19:00:55.000Z",
    "author_id": "2244994945",
    "public_metrics": {
      "retweet_count": 156,
      "reply_count": 23,
      "like_count": 892,
      "quote_count": 12
    },
    "edit_history_tweet_ids": ["1228393702244134912"]
  },
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "username": "XDevelopers",
        "verified": true
      }
    ]
  }
}

Consultar varias publicaciones

Recupera hasta 100 Publicaciones en una sola solicitud:

cURL

curl "https://api.x.com/2/tweets?\
ids=1228393702244134912,1227640996038684673,1199786642791452673&\
tweet.fields=created_at,author_id" \
  -H "Authorization: Bearer $BEARER_TOKEN"

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtener varias Publicaciones por id
response = client.posts.get_posts(
    ids=["1228393702244134912", "1227640996038684673", "1199786642791452673"],
    tweet_fields=["created_at", "author_id"]
)

for post in response.data:
    print(f"{post.id}: {post.text[:50]}...")

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

const client = new Client({ bearerToken: "YOUR_BEARER_TOKEN" });

const response = await client.posts.getPosts({
  ids: ["1228393702244134912", "1227640996038684673", "1199786642791452673"],
  tweetFields: ["created_at", "author_id"],
});

response.data?.forEach((post) => {
  console.log(`${post.id}: ${post.text?.slice(0, 50)}...`);
});

Próximos pasos

Guía de integración

Aprende sobre la autenticación, los límites de tasa y las mejores prácticas

Campos y Expansions

Domina el sistema de campos y Expansions

Referencia de la API

Consulta todos los parámetros disponibles

Código de ejemplo

Explora más ejemplos

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

Próximos pasos

Guía de integración

Campos y Expansions

Referencia de la API

Código de ejemplo

​Próximos pasos

Guía de integración

Campos y Expansions

Referencia de la API

Código de ejemplo

Próximos pasos