Visibilidad

GET

visibility

curl "https://api.wudlet.com/v1/visibility?brand_id=c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a" \
  -H "Authorization: Bearer sk_live_..." \
  -H "X-Timezone: America/Guatemala"

{
  "brand": {
    "id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
    "name": "Custumu",
    "domain": "https://custumu.com",
    "industry": "SaaS"
  },
  "overall_score": 42,
  "models": [
    {
      "model": "chatgpt",
      "score": 38,
      "mention_rate": 0.31
    }
  ]
}

Calcula el score global y las métricas por modelo (ChatGPT, Claude, Gemini, Perplexity, etc.) a partir de los resultados de escaneo.

string

requerido

Bearer más la clave de API del proyecto.

string

Zona horaria IANA para start_date y end_date. Por defecto UTC.

uuid

Marca a consultar. Si se omite, se usa la marca principal del proyecto.

date

Inicio del periodo (YYYY-MM-DD).

date

Fin del periodo (YYYY-MM-DD).

string

Filtra por motor. Varios valores separados por coma: chatgpt,claude.

curl "https://api.wudlet.com/v1/visibility?brand_id=c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a" \
  -H "Authorization: Bearer sk_live_..." \
  -H "X-Timezone: America/Guatemala"

{
  "brand": {
    "id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
    "name": "Custumu",
    "domain": "https://custumu.com",
    "industry": "SaaS"
  },
  "overall_score": 42,
  "models": [
    {
      "model": "chatgpt",
      "score": 38,
      "mention_rate": 0.31
    }
  ]
}

Cómo leer el score

overall_score resume con qué frecuencia y en qué posición aparece la marca en las respuestas rastreadas. Un valor 0 significa que, en el periodo consultado, la marca no aparece en las respuestas de los motores activos. El arreglo models desglosa el mismo cálculo por motor para que puedas ver, por ejemplo, que Claude te menciona y ChatGPT no.

curl "https://api.wudlet.com/v1/visibility?brand_id=c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a" \
  -H "Authorization: Bearer sk_live_..." \
  -H "X-Timezone: America/Guatemala"

{
  "brand": {
    "id": "c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a",
    "name": "Custumu",
    "domain": "https://custumu.com",
    "industry": "SaaS"
  },
  "overall_score": 42,
  "models": [
    {
      "model": "chatgpt",
      "score": 38,
      "mention_rate": 0.31
    }
  ]
}

Empezar

Conceptos principales

Usando Wudlet

Optimización GEO y SEO

Agentes

Crawler Analytics

API REST

Cómo leer el score

​Cómo leer el score

Cómo leer el score