Guía Consolidada - Búsquedas y Filtros de todas las APIs

Este documento consolida la información sobre creación de Workers y parámetros de búsqueda/filtrado de todas las APIs de TrawlingWeb.

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"
    ]
}

En este ejemplo, el Worker se crea con 5 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

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

Mejores búsquedas con la sintaxis 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:

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.

| palabra con idioma específico | Búsqueda de tweets publicados en un idioma específico. Ha de ser en ISO Alpha II | pepsi lang:fr | devolverá posts que contienen "pepsi" publicados en francés (ISO Alpha II: fr) |

Caracteres reservados en palabras de búsqueda

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

API Facebook - 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://facebook.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 Facebook (hashtags, menciones, operadores booleanos, etc.).

Ejemplo de body en formato JSON:

{
    "description": "Worker de ejemplo para monitoreo de marcas",
    "words": [
        "cocacola",
        "#pepsi",
        "@cocacola",
        "Cocacola (__) Pepsi",
        "\"cocacola con hielo\""
    ]
}

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

1. Una palabra simple: "cocacola"
2. Un hashtag: "#pepsi"
3. Una mención: "@cocacola"
4. Una búsqueda con OR usando (): "Cocacola () Pepsi"
5. Una búsqueda exacta entre comillas: "cocacola con hielo"

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

Mejores búsquedas con la sintaxis de Facebook

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

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

Caracteres reservados en palabras de búsqueda

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

API Instagram - 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://instagram.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 Instagram (hashtags, menciones, etc.).

Ejemplo de body en formato JSON:

{
    "description": "Worker de ejemplo para monitoreo de marcas",
    "words": [
        "#pepsi",
        "@cocacola",
        "#openai"
    ]
}

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

1. Un hashtag: "#pepsi"
2. Una mención: "@cocacola"
3. Un hashtag específico: "#openai"

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

Mejores búsquedas con la sintaxis de Instagram

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

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

Caracteres reservados en palabras de búsqueda

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

API TikTok - 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://tiktok.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 TikTok (hashtags, menciones, etc.).

Ejemplo de body en formato JSON:

{
    "description": "Worker de ejemplo para monitoreo de marcas",
    "words": [
        "#pepsi",
        "@cocacola",
        "#openai"
    ]
}

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

1. Un hashtag: "#pepsi"
2. Una mención: "@cocacola"
3. Un hashtag específico: "#openai"

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

Mejores búsquedas con la sintaxis de TikTok

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

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

Caracteres reservados en palabras de búsqueda

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

API NEWS & BLOGS - Parámetro de filtrado

API NEWS & BLOGS - Parámetros de Filtrado

Los filtros son atributos asignados por TrawlingWeb a cada elemento durante su proceso de auditoría de fuentes y resultados. Estos filtros permiten especificar criterios detallados para obtener únicamente los datos que necesitas. Al aplicar estos filtros en tus consultas, puedes afinar los resultados para que se ajusten mejor a tus requisitos específicos. A continuación, se describen los filtros disponibles:

La forma de asignar una expresión de filtro

q = "(_filtro1_: __valor1__) operador (_filtro2_ : valor2) operador ... (_filtroN_ : valorN)"

En esta expresión se ha añadido espacios entre los términos con el fin de claridad pero hay que evitarlos durante la realización de consultas.

Más información sobre las posibilidades de combinación y búsqueda

Para más información sobre operadores y sintaxis de Lucene, puede consultar la sección 07: Mejores Prácticas. También puede consultar el manual completo de sintaxis de Lucene aquí, siendo esta nuestra base de motor de búsqueda.

Escapar caracteres reservados

Si necesita utilizar cualquiera de los caracteres que funcionan como operadores de su propia consulta (y no como operadores), entonces usted debe escaparlos con una barra invertida inicial. Por ejemplo, para buscar url:https://www.linkedin.com , lo que se necesita para escribir su consulta como url:https :\ / \ / www.linkedin.com

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

El no poder escapar de estos caracteres especiales correctamente podría dar lugar a un error de sintaxis que impide que la consulta se ejecute de forma correcta.

Ejemplos de filtros y booleanas dentro de q=

Como hemos explicado en la sección 03 Consultas, las APIs de TrawlingWeb aceptan consultas booleanas combinadas con expresiones de la sintaxis de Lucene.

La q= permite el filtrado y optimización de la consulta para obtener los mejores resultados posibles. Dentro de q= puedes utilizar parámetros de filtrado (ver ), que son atributos asignados por TrawlingWeb a cada elemento, así como expresiones booleanas que son características de la información indexada.

Recuerda que en la sección 03 Consultas hay una lista más completa de expresiones booleanas que puedes combinar con los filtros dentro de q=. A continuación, algunos ejemplos de parámetros de filtrado.

API YOUTUBE - Consultas básicas

El API permite las mismas consultas que se realizan al actual buscador de la web de Youtube. Los criterios en que se aplican al filtrar los vídeos son establecidos por la propia Youtube.

Booleanas

Los paréntesis

Utilice paréntesis para encapsular declaraciones OR para que los motores de búsqueda ejecuten la consulta de forma correcta.

Por ejemplo: (Barcelona|Madrid|París)

Otros términos filtrables

Búsqueda de vídeos con términos juntos

Tortilla patata casera

Búsqueda de vídeos con términos en el título

allintitle:Walt Disney

Búsqueda de vídeos que contienen combinaciones de palabras

"U2 Melbourne 2006"

Búsqueda de vídeos en canal

Elvis Presley, channel

Búsqueda de vídeos peliculas

Charlie Chaplin, movie

Búsqueda de vídeos en 4k

Tokio, 4k

Búsqueda de vídeos en HD

Trailer de Star Trek, hd

Búsqueda de vídeos en SD

Moscú, sd

Búsqueda de vídeos en ED

Madagascar, 3d

Búsqueda de vídeos por duración inferior a 2 minutos

Simpsons, short

Búsqueda de vídeos por duración mínima de 20 minutos

Spiderman, long

Búsqueda de vídeos en directo

zoo, live

Búsqueda de vídeos por tiempo

noticias, today
noticias, this week
noticias, this month
noticias, this year

Búsqueda de vídeos en canales oficiales

The show must go on, partner

Búsqueda de vídeos en playlist

Queen, playlist

Búsqueda de vídeos usando el concepto booleano (NOT)

android -china

Búsqueda de vídeos usando el concepto booleano (AND)

Barcelona AND Paris

Búsqueda de vídeos usando el concepto booleano (OR)

Barcelona OR Paris

Búsqueda de vídeos combinando los anteriores

(Barcelona AND Paris) -messi ,4k , long

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