Saltar al contenido principal
La API pública de Wudlet entrega los mismos datos que ves en el panel: puntuación de visibilidad, prompts rastreados, menciones de competidores, citas y huecos de contenido. Está pensada para clientes enterprise (por ejemplo Custumu) que necesitan leer esa información por REST.
Esta sección documenta únicamente la API de lectura /v1. Las rutas internas del panel (/api/ai-visibility, autenticación de sesión, etc.) no forman parte de este contrato.

URL base

La API pública vive solo en producción:
https://api.wudlet.com/api/v1 es el mismo contrato. No uses localhost ni entornos de desarrollo: las integraciones (Custumu, Power BI, tu backend) deben apuntar siempre a https://api.wudlet.com.

Autenticación

Crea una clave en Configuración → Developer Settings (o Claves de API del proyecto). Las claves públicas empiezan por pk_live_ y las secretas por sk_live_. Cualquiera de las dos sirve para esta API si está activa y no ha caducado. Envía la clave en cada petición:
string
requerido
Bearer seguido de la clave. Ejemplo: Bearer sk_live_abc123.
string
Alternativa a Authorization. Mismo valor de la clave, sin el prefijo Bearer.
string
Zona horaria IANA para filtrar fechas (America/Guatemala, UTC). Si se omite, se usa UTC.
Si falta la clave, la API responde 401. Si está revocada, caducada o es inválida, también 401.

Alcance de la clave

Cada clave pertenece a un proyecto. Solo verás las marcas y los resultados de visibilidad de ese proyecto. No hace falta enviar org_id ni project_id en la URL.

Parámetros comunes

Muchos endpoints aceptan los mismos filtros de consulta:
uuid
Identificador de la marca. También se acepta brand con el dominio o el nombre. Si se omite, Wudlet usa la marca principal del proyecto.
date
Inicio del rango (YYYY-MM-DD), interpretado en la zona de X-Timezone.
date
Fin del rango (YYYY-MM-DD).
string
Uno o varios motores separados por coma. Ejemplo: chatgpt,claude,gemini.
integer
Página (empieza en 1).
integer
Tamaño de página. El máximo depende del endpoint (50–100).

Catálogo de endpoints

Marcas

Lista las marcas del proyecto asociado a la clave.

Visibilidad

Puntuación global y desglose por modelo de IA.

Instantánea

Score, prompts sin mención, competidores y brechas en una sola respuesta.

Prompts

Biblioteca de consultas y recuento de menciones.

Competidores

Marcas que la IA nombra en lugar de la tuya.

Citas

Dominios que los modelos citan en sus respuestas.

Brechas de contenido

Prompts que pierdes y ángulos de contenido para cerrarlos.

Errores

El cuerpo de error es JSON: { "error": "mensaje" }.

Custumu y otros clientes

Custumu consume esta API como cliente enterprise. En el backend de Custumu configura:
Custumu llama siempre a https://api.wudlet.com. Solo necesitas la clave de un proyecto de Wudlet. Custumu llama sobre todo a GET /v1/visibility/snapshot para mostrar si la marca aparece en las respuestas de IA y para redactar contenido a partir de los prompts que faltan.