> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wudlet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visibilidad

> Puntuación de visibilidad de la marca en los motores de IA rastreados.

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

<ParamField header="Authorization" type="string" required>
  `Bearer` más la clave de API del proyecto.
</ParamField>

<ParamField header="X-Timezone" type="string">
  Zona horaria IANA para `start_date` y `end_date`. Por defecto `UTC`.
</ParamField>

<ParamField query="brand_id" type="uuid">
  Marca a consultar. Si se omite, se usa la marca principal del proyecto.
</ParamField>

<ParamField query="start_date" type="date">
  Inicio del periodo (`YYYY-MM-DD`).
</ParamField>

<ParamField query="end_date" type="date">
  Fin del periodo (`YYYY-MM-DD`).
</ParamField>

<ParamField query="model" type="string">
  Filtra por motor. Varios valores separados por coma: `chatgpt,claude`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.wudlet.com/v1/visibility?brand_id=c3a1e2b0-4d55-4f21-9c8a-1f0e9d8c7b6a" \
    -H "Authorization: Bearer sk_live_..." \
    -H "X-Timezone: America/Guatemala"
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "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
      }
    ]
  }
  ```
</ResponseExample>

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