Saltar al contenido principal

​
Introducción al endpoint de búsqueda reciente

Esta guía de inicio rápido le ayudará a realizar su primera solicitud al endpoint de búsqueda reciente con un conjunto de fields especificados usando Postman. Si desea ver código de ejemplo en distintos lenguajes, visite nuestro repositorio de GitHub X API v2 sample code.

​
Requisitos previos

Para completar esta guía, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:

​
Pasos para crear una solicitud de búsqueda reciente

Paso uno: Comience con una herramienta o biblioteca Existen varias herramientas, ejemplos de código y bibliotecas que puede usar para realizar una solicitud a este endpoint, pero aquí usaremos la herramienta Postman para simplificar el proceso. Para cargar la colección de Postman de X API v2 en su entorno, haga clic en el siguiente botón:
Una vez que tenga cargada la colección de X API v2 en Postman, vaya a Search Posts > Recent search request. Paso dos: Autentique su solicitud Para realizar correctamente una solicitud a la X API, debe verificar que tiene permiso. Para hacerlo con este endpoint, debe autenticar su solicitud con OAuth 2.0 App-Only, Código de autorización de OAuth 2.0 con PKCE o Contexto de usuario de OAuth 1.0a. Para simplificar, utilizaremos OAuth 2.0 App-Only con esta solicitud, pero deberá usar uno de los otros métodos de autenticación si desea solicitar métricas privadas o Posts. Para utilizar OAuth 2.0 App-Only, debe agregar sus claves y tokens, específicamente el App Access Token (también conocido como App-only Bearer Token) en Postman. Puede hacerlo seleccionando el entorno llamado “X API v2” en la esquina superior derecha de Postman y agregando sus claves y tokens en los campos “initial value” y “current value” (haciendo clic en el ícono de ojo junto al menú desplegable del entorno). Estas variables se incorporarán automáticamente en la pestaña de autorización de la solicitud si lo ha hecho correctamente.   Paso tres: Cree una consulta de búsqueda Cada búsqueda reciente requiere una única search query. Para este ejemplo, usaremos una consulta que coincida con los Posts publicados por la cuenta @XDevelopers. Para esta consulta usamos el operador from y lo configuramos en XDevelopers (no distingue mayúsculas de minúsculas): from:XDevelopers En Postman, vaya a la pestaña “Params” e ingrese este id, o una cadena de ids de Posts separada por comas, en la columna “Value” del parámetro ids.
KeyValueDescription
queryfrom:XDevelopersConsulta de búsqueda para enviar al endpoint de búsqueda reciente
Paso cuatro: Identifique y especifique qué fields desea recuperar Si hace clic en el botón “Send” después del paso tres, recibirá en su respuesta los fields predeterminados del Post object: id, text y edit_history_tweet_ids. Si desea recibir fields adicionales más allá de id, text y edit_history_tweet_ids, deberá especificarlos en su solicitud con los parámetros fields y/o expansions. Para este ejercicio, solicitaremos cuatro conjuntos diferentes de fields de distintos objetos:
  1. Los fields predeterminados del Post object.
  2. El field adicional tweet.created_at en los objetos de usuario principales.
  3. Los fields predeterminados del user object de los autores asociados para los Posts devueltos.
  4. El field adicional user.description en los objetos de usuario asociados.
En Postman, vaya a la pestaña “Params” y agregue el siguiente par clave: valor a la tabla “Query Params”:
KeyValueReturned fields
tweet.fieldscreated_attweets.created_at
expansionsauthor_idincludes.users.id, includes.users.name, includes.users.username
user.fieldsdescriptionincludes.users.description
Ahora debería ver la siguiente URL junto al botón “Send”: https://api.x.com/2/tweets/search/recent?query=from:XDevelopers&tweet.fields=created_at&expansions=author_id&user.fields=created_at Paso cinco: Envía tu solicitud y revisa la respuesta Una vez que tengas todo configurado, haz clic en el botón “Send” y recibirás la siguiente respuesta: 
{
   "data": [
       {
           "author_id": "2244994945",
           "created_at": "2020-06-11T16:05:06.000Z",
           "id": "1271111223220809728",
           "text": "Sintoniza esta noche y mira cómo @jessicagarson nos guía en la ejecución de tu paquete favorito de Python en R. 🍿\n\nAprende a usar juntos dos potentes lenguajes de programación para ciencia de datos, y observa un ejemplo en vivo que utiliza el endpoint de búsqueda reciente de los Developer Labs de X. https://t.co/v178oUZNuj"
       },
       {
           "author_id": "2244994945",
           "created_at": "2020-06-10T19:25:24.000Z",
           "id": "1270799243071062016",
           "text": "Mientras trabajamos en la construcción de la nueva API de X, hemos extendido el cronograma de desaprobación para varios endpoints de Labs v1. Más información 📖 https://t.co/rRWaJYJgKk"
       },
       {
           "author_id": "2244994945",
           "created_at": "2020-06-09T18:08:47.000Z",
           "id": "1270417572001976322",
           "text": "Las anotaciones te ayudan a aprender más sobre un Tweet — incluso pueden ayudarte a encontrar temas de interés. 🔬\n\nEn este tutorial, @suhemparack nos muestra cómo encontrar Tweets relacionados con COVID-19 usando anotaciones + el endpoint de transmisión filtrada.\n\nAprende cómo tú también puedes hacerlo. ⤵️\nhttps://t.co/qwVOgw0zSV"
       }
   ],
   "includes": {
       "users": [
           {
               "description": "La voz del equipo de #DevRel de X, y tu fuente oficial de actualizaciones, noticias y eventos sobre la API de X. \n\n#BlackLivesMatter",
               "id": "2244994945",
               "name": "X Developers",
               "username": "XDevelopers"
           }
       ]
   },
   "meta": {
       "newest_id": "1271111223220809728",
       "oldest_id": "1270417572001976322",
       "result_count": 3
   }
}
Próximos pasos Personaliza tu solicitud usando la Referencia de la API Consulta la lista completa de operadores de búsqueda Usa código de ejemplo para estos endpoints