API REST
Instantánea de visibilidad
Una sola llamada con score, prompts sin mención, competidores y brechas de contenido. Es el endpoint que usa Custumu.
GET
/
v1
/
visibility
/
snapshot
curl "https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com" \
-H "Authorization: Bearer sk_live_..." \
-H "X-Timezone: America/Guatemala"
const res = await fetch(
"https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com",
{
headers: {
Authorization: "Bearer sk_live_...",
"X-Timezone": "America/Guatemala",
},
}
);
const snapshot = await res.json();
{
"brand": {
"id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
"name": "Custumu",
"domain": "https://custumu.com",
"industry": "SaaS"
},
"overall_score": 18,
"models": [],
"visible": true,
"competitors": [
{
"name": "Otra marca",
"domain": "ejemplo.com",
"mentionCount": 12,
"visibility": 40
}
],
"missing_prompts": [
{
"id": 42,
"prompt": "¿Cuál es la mejor herramienta para escribir en la voz de mi marca?",
"category": "consideracion",
"responses": 8,
"mentions": 0
}
],
"content_gaps": {
"summary": {
"totalGaps": 6,
"highIntentCount": 2,
"topWinningCompetitor": "Otra marca",
"avgOpportunityScore": 72
},
"items": [],
"total": 6
}
}
Pensado para productos de contenido (Custumu) y paneles externos: en una petición obtienes si la marca es visible, qué prompts pierde y qué contenido conviene escribir.
Custumu toma
curl "https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com" \
-H "Authorization: Bearer sk_live_..." \
-H "X-Timezone: America/Guatemala"
const res = await fetch(
"https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com",
{
headers: {
Authorization: "Bearer sk_live_...",
"X-Timezone": "America/Guatemala",
},
}
);
const snapshot = await res.json();
{
"brand": {
"id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
"name": "Custumu",
"domain": "https://custumu.com",
"industry": "SaaS"
},
"overall_score": 18,
"models": [],
"visible": true,
"competitors": [
{
"name": "Otra marca",
"domain": "ejemplo.com",
"mentionCount": 12,
"visibility": 40
}
],
"missing_prompts": [
{
"id": 42,
"prompt": "¿Cuál es la mejor herramienta para escribir en la voz de mi marca?",
"category": "consideracion",
"responses": 8,
"mentions": 0
}
],
"content_gaps": {
"summary": {
"totalGaps": 6,
"highIntentCount": 2,
"topWinningCompetitor": "Otra marca",
"avgOpportunityScore": 72
},
"items": [],
"total": 6
}
}
Campos útiles para contenido
| Campo | Uso |
|---|---|
visible | true si overall_score es mayor que 0. |
missing_prompts | Consultas rastreadas sin ninguna mención de la marca. |
content_gaps.items | Huecos priorizados (intención, competidores, acción recomendada). |
competitors | Marcas que la IA recomienda en su lugar. |
missing_prompts y content_gaps para proponer “escribe esto” y generar el borrador en la voz de la marca.⌘I
curl "https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com" \
-H "Authorization: Bearer sk_live_..." \
-H "X-Timezone: America/Guatemala"
const res = await fetch(
"https://api.wudlet.com/v1/visibility/snapshot?brand=custumu.com",
{
headers: {
Authorization: "Bearer sk_live_...",
"X-Timezone": "America/Guatemala",
},
}
);
const snapshot = await res.json();
{
"brand": {
"id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
"name": "Custumu",
"domain": "https://custumu.com",
"industry": "SaaS"
},
"overall_score": 18,
"models": [],
"visible": true,
"competitors": [
{
"name": "Otra marca",
"domain": "ejemplo.com",
"mentionCount": 12,
"visibility": 40
}
],
"missing_prompts": [
{
"id": 42,
"prompt": "¿Cuál es la mejor herramienta para escribir en la voz de mi marca?",
"category": "consideracion",
"responses": 8,
"mentions": 0
}
],
"content_gaps": {
"summary": {
"totalGaps": 6,
"highIntentCount": 2,
"topWinningCompetitor": "Otra marca",
"avgOpportunityScore": 72
},
"items": [],
"total": 6
}
}