Introducción al endpoint de búsqueda de archivo completo
Requisitos previos
El endpoint de búsqueda de archivo completo está disponible actualmente solo como parte de los accesos Pro y Empresarial. Para usar este endpoint, debe actualizar al acceso Pro o solicitar el nivel de acceso Empresarial.Además de contar con la aprobación de acceso, necesitará un conjunto de keys and tokens para autenticar su solicitud. Puede generar estas keys and tokens siguiendo estos pasos:
-
Vaya a su Project con acceso Empresarial o Pro en el Portal de desarrolladores y asegúrese de tener una developer App asociada dentro de ese Project.
-
Vaya a la página “Keys and tokens” de su App para generar las credenciales requeridas. Asegúrese de guardar todas las credenciales en un lugar seguro.
Pasos para crear una solicitud de búsqueda de archivo completo
from:XDevelopers
En Postman, navega a la pestaña “Params” e ingresa este id, o una cadena de ids de Post separados por comas, en la columna “Value” del parámetro ids.
| Key | Value | Description |
|---|
query | from:XDevelopers | Consulta de búsqueda para enviar al endpoint de búsqueda de archivo completo |
id, text y edit_history_tweet_ids. Ten en cuenta que si recibes Posts anteriores a la compatibilidad con edición, no se proporcionará el campo edit_history_tweet_ids. No se realizó una carga retrospectiva para este campo.
Si deseas recibir fields adicionales más allá de estos predeterminados, deberás especificarlos en tu solicitud con los parámetros fields y/o expansions.
Para este ejercicio, solicitaremos cuatro conjuntos diferentes de fields de distintos objetos:
- Los fields predeterminados del Post object
- El field adicional tweet.created_at en los objetos de usuario principales
- Los fields predeterminados del user object de los autores asociados para los Posts devueltos
- El field adicional user.description en los objetos de usuario asociados
En Postman, navega a la pestaña “Params” y agrega el siguiente par key:value a la tabla “Query Params”:
| Key | Value | Returned fields |
|---|
tweet.fields | created_at | tweets.created_at |
expansions | author_id | includes.users.id, includes.users.name, includes.users.username |
| user.fields | description | includes.users.description |
https://api.x.com/2/tweets/search/all?query=from:XDevelopers&tweet.fields=created_at&expansions=author_id&user.fields=created_at
Ten en cuentaDe forma predeterminada, solo se devolverán los 10 Posts más recientes. Si quieres más de 10 Posts por solicitud, puedes usar el parámetro max_results y establecerlo en un máximo de 500 Posts por solicitud. De manera similar, de forma predeterminada se devolverán Posts de los últimos 30 días. Si quieres obtener Posts con más de 30 días de antigüedad, puedes usar los parámetros start_time y end_time en tu llamada a la API.
{
"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 dos lenguajes de programación potentes para ciencia de datos en conjunto, y mira un ejemplo en vivo que utiliza el endpoint de búsqueda reciente de los Developer Labs de Twitter. 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 Twitter, 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. ⤵️\nhttps://t.co/qwVOgw0zSV"
}
],
"includes": {
"users": [
{
"description": "La voz del equipo de #DevRel de Twitter, y tu fuente oficial de actualizaciones, noticias y eventos sobre la API de Twitter. \n\n#BlackLivesMatter",
"id": "2244994945",
"name": "Twitter Dev",
"username": "TwitterDev"
}
]
},
"meta": {
"newest_id": "1271111223220809728",
"oldest_id": "1270417572001976322",
"result_count": 3
}
}
