Concurrents

Les réponses IA nomment des marques en texte libre. Un concurrent est l’une de ces marques que l’espace a décidé de suivre : Skoup calcule alors sa part sur les mêmes réponses que celle de la marque — rétroactivement, sur tout l’historique, puisque chaque réponse est déjà enregistrée. Suivre ou retirer un concurrent se fait dans l’app Skoup ; l’API lit la liste suivie, avec la part de chaque concurrent sur un marché et une période.

Le nombre de concurrents suivis est plafonné par le plan. Il compte les marques distinctes, tous marchés confondus : suivre la même marque en France et aux États-Unis prend une place.

Statuts d’un concurrent

detectedtrackedremoved

detected = les marques citées par les réponses ; seules les marques tracked sont renvoyées par l'API. Un concurrent removed libère sa place et redevient detected.

Je veux…

Je veux…	Appel
Comparer la marque à ses concurrents suivis	`GET /v1/brands/{brand}/competitors?market=FR&period=90d`
Savoir combien de places il reste	L’en-tête `Skoup-Quota-Competitors` de cet appel
Être prévenu quand la liste change	`competitor.tracked`, `competitor.removed`
Repérer tôt un nouvel entrant	`alert.created` avec `kind: "new_competitor"`
Lister les sites qui citent les concurrents sans la marque (RP, tests, revendeurs)	`GET /v1/brands/{brand}/source-gaps?market=FR&period=90d`
Savoir quand une source conquise cite enfin la marque	`task.verified` sur une tâche `source: "source_gap"`

Scope : metrics:read.

Scénario : un digest concurrentiel hebdo


curl "https://api.skoup.ai/v1/brands/br_034PJIMnN3EOTCU3TMUdLS/competitors?market=FR&period=30d" \
  -H "Authorization: Bearer skoup_test_4eC39HqLyjWDarjtT1zdp7dc"

Lancez-le après chaque sampling.completed hebdo et postez le classement dans le canal de votre équipe.

Pièges

Lecture seule par l’API. Suivre un concurrent est une décision prise dans l’app, là où vivent le quota et l’upsell.
Une source à conquérir est de la co-citation. source-gaps liste les sites cités dans des réponses qui nomment un concurrent et pas la marque ; le site n’« appartient » à aucun concurrent. Le site de la marque et ceux des concurrents n’y figurent jamais. Aucun événement « nouvelle source » : relisez la liste après sampling.completed.
Les parts sont par marché. Un concurrent peut être suivi sans jamais être cité sur un marché : sa part est alors calculée sur des réponses qui ne le nomment pas.