L'API GNewsalyzer est désormais ouverte à tous les comptes

L'API de GNewsalyzer existait depuis janvier, mais elle était restée en pratique inaccessible : seul le compte administrateur pouvait émettre une clé. C'est terminé. Tout compte GNewsalyzer dispose désormais de sa propre API, gratuitement, sans supplément ni carte bancaire.

Concrètement, vous pouvez brancher les données que nous collectons sur Google Discover et Google News directement dans vos outils : un script de veille, un tableau de bord interne, une alerte Slack, une colonne de Google Sheets.

La question à laquelle elle répond le mieux

« Est-ce que cet article est passé dans Discover ? »

C'est la question que tout le monde se pose après une publication, et celle à laquelle Search Console répond mal — elle agrège, elle retarde, elle ne dit pas quand. L'API répond par oui ou non pour une URL donnée, avec le nombre d'apparitions relevées, la date de première et de dernière détection, la source et la catégorie.

curl -H "X-API-Key: votre_cle" \
  "https://www.gnewsalyzer.com/api/v2/discover/check?url=https://exemple.fr/article"

Et la réponse :

{
  "success": true,
  "data": {
    "present": true,
    "occurrences": 3,
    "first_seen": "2026-09-14 06:12:03",
    "last_seen": "2026-09-16 19:40:55",
    "source": "20 Minutes",
    "category": "Actualité"
  }
}

Vous pouvez en vérifier jusqu'à 100 d'un coup en un seul appel. De quoi passer toute une journée de publication en revue en une seconde, le matin, automatiquement.

Ce que l'API expose d'autre

La vérification de présence n'est qu'un point d'entrée parmi d'autres :

• Les articles détectés dans Discover, filtrables par catégorie, par source et par période, avec une recherche plein texte.
• Les catégories et leur volumétrie, pour situer un sujet dans l'ensemble du corpus.
• Les sujets du graphe de connaissances : ce qui monte, ce qui domine, et les articles rattachés à chacun.
• Les statistiques : vue d'ensemble, répartition par catégorie, tendances sur la période de votre choix.
• Vos audits Discover, exportables en JSON ou en CSV.

Comment obtenir votre clé

Trois étapes, moins d'une minute :

1. Connectez-vous à votre compte GNewsalyzer.
2. Ouvrez API dans le menu de gauche, sous « Extension Chrome ».
3. Nommez votre clé et créez-la.

Un point important : la clé ne s'affiche qu'une seule fois, à sa création. Nous n'en conservons que l'empreinte cryptographique — ni vous, ni nous, ni quiconque mettrait la main sur notre base ne peut la relire ensuite. Copiez-la dans votre gestionnaire de mots de passe au moment où elle apparaît. Si vous la perdez, elle se remplace en quelques secondes : vous révoquez l'ancienne, vous en créez une autre.

Les limites, dites franchement

Une API gratuite tourne sur des serveurs qui ne le sont pas. Nous avons donc posé des garde-fous, calibrés pour ne jamais gêner un usage normal :

• 300 requêtes par minute
• 1 000 par heure
• 5 000 par jour

Ces plafonds se comptent par compte et non par clé : émettre plusieurs clés sert à séparer vos environnements, pas à multiplier votre quota. Chaque réponse vous indique où vous en êtes dans les en-têtes X-RateLimit-Remaining et X-RateLimit-Reset, inutile d'aller les chercher.

Une précision utile : un appel groupé de 100 URL coûte 10 unités, là où 100 appels séparés en coûtent 100 — pour un résultat identique. Groupez, votre quota vous remerciera.

Si votre usage dépasse ces valeurs, ce n'est pas un abus et nous ne le traiterons pas comme tel. Écrivez-nous en décrivant ce que vous faites : les plafonds se relèvent compte par compte.

La documentation

Tout est détaillé sur gnewsalyzer.com/api/docs : l'authentification, chaque point d'entrée avec ses paramètres et un exemple de réponse, les codes d'erreur, et des exemples prêts à copier en curl, PHP, JavaScript et Python.

Pour celles et ceux qui outillent, une spécification OpenAPI est disponible : importez-la dans Postman ou Insomnia, ou générez-en un client dans votre langage.

Le catalogue des points d'entrée se consulte même sans clé, si vous voulez jeter un œil avant de créer un compte :

curl https://www.gnewsalyzer.com/api/v2/

Et ensuite

Les webhooks — recevoir une notification dès qu'un de vos articles est détecté dans Discover, plutôt que d'aller le demander — sont la suite logique. Ils ne sont pas encore ouverts : nous préférons les livrer quand ils fonctionneront vraiment plutôt que d'annoncer une case à cocher qui ne déclenche rien.

D'ici là, l'API est à vous. Dites-nous ce que vous en faites, et ce qui vous manque.