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

# Competidores

> Marcas que los motores de IA mencionan en las mismas respuestas que rastreas.

Devuelve los competidores con más menciones en el periodo, junto con un porcentaje de visibilidad relativo al total de respuestas.

<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. Por defecto `UTC`.
</ParamField>

<ParamField query="brand_id" type="uuid">
  Marca de referencia.
</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.
</ParamField>

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

<ResponseExample>
  ```json theme={null}
  {
    "total_responses": 80,
    "competitors": [
      {
        "name": "Otra marca",
        "domain": "ejemplo.com",
        "mentionCount": 24,
        "visibility": 35
      }
    ]
  }
  ```
</ResponseExample>

`visibility` es el porcentaje de respuestas del periodo en las que aparece ese competidor. La lista está limitada a los cinco más fuertes.