x/
search

Busque posts públicos de X con una expresión concreta, elija el orden por más recientes o destacados y reciba el contenido coincidente, los autores, la interacción, los archivos multimedia, las entidades y el contexto de la consulta de origen.

Twitter Search API

Descubrimiento por consulta
Más recientes o Top
Rastreo de la consulta de origen
0.7 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
queryObligatorioPalabra 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_limitOpcionalTope opcional de resultados solicitados. El valor predeterminado es 20 y se aceptan múltiplos de 20 de 20 a 2,000.
sort_byOpcionalOrden 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.

  1. Escriba una expresión concreta y no vacía para los posts de X que quiera encontrar.
  2. Seleccione latest o top y elija un results_limit de 20 a 2,000 en incrementos de 20.
  3. Envíe la solicitud por POST a /v1/x/search y consulte /v1/tasks/{task_id} hasta que termine.
  4. 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 true

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

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.

Explorar otras plataformas

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

Twitter Search API — FAQ

Twitter Search API encuentra posts públicos de X para una expresión de búsqueda. Devuelve el contenido estructurado de los posts, los autores, la interacción, los archivos multimedia, las entidades, las relaciones y la consulta de origen.

Use una palabra clave o una expresión de búsqueda que no esté vacía y que describa la marca, el producto, el evento, la frase o el tema que quiere investigar.

Elija latest para priorizar las coincidencias recientes y top para revisar las coincidencias destacadas. latest es el valor predeterminado.

results_limit tiene un valor predeterminado de 20 y acepta múltiplos de 20 de 20 a 2,000. Define la cantidad máxima de resultados solicitados.

Un resultado puede incluir el texto, el idioma, los datos del autor, la interacción visible, los archivos multimedia, los hashtags, las menciones, las marcas de tiempo y las relaciones de la conversación.

Sí. extra.search_query contiene la expresión enviada, de modo que la coincidencia puede seguir vinculada a su regla de descubrimiento.

El límite es un techo de recopilación, mientras que la cantidad real refleja las coincidencias públicas elegibles disponibles cuando se ejecuta la tarea.

Cada resultado de búsqueda normalizado que se devuelve cuesta 0.7 créditos de SocQ.