Saltar al contenido principal
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»)

1

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
2

Realiza una solicitud

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

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"]
  }
}
4

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"
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
      }
    ]
  }
}
5

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"

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