x/
trends

Recopile las tendencias públicas actuales de X para uno o más WOEID numéricos, con clasificación de origen, consulta, descripción, contexto de ubicación y hora de recopilación.

X Trends API

Instantáneas por WOEID
Clasificación de origen
Contexto de ubicación
0.5 créditos por resultado
Listo
README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
woeidsObligatorioLista 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_limitOpcionalTope 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.

  1. Ingrese uno o más WOEID conocidos como cadenas numéricas; este endpoint no resuelve nombres de lugares.
  2. Elija un results_limit entero de 20 a 2,000 o conserve el valor predeterminado de 100 por WOEID.
  3. Envíe la solicitud por POST a /v1/x/trends y consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito.
  4. 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 true

Casos 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.

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.

Explorar otras plataformas

Combine los datos de X con datos públicos de otras plataformas sociales compatibles.

X Trends API — FAQ

X Trends API es una interfaz programática para recopilar instantáneas de las tendencias públicas actuales de X por WOEID numérico.

Envíe uno o más identificadores de ubicación conocidos como cadenas numéricas. El endpoint no traduce el nombre de una ciudad o de un país a un WOEID.

Su valor predeterminado es 100, acepta enteros de 20 a 2,000 y se aplica por separado a cada WOEID. El origen puede exponer menos tendencias actuales que el tope solicitado.

Un registro contiene el nombre de la tendencia como id y text, una clasificación de origen cuando existe, collected_at y campos extra con el WOEID, la consulta y la descripción cuando están disponibles.

No. Devuelve una instantánea actual de cada WOEID solicitado; para crear un historial, programe y almacene ejecuciones repetidas en su propio sistema.

Los registros guardados se deduplican por nombre de tendencia normalizado dentro de una tarea. Si el mismo nombre aparece en varias ubicaciones enviadas, el primer registro guardado puede conservar un solo valor de extra.woeid.

Cada tendencia normalizada que se guarda correctamente cuesta 0.5 créditos de SocQ. La estimación usa results_limit para cada WOEID enviado, y los créditos cobrados por adelantado que no se usen se reembolsan cuando la tarea se liquida.