Inicio rápido de búsqueda reciente

Realiza tu primera solicitud de búsqueda reciente en cuestión de minutos

Esta guía te explica cómo realizar tu primera solicitud de búsqueda reciente para encontrar Publicaciones de los últimos 7 días.

Requisitos previos

Antes 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. Crear una consulta

   Las consultas de búsqueda utilizan operadores para encontrar Publicaciones. Comienza con una palabra clave sencilla:

   python
   

   O bien combina varios operadores:

   python lang:en -is:retweet
   

   Esto coincide con las Publicaciones que contienen “python” en inglés y excluye los retweets.

   Consulta la referencia completa de operadores para ver todas las opciones disponibles.

2. Realizar una solicitud

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/search/recent?query=python%20lang%3Aen%20-is%3Aretweet" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   
3. Revisar la respuesta

   De forma predeterminada, la respuesta incluye id, text y edit_history_tweet_ids:

   {
     "data": [
       {
         "id": "1234567890123456789",
         "text": "Just started learning Python and loving it!",
         "edit_history_tweet_ids": ["1234567890123456789"]
       },
       {
         "id": "1234567890123456788",
         "text": "Python tip: use list comprehensions for cleaner code",
         "edit_history_tweet_ids": ["1234567890123456788"]
       }
     ],
     "meta": {
       "newest_id": "1234567890123456789",
       "oldest_id": "1234567890123456788",
       "result_count": 2
     }
   }
   
4. Agregar campos y expansions

   Solicita datos adicionales usando parámetros de consulta:

   cURL

   shellscript

   curl "https://api.x.com/2/tweets/search/recent?\
   query=python%20lang%3Aen%20-is%3Aretweet&\
   tweet.fields=created_at,public_metrics,author_id&\
   expansions=author_id&\
   user.fields=username,verified&\
   max_results=10" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Respuesta:

   {
     "data": [
       {
         "id": "1234567890123456789",
         "text": "Just started learning Python and loving it!",
         "created_at": "2024-01-15T10:30:00.000Z",
         "author_id": "9876543210",
         "public_metrics": {
           "retweet_count": 5,
           "reply_count": 2,
           "like_count": 42,
           "quote_count": 1
         },
         "edit_history_tweet_ids": ["1234567890123456789"]
       }
     ],
     "includes": {
       "users": [
         {
           "id": "9876543210",
           "username": "pythondev",
           "verified": false
         }
       ]
     },
     "meta": {
       "newest_id": "1234567890123456789",
       "oldest_id": "1234567890123456789",
       "result_count": 1
     }
   }
   
5. Paginar resultados

   Los SDK gestionan la paginación automáticamente. Para cURL, utiliza el next_token de la respuesta:

   curl "https://api.x.com/2/tweets/search/recent?\
   query=python&\
   max_results=100&\
   next_token=b26v89c19zqg8o3fo7gesq314yb9l2l4ptqy" \
     -H "Authorization: Bearer $BEARER_TOKEN"
   

   Guía de paginación

   Más información sobre cómo explorar grandes conjuntos de resultados

---

​

Consultas de ejemplo

Publicaciones de un usuario específico

from:XDevelopers

Publicaciones con un hashtag

#Python -is:retweet

Publicaciones con imágenes

"machine learning" has:images lang:en

Publicaciones que mencionan a un usuario

@elonmusk -is:retweet -is:reply

Publicaciones con enlaces a un dominio

url:github.com lang:en

---

​

Próximos pasos

Crear una consulta

Domina la sintaxis de las consultas y los operadores

Referencia de operadores

Consulta todos los operadores disponibles

Búsqueda en el archivo completo

Busca en el archivo completo de Publicaciones

Referencia de la API

Documentación completa del endpoint