Vortex API v1 — Documentación Oficial

🚀 Guía Rápida de Integración

📊 En Google Sheets (Directo)

Pega esta fórmula en cualquier celda de tu hoja para importar todas las métricas en vivo:

=IMPORTDATA("https://vortex.lat/api/v1/export/csv")

🐍 En Python (Pandas / Requests)

Descarga a un DataFrame de pandas en 2 líneas:

import requests
res = requests.get("https://vortex.lat/api/v1/metrics/live").json()
stores = res["data"] # Lista completa de métricas

⚡ En JavaScript / Make / Zapier

Petición estándar con Fetch API:

const res = await fetch("https://vortex.lat/api/v1/summary");
const { summary } = await res.json();
console.log(summary.weighted_avg_cpr_today);

📚 Catálogo de Endpoints Disponibles

GET /api/v1/summary

Retorna el resumen ejecutivo global consolidado del día: gasto total, mensajes totales, CPR promedio ponderado, ventas BPO y presupuesto total de todas las tiendas.

Respuesta en Vivo (JSON):

Cargando...

GET /api/v1/stores

Retorna el directorio oficial de tiendas con metadata: teléfono, nombre, categoría/producto, trafficker asignado, coordinador y presupuesto oficial.

Parámetro	Tipo	Descripción	Ejemplo
trafficker	string	Filtra por trafficker	`Julio` o `Oscar`
category	string	Filtra por categoría/producto	`CAMISETAS`, `SHORTS`
coordinator	string	Filtra por coordinador	`Alejandra`, `Gomez`
search	string	Búsqueda por texto en nombre o teléfono	`shop` o `311`

Respuesta en Vivo (JSON):

Cargando...

GET /api/v1/metrics/live

El endpoint principal: Cruce en tiempo real por tienda de gasto, mensajes, CPR hoy, ventas BPO de LogiGho, tasa de conversión, CPR 7 días y estado de alerta de fuga.

Parámetro	Tipo	Descripción	Ejemplo
trafficker	string	Filtra tiendas de un trafficker	`?trafficker=Julio`
category	string	Filtra por producto	`?category=SHORTS`
alert	string	Filtra por alerta	`FUGA_SIN_MENSAJES`, `CPR_ALTO`
sort	string	Campo para ordenar	`today_spend`, `today_cpr`, `bpo_sales`

Respuesta en Vivo (JSON):

Cargando...

GET /api/v1/metrics/hourly

Historial desglosado hora por hora (00:00 a 23:00) de gasto, mensajes y CPR para cada tienda y para el total general.

Parámetro	Tipo	Descripción	Ejemplo
phone	string	Filtra una sola tienda por teléfono	`?phone=3115231867`
date	string	Fecha específica (DD-MM-YYYY)	`?date=30-10-2026`

Respuesta en Vivo (JSON):

Cargando...

GET /api/v1/bpo/sales

Reportes de ventas confirmadas de LogiGho BPO recibidos por OCR y sincronizaciones.

Respuesta en Vivo (JSON):

Cargando...

GET /api/v1/budget/recommendations

Recomendaciones inteligentes de presupuesto generadas por la IA con validación de 7 días, piso de $50k y guardrails de Meta Ads.

Respuesta en Vivo (JSON):

Cargando...

CSV /api/v1/export/csv

⬇ Descargar CSV

Exporta todas las métricas en formato CSV con comas. Compatible con la función =IMPORTDATA() de Google Sheets o para abrir directamente en Microsoft Excel.