API Twitter - Método POST /create

Permite crear nuevos Workers con sus palabras.

¿Qué es un Worker?

Un Worker en TrawlingWeb es una entidad configurada por el usuario para realizar búsquedas específicas en redes sociales utilizando Palabras Clave. Estas Palabras Clave son términos de búsqueda configurados dentro del Worker y se basan en los créditos contratados (1 crédito = 1 Palabra Clave).

Creación y Configuración de Workers

El usuario puede crear y definir los términos de búsqueda para cada Worker directamente en el dashboard (https://dashboard.trawlingweb.com/workers) o utilizando el método proporcionado por la API. Una vez creado un Worker, este comienza su despliegue para iniciar su labor de configuración, que puede tardar hasta una hora.

Funcionalidad de los Workers

• Palabras clave: Los Workers funcionan como una lista de palabras clave. Usan las Palabras Clave configuradas para realizar búsquedas en redes sociales.
• Proceso de búsqueda: Los Workers entregan las palabras clave a las arañas de TrawlingWeb para que ejecuten sus búsquedas en la red social.
• Proceso de entrega: Cada vez que el cliente llama al Worker, este utiliza la lista de palabras clave para lanzar la búsqueda contra la base de datos de resultados obtenidos por TrawlingWeb y recuperar solo aquellos resultados que tienen relación con la lista de palabras clave.

Implementar y gestionar Workers de manera eficiente permite a los usuarios maximizar la relevancia y precisión de los datos procesados, adaptándose a las necesidades específicas de sus análisis y monitoreo en redes sociales.

Parámetros POST

Veamos la estructura de la consulta de ejemplo:

https://twitter.trawlingweb.com/create/?token={APIKEY}

Parámetros PATH:

Parámetros QUERY:

Parámetros BODY:

Estructura del parámetro words

El parámetro words debe enviarse como un array JSON de cadenas de texto, donde cada elemento del array representa una Palabra Clave. Cada Palabra Clave puede contener sintaxis avanzada de Twitter (hashtags, menciones, operadores booleanos, filtros, etc.).

Recomendación importante para búsquedas con from:: Cuando necesites buscar tweets de múltiples cuentas, puedes encadenar hasta un máximo de 10 cuentas usando el operador OR dentro de una misma expresión. Esto permite optimizar el uso de créditos al agrupar múltiples cuentas en una sola Palabra Clave.

Ejemplo de body en formato JSON:

{
  "description": "Worker de ejemplo para monitoreo de marcas",
  "words": [
    "from:cocacola OR from:pepsi OR from:trawlingweb",
    "cocacola",
    "#pepsi",
    "cocacola lang:fr",
    "itau geocode:-25.2867,-57.647,250km OR ueno geocode:-25.2867,-57.647,250km OR basa geocode:-25.2867,-57.647,250km",
    "itau geocode:-25.2867,-57.647,250km min_faves:200",
    "cocacola filter:videos min_faves:100",
    "itau geocode:-25.2867,-57.647,250km min_faves:50 -from:itauparaguay",
    "cocacola min_replies:10",
    "cocacola min_retweets:10"
  ]
}

En este ejemplo, el Worker se crea con 10 Palabras Clave:

1. Una búsqueda compleja con múltiples cuentas usando el operador OR (máximo 10 cuentas por expresión)
2. Una palabra simple: "cocacola"
3. Un hashtag: "#pepsi"
4. Una palabra con filtro de idioma: "cocacola lang:fr"
5. Una búsqueda geográfica encadenada con múltiples términos usando geocode y OR
6. Una combinación de palabra, geocodificación y filtro de popularidad: "itau geocode:-25.2867,-57.647,250km min_faves:200"
7. Una búsqueda de videos virales: "cocacola filter:videos min_faves:100"
8. Una búsqueda con exclusión de cuenta oficial: "itau geocode:-25.2867,-57.647,250km min_faves:50 -from:itauparaguay"
9. Una búsqueda con filtro de respuestas: "cocacola min_replies:10"
10. Una búsqueda con filtro de retweets: "cocacola min_retweets:10"

Cada elemento del array words consume 1 crédito (1 crédito = 1 Palabra Clave).

Respuesta de salida - RESPONSE

Una vez lanzada una petición al API de Twitter éste devolverá una respuesta estructurada de la siguiente forma:

Status 200 - Datos de la retorno

Ejemplo de respuesta en formato json:

"response" : {
    "worker" : "...",
    "msg" : "..."
}

Status 400 - Datos de la retorno

Ejemplo de respuesta en formato json:

"response" : {
    "error" : "..."
}

Mejores búsquedas con la sintaxy de Twitter

Twitter utiliza su propia sintaxis avanzada para ejecutar búsquedas específicas y detalladas dentro de su plataforma. Esta sintaxis permite filtrar resultados por palabras clave, hashtags, menciones, ubicaciones y fechas, entre otros parámetros. Además, al definir palabras clave para un Worker, es posible utilizar esta misma sintaxis para lanzar consultas precisas contra el buscador de Twitter. Esto maximiza la eficiencia y relevancia de los datos procesados por cada Worker, facilitando una monitorización y análisis más efectivos de las conversaciones en Twitter.

Aquí tienes un listado de los elementos que puedes combinar con tus palabras clave al crearlas dentro de un worker, organizados por categorías:

Búsquedas básicas y de precisión

Estos elementos te permiten refinar y precisar tus búsquedas por tipo de contenido, ubicación, cuentas, idioma y otros filtros específicos:

Búsquedas por popularidad

Estos elementos te permiten filtrar resultados por número de likes (favoritos), respuestas y retweets, útil para encontrar contenido viral o popular:

Búsquedas por frescura en el tiempo

Estos elementos te permiten filtrar resultados por fechas específicas o rangos temporales:

Combinación de múltiples expresiones

Una de las características más potentes de la sintaxis de Twitter es la capacidad de combinar múltiples expresiones y filtros en una sola Palabra Clave. X (Twitter) interpreta cada espacio como un operador AND implícito, lo que significa que puedes encadenar diferentes filtros simplemente separándolos por espacios.

Reglas importantes para combinar expresiones:

1. Separación por espacios (AND implícito): Cada espacio entre expresiones actúa como un "Y además". Por ejemplo:

   • itau geocode:-25.2867,-57.647,250km min_faves:200 significa: "itau" Y geocodificado en esa ubicación Y con al menos 200 likes.

2. Sin espacios después de los dos puntos: Es crítico que no haya espacios después de los dos puntos en los comandos:

   • ✅ Correcto: min_faves:200
   • ❌ Incorrecto: min_faves: 200

3. Combinación de filtros de contenido: Puedes combinar filtros de tipo de contenido con otros parámetros:

   • filter:videos - Solo tweets con videos
   • filter:images - Solo tweets con imágenes
   • filter:links - Solo tweets con enlaces

4. Exclusiones con prefijo menos (-): Puedes excluir cuentas, palabras o términos usando el prefijo menos:

   • -from:cuenta - Excluye tweets de esa cuenta
   • -palabra - Excluye tweets que contengan esa palabra

Ejemplos prácticos de combinaciones:

Búsqueda de videos virales en una ubicación específica:

itau geocode:-25.2867,-57.647,250km min_faves:200 filter:videos

Busca videos sobre "itau" en Paraguay con al menos 200 likes.

Búsqueda excluyendo cuentas oficiales:

itau geocode:-25.2867,-57.647,250km min_faves:50 -from:itauparaguay

Busca menciones de "itau" en Paraguay con al menos 50 likes, excluyendo la cuenta oficial.

Búsqueda en un rango de fechas con filtro de popularidad:

itau geocode:-25.2867,-57.647,250km min_faves:100 until:2024-01-01 since:2023-01-01

Busca menciones de "itau" en Paraguay durante 2023 con al menos 100 likes.

Búsqueda de imágenes en un idioma específico:

cocacola lang:es filter:images min_faves:20

Busca imágenes sobre "cocacola" en español con al menos 20 likes.

Búsqueda con filtro de respuestas:

cocacola min_replies:10

Busca tweets sobre "cocacola" con al menos 10 respuestas.

Búsqueda con filtro de retweets:

cocacola min_retweets:10

Busca tweets sobre "cocacola" con al menos 10 retweets.

Búsqueda combinando múltiples métricas de engagement:

cocacola min_faves:100 min_retweets:50 min_replies:20

Busca tweets sobre "cocacola" con al menos 100 likes, 50 retweets y 20 respuestas.

Nota sobre filtros de popularidad (min_faves, min_replies, min_retweets) y orden de resultados:

Cuando uses min_faves:, min_replies: o min_retweets: con un número alto, X suele mostrar los resultados en la pestaña "Destacados" (Top) de forma automática. Si cambias a "Más reciente", verás los tweets que alcanzaron ese número de interacciones ordenados por fecha.

Recomendación: Si no aparecen resultados con un valor alto en estos filtros, prueba bajando el número (por ejemplo, min_faves:20, min_replies:5 o min_retweets:5) para verificar que la sintaxis es correcta y que hay contenido disponible.

Notas importantes sobre búsquedas geográficas

Geocodificación (geocode:): X (Twitter) no admite el comando country: ni una sintaxis directa por código de país (como country:es). El método más preciso para filtrar resultados por ubicación geográfica es usar geocode: con coordenadas GPS exactas.

Sintaxis de geocode:

• Formato: geocode:latitud,longitud,radio
• Ejemplo: itau geocode:-25.2867,-57.647,250km busca menciones de "itau" dentro de un radio de 250km desde Asunción, Paraguay.
• Las coordenadas deben estar en formato decimal (latitud,longitud).
• El radio puede especificarse en kilómetros (km) o millas (mi).

Encadenar múltiples búsquedas con OR: Puedes combinar múltiples términos de búsqueda con geocodificación usando el operador OR dentro de una misma Palabra Clave. Esto permite optimizar el uso de créditos al agrupar búsquedas relacionadas en una sola Palabra Clave:

{
  "description": "Worker para búsqueda geográfica de múltiples términos en Paraguay",
  "words": [
    "itau geocode:-25.2867,-57.647,250km OR ueno geocode:-25.2867,-57.647,250km OR basa geocode:-25.2867,-57.647,250km"
  ]
}

Este ejemplo busca menciones de "itau", "ueno" o "basa" dentro de un radio de 250km desde Asunción, Paraguay, utilizando solo 1 crédito.

Comparación de métodos geográficos:

• geocode: - Más preciso, requiere coordenadas GPS exactas. Recomendado para búsquedas profesionales.
• near: + within: - Menos preciso, funciona con nombres de ciudades pero puede ser menos exacto.
• lang: - Filtra por idioma del tweet, no por ubicación física. Útil cuando el objetivo es filtrar por idioma en lugar de ubicación.

Nota importante: Los filtros geográficos solo funcionan con tweets de usuarios que tienen activada la ubicación en sus publicaciones o en su perfil de forma pública.

Tabla de coordenadas de capitales para búsquedas geográficas

A continuación se presenta una tabla con las coordenadas GPS de las principales capitales de Latinoamérica y Europa, junto con ejemplos de búsqueda usando geocode: y el radio recomendado para abarcar la mayor parte del territorio de cada país:

Capitales de Latinoamérica

Capitales de Europa

Nota: Los radios recomendados están calculados para abarcar la mayor parte del territorio de cada país. Puedes ajustar el radio según tus necesidades específicas de búsqueda.

Caracteres reservados en palabras de búsqueda

Los caracteres reservados son: + - = & | > < ! ¡ () {} [] ^ " ~ * ¿ ?: \ / ' -

Contacto

Si tienes alguna pregunta, necesitas asistencia, contratar o ampliar tus servicios por favor contacta con nosotros.

SAT (Soporte Técnico):

• Correo SAT
• Documentación Oficial

SAC (Soporte administrativo):

• Correo SAC

Sales (Soporte ventas):

• Correo Ventas