X Trends
Las tendencias de X son una instantánea, organizada por ubicación, de los temas públicos disponibles para un WOEID numérico, con el nombre de origen, la clasificación, la consulta, la descripción y la hora de recopilación reunidos. Esta estructura permite descubrir temas regionales y repetir la observación, y deja claro que cada registro refleja el momento de la recopilación y no una serie histórica de tendencias.
Funcionalidades de la X Trends API
- Recopilación por ubicaciónSolicite las tendencias públicas actuales de uno o más WOEID numéricos conocidos y conserve el identificador de origen en extra.woeid.
- Clasificación de origen conservadaMantiene la clasificación original en metrics.rank cuando está disponible, sin reemplazarla por una puntuación calculada por SocQ.
- Contexto útil de la tendenciaReciba el nombre de la tendencia con la consulta de origen y la descripción del proveedor cuando esos campos estén expuestos.
- Topes independientes por ubicaciónAplique results_limit por separado a cada WOEID enviado y recopile una sola vez el conjunto de tendencias disponible en ese momento para cada ubicación.
Parámetros de la X Trends API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
woeids | Obligatorio | Lista obligatoria de uno o más identificadores de ubicación de X conocidos, cada uno representado como una cadena numérica que no esté vacía. |
results_limit | Opcional | Tope entero opcional que se aplica por separado a cada WOEID. El valor predeterminado es 100 y se aceptan valores de 20 a 2,000. |
Cómo usar la X Trends API
Parta de los WOEID numéricos que ya conoce, elija un tope por ubicación y trate los registros devueltos como una instantánea del momento de la recopilación.
- Ingrese uno o más WOEID conocidos como cadenas numéricas; este endpoint no resuelve nombres de lugares.
- Elija un results_limit entero de 20 a 2,000 o conserve el valor predeterminado de 100 por WOEID.
- Envíe la solicitud por POST a /v1/x/trends y consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito.
- Lea data.results.items y siga el next_cursor del resultado de la tarea mientras has_more sea true.
curl -X POST "https://api.socq.ai/v1/x/trends" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"woeids":["1"],"results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la X Trends API
- Observar temas en un mercado conocido: Recopile los nombres, las clasificaciones y las descripciones actuales asociados a un identificador de ubicación que su sistema de monitoreo ya mantiene.
- Crear instantáneas de observación recurrentes: Ejecute el mismo WOEID con una programación que usted controle y almacene collected_at con cada resultado para analizar los cambios más adelante.
- Crear una cola de revisión de temas: Use el nombre, la consulta, la clasificación y la descripción devueltos para priorizar temas públicos para la revisión de analistas o para un flujo de descubrimiento posterior.
Consejos de expertos para la X Trends API
- Prepare los WOEID numéricos antes de enviar una tarea; no se aceptan nombres de lugares ni ubicaciones en texto libre.
- El valor predeterminado 1 sigue el ejemplo de solicitud publicado por el backend; reemplácelo por el identificador que corresponda al alcance que busca.
- Trate results_limit como un techo por WOEID, porque un conjunto de tendencias actual puede contener menos filas de las solicitadas.
- Ejecute las ubicaciones que se superponen en tareas separadas cuando importe conservar cada asociación entre tendencia y ubicación, porque nombres de tendencia idénticos pueden deduplicarse dentro de una misma tarea.
- Use collected_at como hora de observación; created_at es nulo porque el origen no expone una marca de tiempo de creación de la tendencia.
- Los cursores de resultados de la tarea recorren registros ya guardados y no solicitan otra página de tendencias al proveedor.
APIs relacionadas
Además de la X Trends 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.
- Twitter User Tweets Scraper API — Recolecta posts públicos recientes, autores, contenido multimedia, hashtags, menciones e interacción por nombre de usuario, sin incluir respuestas.
- Twitter Search API — Encuentra posts públicos mediante una expresión de búsqueda, con orden por más recientes o más populares y un límite de resultados configurable.
- 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.
- X Followers List API
- X Following List API
- X Post Quotes API
- X Post Replies 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