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

​
Herramientas útiles

Antes de profundizar en algunos conceptos clave, te recomendamos familiarizarte con las siguientes herramientas: Postman
Postman es una excelente herramienta para probar un endpoint, incluidos todos los parámetros de ruta y de cuerpo para 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 endpoints de v2.

​
Conceptos clave

​
Autenticación

Todos los endpoints de X API v2 requieren solicitudes autenticadas. Puedes autenticarte con:
OAuth 1.0a puede resultar complejo de implementar. Si no estás familiarizado, considera usar una biblioteca u OAuth 2.0 para las solicitudes. Para metrics 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, Projects y Apps

Para obtener credenciales para X API v2, necesitas:
  1. Una cuenta de desarrollador aprobada.
  2. Un Project dentro de la cuenta de desarrollador.
  3. Un App de desarrollador dentro de ese Project, donde se pueden encontrar keys and tokens.

​
Límites de velocidad

Las solicitudes a la X API están sujetas a límites de velocidad 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 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 objetos para devolver información adicional. El Objeto de 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 obtener más información, consulta la guía de fields y expansions en el diccionario de datos de X API v2.

​
Ediciones 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 proporciona la versión más reciente del Post. Para casos de uso casi en tiempo real, tenga en cuenta esta ventana de tiempo. Para más detalles, consulte Fundamentos de edición de Posts.

​
Casos extremos

  • metrics promocionadas: Solicitar metrics 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, expanda el Post referenciado.
⌘I