Concorrentes

As marcas que monitoriza a par da sua. Os IDs de concorrente devolvidos aqui são os valores actor_id que os endpoints de métricas reportam.

GET/dimensions/competitors

Lista os concorrentes do projeto.

GET/dimensions/competitors/:id

Obtenha informações detalhadas sobre um concorrente, incluindo nomes correspondentes e IDs das lojas de aplicações.

GET/competitors/suggestions

O separador Sugeridos da página Concorrentes. basis=brands (predefinição) devolve as marcas concorrentes propostas pela descoberta com IA que ainda não são monitorizadas nem foram rejeitadas, com os nomes pelos quais seriam detetadas; basis=citations devolve os domínios mais citados nas respostas de IA que ainda não são seus nem monitorizados, com o número de respostas que citam cada um. discovery indica se uma execução de descoberta ainda está a carregar. Só de leitura: nunca inicia uma execução de descoberta. Adicione uma sugestão com POST /competitors. Também disponível como a ferramenta MCP list_competitor_suggestions.

Parâmetros:
  • project_idobrigatório
  • basisbrands|citations
  • query
  • page
  • per_pagepredefinição 20, máx. 100
  • output

POST/competitors

Adiciona um concorrente com a sua própria regra de correspondência de URLs de citação. Respeita o limite máximo de concorrentes de cada plano.

Corpo (JSON):
  • project_idobrigatório
  • brand_nameobrigatório
  • domainobrigatório, o URL é normalizado
  • matching_namesarray opcional
  • citation_match_modedomain, host ou path_prefix; predefinido domain
  • citation_match_pathobrigatório para path_prefix

PATCH/DELETE /competitors/:id

Atualiza um concorrente (brand_name, domínio ou host do site, matching_names, color, correspondência de URLs de citação) ou elimina-o. As alterações ao nome, ao site e à regra de citação reexecutam a correspondência histórica em segundo plano (processing: true durante alguns minutos; as edições ficam bloqueadas entretanto). A eliminação é irreversível: o concorrente desaparece imediatamente e, em seguida, uma tarefa em segundo plano elimina o respetivo histórico de menções, citações, sentimento e Share of Voice. Os anúncios, produtos de Shopping, negócios locais e entidades de marca do concorrente são mantidos e passam para o projeto ou para outro concorrente a que correspondam, ou ficam sem atribuição.

Corpo do PATCH:
  • project_idobrigatório
  • brand_name
  • domaindomínio ou host do site; um URL completo é normalizado
  • matching_namesarray de substituição total
  • colorhexadecimal
  • citation_match_mode
  • citation_match_path

DELETE: project_id + :id no URL.