Rank Tracker (Google)

Le Rank Tracker observe à quelle position tes URLs rankent dans la recherche Google classique pour une liste de mots-clés. Tu définis par projet quels mots-clés sont trackés, sur quels devices (Desktop / Mobile) et dans quel pays. Rankion pull la SERP régulièrement, écrit chaque position dans un historique et visualise l'évolution sur 30 / 90 / 365 jours. Tu as ainsi le pouls SEO classique juste à côté de ton tracking GEO (AI-Visibility Tracking) — la suite SEO et la suite GEO partagent projet, pool de mots-clés et rapports.

Ce qu'il peut faire

• Multi-Device, Multi-Country — Desktop et Mobile séparés par mot-clé, n'importe quelle version pays Google.
• Historique — chaque mesure est conservée, accessible en série 30 / 90 / 365 jours.
• Refresh on-demand — re-mesurer projet entier ou mots-clés individuels, sans attendre le prochain slot cron.
• Pulls async — les nouveaux mots-clés sont pullés via DataForSEO en background job, l'endpoint répond immédiatement avec 202.
• Toggle Actif/Inactif — mettre les mots-clés en pause au lieu de les supprimer, l'historique est préservé.
• Sync cross-suite — les mêmes mots-clés peuvent être enrichis en volume + KD dans le Keyword Explorer & Research.

Quand l'utiliser

• Tu veux du monitoring de ranking Google classique dans le temps.
• Tu as besoin de rapports diff « aujourd'hui vs. il y a 30 jours » pour tes top mots-clés.
• Tu veux mesurer proprement l'effet d'un relaunch / refresh de contenu.
• Tu veux confronter performance SEO et GEO côte à côte — même pool de mots-clés, deux perspectives.

Workflow

1. Créer ou choisir un projet — Rank Tracker est project-scoped (voir Premiers pas avec Rankion).
2. Ajouter des mots-clés — POST /rank-tracker/{project}/keywords avec {keywords[], devices[]}. Réponse 202, le pull tourne en background.
3. Attendre le pull initial — typiquement 1–2 minutes par batch. L'UI affiche le statut live.
4. Lire l'historique — GET /rank-tracker/keywords/{keyword}/history avec range 30d / 90d / 365d.
5. Déclencher un refresh — POST /rank-tracker/{project}/refresh lance un re-pull immédiat de tous les mots-clés actifs.
6. Cross-check — compare avec le score AI-Visibility des mêmes mots-clés pour voir les écarts SEO vs. GEO.

API

Exemple de body POST /rank-tracker/{project}/keywords :

{
  "keywords": ["stoßdämpfer wechseln", "fahrwerk lackieren"],
  "devices": ["desktop", "mobile"]
}

Crédits et limites

• Modèle pull async. Nouveaux mots-clés + refresh tournent via queue jobs, l'endpoint répond 202 immédiatement.
• Les crédits dépendent du volume de pull DataForSEO et sont décomptés au niveau équipe.
• Les points de données historiques sont conservés indéfiniment (pas d'auto-pruning).
• Actif/Inactif au lieu de hard-delete préserve l'historique pour l'analyse de tendance.

Modules associés

• Keyword Explorer — enrichir les mêmes mots-clés en volume + KD.
• AI-Visibility Tracking — confronter performance SEO vs. GEO.
• Competitor Analysis — qui d'autre rank sur tes mots-clés ?
• Agentic Chat — demande à l'agent maître : « Quels de mes mots-clés ne rankent pas dans le top 10 ? »