# Competidores

Las marcas que monitorizas junto a la tuya. Los IDs de competidor devueltos aquí son los valores `actor_id` con los que informan los endpoints de métricas.

### GET `/dimensions/competitors`

Lista los competidores del proyecto.

### GET `/dimensions/competitors/:id`

Obtén información detallada sobre un competidor, incluidos los nombres coincidentes y los IDs de app store.

### POST `/competitors`

Añade un competidor con su propia regla de coincidencia de URL de citaciones. Respeta el tope máximo de competidores por plan.

Cuerpo (JSON):

- `project_id` obligatorio
- `brand_name` obligatorio
- `domain` obligatorio, la URL se normaliza
- `matching_names` array opcional
- `citation_match_mode` `domain`, `host` o `path_prefix`; valor predeterminado `domain`
- `citation_match_path` obligatorio con `path_prefix`

### PATCH/DELETE `/competitors/:id`

Actualiza un competidor (`brand_name`, dominio o host del sitio web, `matching_names`, `color` y la regla de coincidencia de URL de citaciones) o elimínalo. Los cambios de nombre, sitio web o regla vuelven a procesar las coincidencias históricas en segundo plano (`processing: true` durante unos minutos; mientras tanto, las ediciones quedan bloqueadas). La eliminación es irreversible y purga los datos del competidor en segundo plano.

Cuerpo de PATCH:

- `project_id` obligatorio
- `brand_name`
- `domain` dominio o host del sitio web; las URL completas se normalizan
- `matching_names` array de sustitución completa
- `color` hex
- `citation_match_mode`
- `citation_match_path`

DELETE: `project_id` + `:id` en la URL.

Acceso completo. Cancela cuando quieras.