Quickstart

Esta guía te muestra cómo hacer tu primera solicitud de Post lookup 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 (que se encuentra en la Developer Console en “Keys and tokens”)

Encuentra un ID de Post

Cada Post tiene un ID único. Puedes encontrarlo en la URL del Post:

https://x.com/XDevelopers/status/1228393702244134912
                                └── Este es el ID del Post

Realiza una solicitud

cURL

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

from xdk import Client

client = Client(bearer_token="YOUR_BEARER_TOKEN")

# Obtén un solo Post por ID
response = client.posts.get("1228393702244134912")
print(response.data)

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 del Post:

{
  "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 fields 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 un Post con fields y expansions adicionales
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:

Ejemplo de 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
      }
    ]
  }
}

Consulta múltiples Posts

Recupera hasta 100 Posts 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")

# Obtén múltiples Posts por IDs
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 autenticación, límites de tasa y mejores prácticas

Fields y expansions

Domina el sistema de fields y expansions

Referencia de la API

Consulta todos los parámetros disponibles

Código de ejemplo

Explora más ejemplos

Getting Started

Products

Fundamentals

Partners & Customers

Resources

Quickstart

Próximos pasos

Guía de integración

Fields y expansions

Referencia de la API

Código de ejemplo

​Próximos pasos

Guía de integración

Fields y expansions

Referencia de la API

Código de ejemplo

Próximos pasos