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

Respuesta de salida - RESPONSE

Una vez lanzada una petición al API de Instagram é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:

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

Mejores búsquedas con la sintaxy 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: + - = & | > < ! ¡ () {} [] ^ " ~ * ¿ ?: \ / ' -

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