Référence
Vérifier les backlinks en ligne : actions, coûts, paramètres
Une référence simple pour les appels utilisés dans les dossiers. Les coûts sont exprimés en crédits, et 1 crédit équivaut à 0,0001 $. Chaque appel est facturé une seule fois, quel que soit le nombre de lignes retournées.
Actions groupées par prix
| Action | Crédits | Utilisez-le pour |
|---|---|---|
domain, overview, stats, suggest | Gratuit, sans clé | Premier aperçu d'un domaine, de son rating et de ses chiffres clés |
bulk_dr | 1 | Évaluez jusqu'à 2 000 domaines en un seul appel (GET domains= ou un corps POST) |
compare | 1 | Comparez jusqu'à 20 domaines côte à côte |
top, dr_distribution, tld_breakdown | 1 | Visualisez la répartition : leaders, dispersion des ratings, mélange de TLD |
refdomains, backlinks | 2 | Listez les sites qui font un lien vers un site |
anchors, anchor_cloud, toppages | 2 | Analysez les mots utilisés et les pages qui attirent des liens |
intersect | 2 | Trouvez les référents communs entre 2 et 10 domaines |
search | 3 | Recherche en texte intégral sur les ancres, les titres et les URL |
keyword | 3 | Trouvez qui est lié avec une ancre exacte |
Demandez des champs, un par un
Six paramètres couvrent presque tous les appels utilisés dans les dossiers. Chaque entrée indique ce que fait le paramètre et où il s'arrête.
action
Nomme l'appel, comme overview ou intersect. Chaque requête en nécessite un, et l'action détermine le prix.
q
Le domaine examiné, écrit sans protocole, pour les actions sur un seul domaine comme overview et refdomains.
domains
Une liste séparée par des virgules pour les actions multi-domaines. intersect prend de 2 à 10 domaines, compare prend jusqu'à 20, et bulk_dr prend jusqu'à 2 000 via GET ou dans un corps POST.
key
Votre clé sk_, passée en paramètre ou en en-tête Authorization: Bearer. Les actions gratuites s'exécutent sans clé.
page et per
page permet de naviguer dans les résultats et per définit le nombre de lignes par page, de 10 à 5000. La pagination profonde s'arrête à 50 000 lignes, donc affinez votre requête avant d'aller aussi loin.
sort et order
sort nomme la colonne et order prend asc ou desc. Trier les domaines référents par rating croissant place les plus faibles en haut, où les empreintes ont tendance à apparaître.
Paramètres que vous réutiliserez
L'authentification se fait via un paramètre key ou un en-tête Authorization: Bearer sk_.... Gardez les clés hors des URL que vous collez dans un chat, car les chaînes de requête finissent dans les journaux. CORS est ouvert, donc un outil navigateur fonctionne aussi bien qu'un script. Pratique.
La pagination utilise page et per, où per varie de 10 à 5000. Simple. Un seul appel retourne jusqu'à 1 000 lignes, et la pagination profonde est limitée à 50 000. Le tri utilise sort plus order=asc ou order=desc.
Placez la queue bon marché en premier. Trier les domaines référents par rating croissant place les domaines minces en haut, là où les empreintes apparaissent. Cette habitude seule économise une heure.
Gardez les paramètres dans le même ordre à chaque fois. Un ordre fixe facilite la comparaison visuelle de deux adresses enregistrées et évite de remplir un diff avec du bruit.
Évaluez le budget d'un appel avant de l'exécuter
Le prix dépend de l'action, pas du nombre de lignes. C'est la règle. Un appel refdomains coûte 2 crédits qu'il retourne une poignée de lignes ou une page entière. Multipliez le prix par le nombre d'appels prévus, pas par le nombre de lignes espérées.
Rédigez le plan avant le premier appel. Une courte liste d'actions, de domaines et d'appels attendus suffit. Cela transforme une facture surprise en une question. Répondez-y tôt.
Par appel, et non par ligne
Chaque appel est facturé une fois. La pagination d'une longue liste est un seul coût par page demandée, donc une valeur per plus élevée peut réduire le nombre de factures sur un tirage long. Lisez _credits après la première page pour confirmer le prix avant de boucler. Chaque page d'un tirage paginé est un appel séparé, donc comptez les pages avant de commencer et gardez per identique sur chacune.
Associez le coût à la décision
Pesez le prix d'une réponse par rapport à ce que la réponse va changer. Une vérification de rating qui pourrait modifier un achat justifie un tirage payant. Une simple curiosité concernant un concurrent rarement. Notez la décision et les crédits dépensés dans la même note.
Appels gratuits comme filtre
Lancez d'abord domain, overview et stats. Ils sont gratuits et montrent s'il vaut la peine de faire un tirage payant. Imaginez un domaine dont l'aperçu montre presque aucun domaine référent. Vous n'aurez peut-être pas besoin de refdomains du tout, et les crédits économisés peuvent aller à un concurrent. La méthode réseau utilise le même filtre.
Le solde du compte
Le solde se trouve dans _credits sur chaque appel avec clé. Lisez-le après chaque exécution et copiez le chiffre à côté du fichier enregistré. Un appel qui retourne HTTP 402 signifie que les crédits sont épuisés, alors rechargez avant la prochaine exécution.
Réponses et erreurs
| Ce que vous obtenez | Signification | Que faire |
|---|---|---|
ok dans chaque réponse | Le drapeau à tester avant de lire autre chose | Garez votre script dessus |
_credits sur les appels avec clé | Coût de cet appel et votre solde restant | Journalisez-le à côté de la pièce à conviction |
| HTTP 401 | Clé manquante ou incorrecte | Vérifiez l'en-tête ou le paramètre key |
| HTTP 402 | Les crédits sont épuisés | Rechargez avec USDT (TRC-20) sur la page du compte |
À quoi ressemble un tirage terminé
Un tirage terminé pour vérifier les backlinks en ligne est plus qu'un fichier JSON. Il contient une date, l'appel, la fenêtre et une note de ce qu'il ne peut pas montrer. Gardez les quatre ensemble. Sinon, le fichier vaudra moins chaque mois.
Le corps brut
Sauvegardez la réponse exactement comme elle est revenue, avant tout filtrage ou tri. Un résumé que vous avez écrit vous-même ne peut être vérifié qu'against le fichier brut, donc le fichier brut est celui à conserver.
Les paramètres
Enregistrez l'action, le domaine ou la liste, les valeurs de pagination et l'ordre de tri. Deux tirages qui diffèrent uniquement par per ne sont pas comparables jusqu'à ce que cette différence soit notée.
La fenêtre
Indiquez le cycle de rafraîchissement dont proviennent les chiffres et la date de récupération. Un chiffre sans date sera contesté avec un chiffre plus récent, et l'argument portera alors sur la date plutôt que sur la découverte.
Les limites
Écrivez une ligne sur ce que l'appel n'a pas pu voir : les liens ajoutés après le dernier rafraîchissement, les pages bloquées par les robots, les liens derrière une connexion. La ligne empêche une découverte de prétendre plus que ses données ne peuvent porter.
Paginer une longue liste sans gaspillage
La pagination est là où les budgets disparaissent silencieusement. Chaque page est un autre appel, et une longue liste tirée page par page peut coûter plus cher que ce que la question valait. Deux habitudes la rendent honnête.
Tri avant pagination
Triez par la colonne qui répond à votre question, puis naviguez dans les résultats. La première page devrait contenir les lignes sur lesquelles vous agiriez. Si ce n'est pas le cas, changez le tri avant de dépenser plus d'appels.
Arrêtez quand la question est répondue
Une liste de dizaines de milliers de lignes est rarement la réponse. Arrêtez la pagination une fois que les lignes nécessaires sont à l'écran, enregistrez cette page et notez où vous vous êtes arrêté. La note indique au prochain lecteur ce qui a été omis. Laissez le reste non lu sauf si la question change.
Erreurs sur lesquelles agir en premier
Deux codes d'état expliquent la plupart des exécutions arrêtées. Chacun a une correction qui prend moins de temps que de deviner la cause.
HTTP 401 en premier, à chaque fois
Un 401 signifie que la clé est manquante ou incorrecte, donc vérifiez l'en-tête ou le paramètre avant toute autre chose. Copiez la clé depuis la page du compte plutôt que de la retaper, car un seul caractère erroné produit la même erreur. Si les appels gratuits fonctionnent et que les payants échouent, la clé est la cause la plus probable, car les actions gratuites n'ont pas besoin de clé du tout.
HTTP 402 au milieu d'une exécution
Un 402 arrête une exécution qui fonctionnait une minute plus tôt. Arrêtez la boucle, lisez le solde, et rechargez avant le prochain appel. Ne réessayez pas dans une boucle serrée, car chaque essai est une requête qui ne peut réussir tant que le solde ne change pas.
Avant de faire confiance à une réponse
- Vérifiez que
okest vrai - Notez la date, car l'index se rafraîchit environ mensuellement
- Rappelez-vous que DR est round(100 · log(ref_domains + 1) / log(2·10^7)), pas un numéro tiers
- Comparez les domaines référents entre les outils, pas les totaux bruts de backlinks
- Archivez le fichier brut, pas seulement votre résumé
Limites, énoncées clairement
Il s'agit de données de liens à un faible prix par appel. Il ne suit pas les mots-clés. Il ne suit pas non plus les classements. Ahrefs et Semrush sont des produits plus complets pour cela, et Ahrefs vend des unités API dans des abonnements à partir de 129 $ par mois pour 200 000 unités.
Les recettes utilisant ces appels sont dans casework avec curl, et les termes inconnus sont dans le glossaire.
Lire une réponse avec suspicion
Une réponse est une déclaration témoin. Elle est vraie pour l'index au jour du crawl, et silencieuse sur tout ce qui est en dehors. Demandez ce que l'index n'a pas pu voir : les pages bloquées par robots.txt, les liens ajoutés après le dernier rafraîchissement, les liens derrière une connexion. Si vous voulez vérifier les backlinks en ligne sans écrire de code, le vérificateur sur la page d'accueil appelle l'action gratuite domain.
Vérifiez croisé une chose à la main à chaque fois. Choisissez un seul référent dans la liste, ouvrez la page et trouvez le lien. Simple. S'il est là, faites confiance au reste un peu plus. Sinon, notez la date et l'URL, et consultez le tableau de dépannage.
Ne laissez jamais un script agir sur une seule lecture. L'alerte est acceptable, mais supprimer des liens, envoyer des fichiers de disavow ou appeler les propriétaires doit attendre un humain.
