Référence
Référence de l'API Backlinks : actions, coûts et erreurs
Une page pour les faits essentiels qu'un moniteur doit connaître : le coût de chaque action, le fonctionnement de la pagination et le comportement de l'API en cas d'erreur.

Actions par coût en crédits
| Coût | Actions | Notes |
|---|---|---|
| Gratuit, sans clé | domain, overview, stats, suggest | Idéal pour les tableaux de bord et le vérificateur de DR |
| 1 crédit | bulk_dr, compare, top, dr_distribution, tld_breakdown | bulk_dr prend jusqu'à 2 000 domaines (GET domains= ou corps POST) ; compare jusqu'à 20 |
| 2 crédits | refdomains, backlinks, anchors, toppages, anchor_cloud, intersect | intersect prend de 2 à 10 domaines |
| 3 crédits | search, keyword | Recherche en texte intégral sur les ancres, les titres et les URL ; keyword identifie qui est lié avec une ancre exacte |
Authentification et codes d'état
Transmettez la clé via key= ou en tant qu'en-tête bearer. Vérifiez le code HTTP avant d'analyser le corps de la réponse.
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://seouptr.com/api.php?action=anchors&q=yourdomain.com&per=100"
# a cron-safe wrapper
code=$(curl -s -o out.json -w '%{http_code}' "$URL")
case "$code" in
200) jq '._credits' out.json ;; # cost and remaining balance
401) echo 'bad or missing key' ;;
402) echo 'out of credit: top up' ;;
*) echo "unexpected $code" ;;
esacParamètres et erreurs
| Élément | Valeur | Signification |
|---|---|---|
q | un domaine | La cible de la requête |
page, per | per de 10 à 5000 | Pagination ; le nombre de lignes par appel est limité à 1 000, la pagination profonde à 50 000 |
sort, order | order=asc ou desc | Tri des lignes retournées |
ok | dans chaque réponse | Indique si l'appel a réussi |
_credits | uniquement pour les réponses authentifiées | Coût de l'appel et solde restant |
| HTTP 401 | clé manquante ou incorrecte | Vérifiez la clé ou l'en-tête |
| HTTP 402 | crédits épuisés | Rechargez avec USDT (TRC-20) |

Concevoir l'appel avant de le planifier
La plupart des problèmes d'API commencent dans la requête, pas dans la réponse. Une intégration de l'api backlinks seo consiste principalement en un ensemble de petites décisions prises avant le premier appel. Définissez d'abord la clé, la taille de page et l'ordre de tri.
Gardez la clé hors du script
Stockez la clé dans une variable d'environnement ou un gestionnaire de secrets, pas dans un fichier que vous commitez. Transmettez-la en tant que paramètre key ou en tant qu'en-tête bearer. L'en-tête garde la clé hors des adresses qui ont tendance à finir dans les journaux.
Ne collez pas une clé active dans un ticket ou un chat. Traitez comme exposée toute clé qui apparaît dans un journal partagé.
Choisissez la taille de page intentionnellement
Le paramètre per varie de 10 à 5000, mais un appel est facturé une fois pour jusqu'à 1 000 lignes, donc des pages plus grandes signifient moins de factures. Disons que vous avez besoin de 3 400 lignes. Cela nécessite quatre appels à 1 000 lignes, et non 340 appels à 10.
Gardez la taille de page identique entre les exécutions pour que les fichiers s'alignent.
Épinglez l'ordre de tri
Définissez explicitement sort et order plutôt que de faire confiance à une valeur par défaut. Des paramètres identiques rendent les sorties comparables d'une semaine à l'autre, afin qu'un diff montre un changement réel et non des lignes réorganisées.
Un ordre modifié est un moyen facile de créer une fausse alerte.
Lire les chiffres
Les données proviennent de notre propre graphe de liens : 181 132 097 domaines, 2 774 625 913 liens domaine à domaine et environ 798,5 milliards de backlinks. Il se rafraîchit environ une fois par mois. Tout ce qui est plus récent que cela n'y figurera pas, c'est pourquoi une api backlinks seo est mieux interrogée hebdomadairement.
DR est round(100 · log(ref_domains+1) / log(2·10^7)). C'est un logarithme. De ce fait, 100 domaines de référence valent 27, 1 000 valent 41 et 10 000 valent 55, donc doubler votre nombre de liens n'ajoute que quelques points. Utilisez DR pour classer les sites les uns par rapport aux autres et le nombre brut pour les alertes, comme le fait le tableau de sévérité.
La tarification est prépayée. Il n'y a pas d'abonnement ni de minimum. Le crédit d'inscription est de $100, soit 1 000 000 de crédits. Comparez cela avec les unités de l'API Ahrefs, vendues dans des plans à partir de $129/mois pour 200 000 unités, avec au moins 50 unités par requête.
La planification des coûts est une simple multiplication. Un appel hebdomadaire refdomains pour un site coûte 2 crédits fois 4, soit 8 crédits par mois, ce qui représente $0.0008. Dix sites coûtent dix fois plus. La recette de perte de lien et le travail concurrent utilisent uniquement des actions du tableau ci-dessus.
Lire une erreur sans deviner
Un code d'erreur vous indique qui doit agir. Lisez-le de cette manière. La réponse devient alors une décision de routage, pas un mystère. Les deux codes qui comptent le plus pour un moniteur sont 401 et 402.
401 et 402 sont des problèmes différents
Un 401 signifie que la clé est manquante ou incorrecte, et rien ne réussira jusqu'à ce que quelqu'un le corrige. Un 402 signifie que le compte n'a plus de crédit, et une recharge le rétablit. Orientez-les vers différents propriétaires pour que la bonne personne voie le message.
Envoyez-les tous les deux à une personne. Un moniteur qui échoue silencieusement est pire qu'un moniteur qui n'a jamais fonctionné.
Vérifiez le statut avant le corps
Lisez d'abord le statut HTTP, puis le champ ok. Une réponse peut être analysée en JSON et malgré tout comporter une erreur, donc la vérification n'est complète que lorsque les deux passent. Journalisez le statut à chaque exécution, y compris les réussites.
Ne réessayez que ce qui peut récupérer
Réessayer un 401 gaspille des appels et remplit les journaux de la même erreur. Un timeout réseau est différent. Réessayez-le un petit nombre de fois avec une pause entre les tentatives, puis arrêtez.
Une exécution qui s'arrête et alerte est plus utile qu'une boucle de réessai qui cache l'échec jusqu'à ce que le solde soit épuisé.
Journalisez le statut à chaque exécution
Écrivez le statut HTTP et le solde dans le journal à chaque exécution, y compris les réussites. Lorsqu'une exécution échoue trois semaines plus tard, cette ligne sera la première chose que vous voudrez voir.
domain, overview, stats et suggest n'ont pas besoin de clé et ne coûtent rien. Utilisez-les pour vérifier la validité d'un nom de domaine, une orthographe exacte ou une taille approximative avant de dépenser un seul crédit pour une action payante.
Avant de mettre un appel dans cron
- Le coût de l'action est connu et multiplié par le nombre d'exécutions par mois.
- Le code de sortie et le statut HTTP sont tous deux vérifiés.
- Un 402 envoie une alerte à un humain.
- Les réponses sont sauvegardées triées, afin que les diffs restent propres.
- La cadence correspond au rafraîchissement mensuel.

Notes sur la pagination
L'ordre compte. Utilisez per=1000 pour les instantanés et conservez le même sort et order chaque semaine. Si l'ordre change entre les exécutions, un diff montre du bruit. C'est une cause classique de fausses alertes.
Des sites plus grands ? Pour un site avec plus de 1 000 domaines de référence, parcourez avec page=1, page=2, etc. Chaque page est un appel facturé séparément. La pagination profonde est limitée à 50 000 lignes, ce qui couvre presque tous les sites ordinaires.
Questions sur la référence
- Quelle action devrais-je appeler en premier quand je ne suis pas sûr de l'apparence d'un domaine ?
- Commencez par
overviewoudomain. Les deux sont gratuits et n'ont pas besoin de clé, et ils montrent une taille approximative et la forme de base des données. Dépensez des crédits surrefdomainsouanchorsuniquement après cela. - Combien coûte une vérification complète d'un domaine ?
- Additionnez les crédits de chaque action, puis multipliez par la fréquence d'exécution. Imaginez un appel
refdomains, un appelanchorset un appeltld_breakdownsur un domaine, hebdomadairement. Cela fait 2 + 2 + 1 = 5 crédits par exécution, soit $0.0005. Sur quatre semaines, cela représente environ $0.002. - Pourquoi deux comptes pour le même domaine ne correspondent-ils pas ?
- Comparez comparable avec comparable : la même action, les mêmes paramètres et la même période de rafraîchissement. Les comptes de différentes actions ne sont pas interchangeables, et un compte pris en milieu de rafraîchissement peut différer de celui pris une semaine plus tard.
- Comment tester une tâche cron sans dépenser de crédits ?
- Exécutez d'abord les actions gratuites pour vérifier le câblage, la gestion des statuts et le format de sortie. Ensuite, faites un appel payant pour prouver les chiffres, et limitez la tâche à une seule exécution pendant les tests.
- La pagination fonctionne-t-elle pour un site avec plus de 1 000 domaines de référence ?
- Oui. Utilisez
pageavecper. Chaque page est un appel facturé séparément, et la pagination profonde est limitée à 50 000 lignes, ce qui couvre la plupart des sites ordinaires.
Un moniteur qui survit à une mauvaise semaine
Un moniteur gagne en confiance les semaines où rien ne se passe bien. Prévoyez une réponse lente, un solde modifié et un résultat partiel avant la première exécution. Ce sont des événements ordinaires. Chacun doit laisser une ligne claire dans le journal.
Timeouts et pulls partiels
Définissez un timeout sur chaque appel, afin qu'une réponse lente ne puisse pas maintenir toute la tâche ouverte. Si une page d'un pull multi-page échoue, enregistrez quelle page c'était et redémarrez à partir de là. Vous évitez ainsi de payer deux fois pour des lignes que vous avez déjà.
Marquez un fichier partiel comme partiel plutôt que de le sauvegarder comme un instantané normal. Sinon, le prochain diff montrera une perte qui ne s'est jamais produite.
Vérifications de solde
Lisez _credits sur chaque réponse authentifiée et écrivez le solde restant dans le journal. Un petit script peut le comparer avec un plancher que vous choisissez et envoyer un avertissement avant la prochaine exécution.
Disons que le plancher est de 500 crédits. Une exécution hebdomadaire qui coûte 40 crédits laisse de la marge pour recharger avant qu'un 402 n'arrive en pleine nuit.
Gardez chaque tâche ennuyeuse
Donnez à chaque tâche un fichier et un horaire. Une entrée cron qui fait trois choses peut échouer de trois façons, et le journal ne peut pas toujours dire laquelle s'est produite. Deux petites tâches sont plus faciles à faire confiance qu'une seule tâche intelligente.
Adaptez l'horaire au rafraîchissement
Adaptez l'horaire de la tâche au rafraîchissement mensuel plutôt qu'à l'horloge. Une exécution quotidienne retourne le même fichier la plupart des jours, ce qui ajoute du coût et du bruit sans ajouter d'informations. Hebdomadaire est généralement suffisant.