Content Freshness

Content Freshness mesure par article à quel point le contenu est encore actuel — évalué selon les mentions de date, l'actualité des faits, le drift SERP, les nouveaux développements dans le champ thématique et le contenu concurrent comparable. Tu obtiens par article un score de fraîcheur plus un historique de quand le score est tombé pour la dernière fois. Quiconque publie régulièrement sans entretenir activement perd des rankings silencieusement et lentement — la fraîcheur est l'indicateur d'alerte précoce. Les articles obsolètes sont transmis directement au Content Optimizer, où le fix est concrètement formulé.

Ce qu'il peut faire

• Score de fraîcheur par article — par article un score 0–100 avec justification par signal.
• Historique de score — évolution dans le temps, tu vois quand un article a commencé à basculer.
• Re-checks manuels — vérifier immédiatement un article sans attendre le prochain slot cron.
• Aperçu projet — liste de tous les articles triés par fraîcheur, filtrés par statut (fresh, stale, critical).
• Suggestions de refresh — indications automatiques de ce qui est obsolète dans l'article (dates, statistiques, outils, liens).
• Check async — le re-check tourne en queue job, l'endpoint répond 202.

Quand l'utiliser

• Tu as un blog avec 50+ articles et tu ne peux pas tracker chacun manuellement.
• Les rankings tombent sans raison apparente — la fraîcheur est le premier suspect.
• Tu veux automatiser l'entretien régulier du contenu plutôt que de seulement produire du neuf.
• Tu construis un workflow éditorial dans lequel les articles sont à actualiser cycliquement.

Workflow

1. Aperçu — GET /content-freshness?project_id=&status= montre tous les articles triés.
2. Détail article — GET /articles/{id}/freshness montre le score actuel + signaux.
3. Déclencher un re-check — POST /articles/{id}/freshness/check lance un pull frais, async 202.
4. Lire l'historique — GET /articles/{id}/freshness/history montre l'évolution du score dans le temps.
5. Optimiser — envoyer les articles critiques directement dans Content Optimizer.
6. Re-Score — refaire un freshness check après l'apply Optimizer.

API

Valeurs de statut : fresh (score ≥ 75), stale (40–74), critical (< 40).

Exemple de filtre :

GET /v1/content-freshness?project_id=42&status=critical

Crédits et limites

• Re-Check coûte par run (pull de lecture peu coûteux, dépend de la profondeur).
• Aperçu et historique sont gratuits.
• Les freshness scores sont actualisés cycliquement en background ; un re-check manuel n'est nécessaire que si tu veux une mise à jour immédiate.
• Asynchrone — l'endpoint répond 202, résultat par polling ou appel à /articles/{id}/freshness.

Modules associés

• Content Optimizer — la suite naturelle pour les articles stale et critical.
• AI Content Editor — re-writes directement depuis l'éditeur.
• Content Audit — inventaire à l'échelle du site, la fraîcheur est le drift temporel de cet inventaire.
• Automation — configurer les freshness checks en job récurrent.