Saltar al contenido principal
Esta página contiene información sobre varias herramientas y conceptos clave para ayudarte a integrar los endpoints de consulta de Posts en tu sistema. Hemos organizado la página en varias secciones:

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave, te recomendamos familiarizarte con las siguientes herramientas: Postman
Postman es una herramienta excelente para probar un endpoint, incluidos todos los parámetros de ruta y de cuerpo, y así ayudarte a comprender qué está disponible. Consulta nuestra guía de introducción a Postman para obtener más información. Ejemplos de código
Encuentra ejemplos de código para tu lenguaje de programación preferido en nuestra página de GitHub. Bibliotecas de terceros
Utiliza bibliotecas de terceros creadas por la comunidad y compatibles con los endpoints de la v2.

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren solicitudes autenticadas. Puedes autenticarte con:
OAuth 1.0a puede ser difícil de implementar. Si no estás familiarizado, considera usar una biblioteca u OAuth 2.0 para las solicitudes. Para métricas privadas o Posts, usa Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0 con PKCE.
Ten en cuenta
Si solicitas los siguientes fields, se requiere Contexto de usuario de OAuth 1.0a o Código de autorización de OAuth 2.0:
  • tweet.fields.non_public_metrics
  • tweet.fields.promoted_metrics
  • tweet.fields.organic_metrics
  • media.fields.non_public_metrics
  • media.fields.promoted_metrics
  • media.fields.organic_metrics

​
Portal de desarrolladores, Proyectos y Apps

Para obtener credenciales para X API v2, necesitas:
  1. Una cuenta de desarrollador aprobada.
  2. Un Proyecto dentro de la cuenta de desarrollador.
  3. Una App de desarrollador dentro de ese Proyecto, donde encontrarás las claves y los tokens.

​
Límites de uso

Las solicitudes a la X API están sujetas a límites de uso para gestionar el volumen. Los límites se aplican tanto a nivel de App como de usuario:
  • A nivel de App: Limita la cantidad de solicitudes que cualquier App puede realizar por período.
  • A nivel de usuario: Limita la frecuencia con la que un usuario autenticado puede realizar consultas de Post en distintas Apps de desarrollador.

​
Campos y expansions

La X API v2 permite seleccionar campos de data específicos usando fields y expansions:
  • Expansions: Permiten recuperar objetos relacionados adicionales. Las expansions compatibles incluyen:
    • edit_history_tweet_ids
    • attachments.poll_ids
    • attachments.media_keys
    • author_id
    • entities.mentions.username
    • geo.place_id
    • in_reply_to_user_id
    • referenced_tweets.id
    • referenced_tweets.id.author_id
  • Fields: Especifican campos de data dentro de los objetos para devolver data adicional. El objeto Post incluye por defecto id, text y edit_history_tweet_ids. Otras opciones, como tweet.created_at y tweet.entities, deben solicitarse explícitamente.
Para más información, consulta la guía de fields y expansions en el diccionario de data de X API v2.

​
Edición de Posts

Los Posts elegibles pueden editarse hasta cinco veces dentro de los 30 minutos posteriores a su publicación. El endpoint de consulta de Posts siempre devuelve la versión más reciente del Post. Para casos de uso casi en tiempo real, ten en cuenta esta ventana de tiempo. Para más detalles, consulta Conceptos fundamentales de edición de Posts.

​
Casos límite

  • Métricas promocionadas: Solicitar métricas promocionadas para Posts no promocionados devuelve una respuesta vacía.
  • Texto truncado: El texto del Post se trunca en los Retweets. Para obtener el texto completo, expande el Post referenciado.