Aller au contenu
SEO Tools AI
SEO Tools AIS'inscrire

Référence

Les champs du score de fiche d'outil, un par un

Concevez votre tableau de fiches une fois et la tâche mensuelle s'écrit toute seule. Voici chaque colonne de score de lien qu'un annuaire peut stocker, et l'appel qui la remplit.

Équipe de recherche SEO Tools AI ·

Les colonnes, en un coup d'œil

Les coûts sont par appel, pas par ligne. Un appel renvoie jusqu'à 1 000 lignes.
ColonneRempli parCréditsActualisation
drbulk_dr, jusqu'à 2 000 domaines1Mensuel
dr_checked_onVotre propre tâche, le jour où vous avez récupéré les données0À chaque exécution
ref_domainsrefdomains, triés selon votre choix2Mensuel, uniquement pour les fiches en vedette
top_anchorsanchors2Trimestriel
top_pagestoppages2Trimestriel
overview_bloboverview (gratuit, sans clé)0À la demande
rival_overlapintersect, de 2 à 10 domaines2Lorsque vous ajoutez un outil

Les colonnes qui méritent leur place

Commencez par deux. dr est la clé de tri, et dr_checked_on est la colonne de l'honnêteté.

Un score sans date ressemble à un fait, et un mois plus tard, c'est une rumeur. La date empêche cela, et elle permet aussi à votre tâche de sauter les lignes qu'elle a actualisées il y a une heure après un crash.

Traitez tout le reste comme optionnel. Un site de comparaison qui affiche les domaines de renvoi à côté de la notation donne aux lecteurs un deuxième chiffre à croiser, ce qui est plus utile qu'un badge plus joli. Notre outil d'analyse des backlinks montre à quoi cela ressemble par rapport aux autres vérificateurs.

Associez les colonnes au glossaire pour que les lecteurs voient les mêmes mots que vous utilisez dans le back-office, et à la recette de synchronisation lorsque vous êtes prêt à les remplir.

Colonnes pour les liens que l'annuaire diffuse

Les scores décrivent l'outil. Un annuaire diffuse aussi des liens, et ceux-ci méritent une colonne à part. Les catalogues qui demandent un lien en retour sont courants, donc la question vous touchera plus tôt que prévu.

Commencez par un champ oui/non qui enregistre le lien retour. Avant de le rédiger, vérifiez vous-même le site listé, car une réponse mémorisée est la première chose à mal tourner dans une liste de quelques centaines de lignes.

Une colonne pour les liens réciproques

Ajoutez reciprocal_link comme une colonne oui/non qui indique si le site de l'outil listé vous renvoie un lien. Disons que vous gérez 300 outils et que 40 d'entre eux ont demandé un lien en retour. Cette colonne vous indique quelles fiches reposent sur une faveur, et ce, avant qu'un lecteur ne pose la question.

Gardez la colonne hors du tri des scores. Elle décrit la relation, pas l'outil, donc la mélanger dans un classement rendrait l'ordre plus difficile à expliquer plus tard.

Une colonne de statut pour les liens que vous publiez

Enregistrez outbound_status avec le statut HTTP de chaque lien que vous publiez, ainsi que la date de votre dernière vérification. Une fiche qui renvoie un 404 est une promesse brisée au lecteur, et personne d'autre ne le remarquera pour vous.

La vérification peut s'intégrer à la même exécution mensuelle que l'actualisation du score. Vous ajoutez une colonne et pas de nouvelle planification, ce qui est la maintenance la moins chère qu'un annuaire puisse acheter.

Notez la promesse qui vous a été faite

Lorsqu'un catalogue demande un lien en retour, notez la date, la page et la formulation exacte de la demande dans une colonne link_note. Une note simple prend une minute à écrire et évite une discussion six mois plus tard.

Ne promettez pas un emplacement que vous ne pouvez pas tenir. Si le lien retour n'est jamais ajouté, le geste honnête est de marquer la ligne et de laisser le score tel quel.

Garder la placement payant à part

Si une fiche a payé sa place, stockez une valeur placement à côté du score et ne laissez jamais le score décider seul de l'ordre. Un dr élevé ne doit pas être la seule raison pour laquelle une ligne payée se trouve au-dessus d'une meilleure.

Affichez le drapeau de paiement à côté du score, afin que quiconque trie la page voie les deux. Un lecteur qui trouve l'étiquette est un lecteur qui continue de faire confiance au reste de la liste.

Les paramètres de requête que vous utiliserez réellement

Ce sont les paramètres de l'API, dans l'ordre dont une tâche de synchronisation a besoin.

text
action   what to do: domain, overview, bulk_dr, refdomains, anchors ...
q        one domain, for single-domain actions
domains  comma list, for bulk_dr (GET) or send it as a POST body
key      your sk_ key, or use the Authorization: Bearer header
page     which page of rows
per      rows per page, 10 to 5000, up to 1,000 rows per billed call
sort     column to sort by
order    asc or desc

Nommer et typer pour durer

Nommez les colonnes selon ce qu'elles contiennent, pas selon un fournisseur. dr est acceptable pour le nôtre, mais si vous ajoutez ultérieurement une deuxième métrique, dr_ours et da_moz vous éviteront une migration.

Stockez la note comme un entier de 0 à 100, la date comme une chaîne ISO telle que 2026-10-01, et les comptes comme des entiers. Une colonne texte contenant 1,2k est un piège pour la première personne qui la trie.

Gardez aussi une colonne source, avec une valeur courte comme seotoolsai. Cela coûte quelques octets et répond à la question que se pose tout futur rédacteur.

Deux champs de réponse sur lesquels vous pouvez vous fier

Chaque réponse contient ok. Celles authentifiées contiennent aussi _credits, avec le coût de cet appel et votre solde restant. Journalisez les deux. Avant de mapper tout autre champ dans une colonne, faites un appel domain gratuit et lisez le JSON vous-même.

Configurer le tableau en cinq étapes

01

Nommez d'abord les colonnes

Écrivez la liste des colonnes avant de toucher à une clé API, et nommez chaque colonne selon ce qu'elle contient. Laissez les noms des fournisseurs hors des noms de colonnes, afin qu'une métrique ultérieure n'oblige pas à renommer.

02

Faites un appel gratuit

Exécutez overview pour un seul domaine. Il n'a pas besoin de clé, vous pouvez donc lire le JSON et vérifier les noms de champs par rapport à votre table avant de dépenser un crédit.

03

Ajoutez le score et sa date

Stockez dr comme un entier et dr_checked_on comme une date ISO. Ces deux colonnes sont le minimum pour un score qu'un lecteur peut croire.

04

Testez sur vingt lignes

Envoyez bulk_dr pour vingt fiches que vous connaissez. Comparez trois résultats à la main avec l'action domain gratuite, et seulement ensuite exécutez la liste complète.

05

Ajoutez des colonnes de détail pour les lignes en vedette

Les domaines de renvoi et les ancres coûtent 2 crédits par appel, donc récupérez-les pour les fiches que vous affichez en détail. Le score à 1 crédit peut toujours couvrir toutes les autres lignes.

Exemple concret : un enregistrement de fiche hypothétique

Ceci est un exemple inventé, pas une vraie fiche. Imaginez un annuaire appelé ToolShelf avec une fiche pour un produit fictif, example-seo.test.

Son enregistrement contient dr 41, dr_checked_on 2026-10-01 et ref_domains 1 000. Cela correspond à la formule publique, puisque log(1001) divisé par log(20 000 000) multiplié par 100 arrondi à 41.

Un mois plus tard, la tâche relit et trouve 1 800 domaines de renvoi, donc la note devient 45. Seuls dr et la date changent. Le texte de la revue, les captures d'écran et les notes de l'éditeur restent exactement tels qu'écrits, car le score ne les touche pas.

Quelles fiches méritent un score, et à quel niveau de détail

Toutes les fiches n'ont pas besoin du même niveau de détail. Un annuaire avec quelques centaines d'outils peut noter chaque ligne, mais les appels de détail sont une décision séparée avec un coût séparé.

Notez chaque ligne, même celles que vous cachez aux lecteurs. Une fiche cachée a encore besoin d'une valeur lorsque quelqu'un filtre le back-office, et une cellule vide à cet endroit ressemble à une vérification manquante plutôt qu'à un choix.

Deux fiches sur un même domaine

Deux fiches peuvent partager un même hôte, par exemple un outil et sa page d'essai gratuit sur le même site. Un score appartient à un domaine, donc les deux lignes reçoivent le même dr.

Ajoutez une courte note textuelle telle que shares domain à la deuxième ligne. Sans cela, un éditeur voit deux nombres identiques et suppose que l'un d'eux est une erreur de copie.

La même règle couvre une entreprise qui exécute plusieurs outils sous un même site. Chaque outil peut mériter sa propre page, mais son score est toujours le score du domaine sur lequel il réside, donc dites-le dans la colonne de note.

Dépenser les appels de détail là où les lecteurs regardent

Le haut d'une catégorie est là où un compte de domaines de renvoi change une décision. Commencez les appels à 2 crédits là et laissez la longue traîne sur dr seul.

Réexaminez la séparation une fois par an. Les fiches montent et descendent sur la page, et une ligne qui était enfuie en mars peut maintenant mériter l'appel de détail.

Gardez la réponse brute une fois

Gardez le JSON brut pour chaque actualisation dans une colonne texte ou dans un fichier séparé. Lorsque vous changez ce que la page affiche, vous reconstruisez à partir de cette copie et évitez de payer pour les mêmes lignes deux fois.

Cela vous donne aussi un enregistrement sur lequel pointer lorsqu'une note semble fausse. Comparez la réponse stockée avec la réponse actuelle avant de changer manuellement un score.

Enregistrez aussi la valeur ok à côté de la réponse stockée. Une ligne construite à partir d'une réponse qui n'était pas ok doit être signalée pour un deuxième passage, et non considérée comme un score fiable.

Exécuter l'actualisation dans un ordre fixe

Une actualisation qui touche des lignes dans un ordre aléatoire est difficile à auditer. Traitez les lignes dans l'ordre où elles apparaissent sur la page, et écrivez le premier et le dernier domaine de l'exécution dans le journal.

Si la tâche s'arrête en cours de route, le journal vous indique où reprendre. Les lignes qui portent déjà la date de ce mois peuvent être sautées, et rien n'est payé deux fois.

Questions sur les champs

Devrais-je stocker le JSON brut pour chaque fiche ?

Oui, une fois par actualisation. Gardez-le dans une seule colonne texte ou JSON, puis dérivez dr et les autres champs d'affichage à partir de celui-ci. Lorsque vous changez ce que vous affichez, vous pouvez reconstruire les pages sans appeler l'API à nouveau et payer deux fois.

Que se passe-t-il si un domaine n'est pas dans l'index ?

Ne devinez pas un score. Laissez la cellule dr vide et n'affichez pas de badge pour cette fiche. Notre index contient 181 132 097 domaines, ce qui est grand mais pas tout le web, et un vide est plus honnête qu'un zéro.

Ai-je besoin de tous ces champs sur la page publique ?

Non. Affichez la note et sa date, et peut-être les domaines de renvoi pour les fiches en vedette. Gardez le reste dans le back-office pour le tri, l'audit et la détection des fiches dont les chiffres sautent entre les mois.