Twitter Search
Los resultados de búsqueda de X son posts públicos seleccionados para una consulta, que incluyen el idioma, el autor, los archivos multimedia, las entidades, el contexto de la conversación y la interacción visible de cada coincidencia. Conservar la consulta junto a cada registro facilita auditar los análisis periódicos de temas, la escucha de lanzamientos y las comparaciones entre conjuntos de resultados.
Funcionalidades de la Twitter Search API
- Descubrimiento a partir de una expresiónEnvíe una palabra clave o una expresión de búsqueda que no esté vacía y convierta los posts públicos de X que coincidan en registros estructurados.
- Orden para dos modos de investigaciónUse latest para seguir las coincidencias recientes o top para revisar las coincidencias destacadas; latest es el valor predeterminado.
- Un tope práctico de resultados de búsquedaSolicite de 20 a 2,000 resultados en incrementos de 20 para fijar la profundidad máxima de la recopilación de la búsqueda.
- Coincidencias que conservan su consultaCombina el texto, el autor, la interacción, los archivos multimedia, las entidades, las marcas de tiempo y los campos de relaciones con extra.search_query y collected_at.
Parámetros de la Twitter Search API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Palabra clave o expresión de búsqueda de posts de X obligatoria y no vacía, que se usa para descubrir posts públicos coincidentes. |
results_limit | Opcional | Tope opcional de resultados solicitados. El valor predeterminado es 20 y se aceptan múltiplos de 20 de 20 a 2,000. |
sort_by | Opcional | Orden opcional: latest para las coincidencias recientes o top para las coincidencias destacadas. El valor predeterminado es latest. |
Cómo usar la Twitter Search API
Formule una pregunta de investigación precisa como expresión de búsqueda, elija el orden que mejor se ajuste y conserve la consulta junto con los posts resultantes.
- Escriba una expresión concreta y no vacía para los posts de X que quiera encontrar.
- Seleccione latest o top y elija un results_limit de 20 a 2,000 en incrementos de 20.
- Envíe la solicitud por POST a /v1/x/search y consulte /v1/tasks/{task_id} hasta que termine.
- Almacene data.results.items y siga next_cursor hasta que has_more sea false.
curl -X POST "https://api.socq.ai/v1/x/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"artificial intelligence","results_limit":40,"sort_by":"latest"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Twitter Search API
- Escuchar en torno a un lanzamiento concreto: Busque un producto, una versión, una conferencia o la frase de una campaña y organice los posts coincidentes por hora de publicación y de recopilación.
- Seguir las menciones de marcas y productos: Reúna autores, texto, interacción visible, hashtags, menciones y archivos multimedia para un nombre o una frase concretos.
- Mapear un tema en desarrollo: Use los resultados latest para seguir los posts nuevos y los resultados top para examinar el contenido destacado dentro de la misma expresión de investigación.
- Mantener un conjunto de datos de consulta recurrente: Almacene extra.search_query con cada coincidencia, vuelva a ejecutar una expresión versionada y agregue solo los ID de post que no se habían visto antes.
Consejos de expertos para la Twitter Search API
- Comience con una expresión concreta, revise las coincidencias y amplíe la redacción solo cuando la cobertura sea demasiado limitada.
- Elija latest para la escucha sensible al tiempo y top cuando las coincidencias destacadas importen más que el orden cronológico.
- Defina results_limit como un múltiplo de 20 e interprételo como un tope y no como una cantidad garantizada de resultados.
- Versione la consulta cada vez que cambien sus términos para que los conjuntos de resultados recurrentes sigan siendo comparables.
- Deduplique por el id del post y conserve extra.search_query y collected_at como contexto del descubrimiento.
APIs relacionadas
Además de la Twitter Search API, use estas APIs cuando necesite otro tipo de datos públicos de X.
- Twitter Tweet Scraper API — Obtiene el texto de posts públicos, autores, interacción, contenido multimedia, hashtags, menciones y relaciones de conversación desde URLs de estado de x.com o twitter.com.
- Twitter Profile Scraper API — Obtiene por nombre de usuario la identidad de la cuenta pública, biografías, avatares, imágenes de portada, estado de la cuenta y estadísticas visibles de audiencia.
- X Post Replies API — Recolecta respuestas públicas de URLs de posts de X con orden seleccionable, texto de la respuesta, autores, interacción visible, contenido multimedia y contexto del post principal.
- X Trends API — Recolecta instantáneas de las tendencias públicas actuales de X para WOEIDs numéricos conocidos, con posición de origen, consulta, descripción y contexto de ubicación.
- Twitter User Search API — Encuentra cuentas públicas de X por palabra clave.
- X Communities Search API — Encuentra comunidades por palabra clave, con el número de miembros y un enlace listo para los endpoints de miembros y posts.
- Twitter User Tweets Scraper API
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Retweeters API
- Twitter Mentions API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Articles API
- X Spaces API
- Twitter Media Scraper API
- X User Replies API
- Twitter Follow Checker API
- Twitter Video Transcript API