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.