Skip to main content

​
Introducción

Los endpoints Search Posts en el mundo v2 te permiten recibir Posts relacionados con temas de interés, basados en una consulta de búsqueda que produzcas. Tenemos dos endpoints distintos disponibles con v2 Search Posts: recent search, que está disponible para todos los desarrolladores con una cuenta aprobada y puede buscar Posts de hasta siete días de antigüedad, y full-archive search, que solo está disponible para investigadores aprobados en el track de producto Academic Research, y puede buscar en todo el archivo de Posts hasta marzo de 2006. Puedes ver nuestra oferta completa de búsqueda en nuestra página de resumen de búsqueda. Estos endpoints Search Posts abordan uno de los casos de uso más comunes para los investigadores académicos, que podrían usarlo para estudios longitudinales o para analizar un tema o evento pasado. Este tutorial ofrece una guía paso a paso para investigadores que deseen usar el endpoint full-archive search para buscar en el historial completo de datos públicos de X. También demostrará las diferentes formas de construir un conjunto de datos, como recuperando Posts geoetiquetados, y cómo paginar por los Posts disponibles para una consulta.

​
Requisitos previos

Actualmente, este endpoint solo está disponible como parte del track de producto Academic Research. Para usar este endpoint, debes solicitar acceso. Obtén más información sobre la solicitud y los requisitos de este track.

​
Conectar una app al proyecto académico

Una vez que estés aprobado para usar el track de producto Academic Research, verás tu Project Académico en la Developer Console. En la sección “Apps”, haz clic en “Add App” para conectar tu X App al Project. Esta imagen muestra un Project Académico en la Developer Console al que aún no se le ha añadido una App Luego, puedes elegir una App existente y conectarla a tu proyecto (como se muestra abajo). Esta imagen muestra la página que aparece cuando intentas añadir una App a tu Project Académico O puedes crear una nueva App, darle un nombre y hacer clic en completar, para conectar una nueva App a tu Project Académico. Esta imagen muestra la página en la que introducirás un nombre para tu nueva App, o te permite seleccionar una App existente Esto te dará tus API keys y Bearer Token que luego podrás usar para conectarte al endpoint full-archive search. Esta imagen muestra la página que se te muestra después de crear una nueva App, donde aparecen tus claves y tokens Ten en cuenta Las claves en la captura anterior están ocultas, pero en tu propia Developer Console, podrás ver los valores reales de la API Key, la API Secret Key y el Bearer Token. Guarda estas claves y el Bearer Token porque los necesitarás para llamar al endpoint full-archive search. El comando cURL siguiente muestra cómo puedes obtener Posts históricos del handle @XDevelopers. Reemplaza $BEARER_TOKEN por tu propio Bearer Token, pega la solicitud completa en tu terminal y presiona “return”.
Verás la respuesta JSON. Por defecto, 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, como se muestra abajo:

​
Construir consultas

Como puedes ver en las llamadas de ejemplo anteriores, usando el parámetro query, puedes especificar los datos que quieres buscar. Como ejemplo, si quisieras obtener todos los Posts que contengan la palabra covid o la palabra coronavirus, puedes usar el operador OR dentro de paréntesis, y tu consulta puede ser (covid OR coronavirus) y así tu llamada a la API se verá como lo siguiente:
De manera similar, si quieres todos los Posts que contengan las palabras covid19 y que no sean reposts, puedes usar el operador is:retweet con el NOT lógico (representado por -), por lo que tu consulta puede ser covid19 -is:retweet y tu llamada a la API será:
Consulta esta guía para ver una lista completa de operadores que están soportados en el endpoint full-archive search.

​
Usar los parámetros start_time y end_time para obtener Posts históricos

Al usar el endpoint full-archive search, por defecto se devolverán Posts de los últimos 30 días. Si quieres obtener Posts que tengan 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. Estos parámetros deben estar en un formato de fecha-hora RFC3339 válido, por ejemplo 2020-12-21T13:00:00.00Z. Así, si quieres obtener todos los Posts de la cuenta XDevelopers durante el mes de diciembre de 2020, tu llamada a la API será:

​
Obtener Posts históricos geoetiquetados

Los Posts geoetiquetados son Posts que tienen información geográfica asociada como ciudad, estado, país, etc.

​
Usar el operador has:geo

Si quieres obtener Posts que tengan datos geográficos, puedes usar el operador has:geo. Por ejemplo, la siguiente solicitud cURL obtendrá solo los Posts del handle @XDevelopers que tengan datos geográficos:

​
Usar el operador place_country

De igual manera, puedes limitar los Posts que tengan datos geográficos a un país específico, usando el operador place_country. El siguiente comando cURL obtendrá todos los Posts del handle @XDevelopers desde Estados Unidos:
El país se especifica arriba usando el código de caracteres ISO alpha-2. Los códigos ISO válidos se pueden encontrar aquí.

​
Obtener más de 500 Posts históricos usando el next_token

Como se mencionó anteriormente, por defecto solo puedes obtener hasta 500 Posts por solicitud para una consulta al endpoint full-archive search. Si hay más de 500 Posts disponibles para tu consulta, tu respuesta JSON incluirá un next_token que puedes añadir a tu llamada a la API para obtener los siguientes Posts disponibles para esta consulta. Este next_token está disponible en el objeto meta de tu respuesta JSON, que se ve algo así:
Por lo tanto, para obtener los siguientes Posts disponibles, usa el valor de next_token de este objeto meta y úsalo como valor para next_token en tu llamada a la API al endpoint full-archive search como se muestra abajo (usarás tu propio Bearer Token y el valor que obtengas para el Next Token de tu llamada anterior a la API).
De esta manera, puedes seguir comprobando si hay un next_token disponible y si no has alcanzado tu número deseado de Posts a recopilar, puedes seguir llamando al endpoint full-archive con el nuevo next_token para cada solicitud. A continuación se muestran algunos recursos que pueden ayudarte al usar el endpoint full-archive search. Nos encantaría escuchar tus comentarios. Contáctanos en @XDevelopers o en nuestros foros de la comunidad con preguntas sobre este endpoint.

​
Recursos adicionales