Aller au contenu
SEO Uptr
SEO UptrS'inscrire

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.

Stone bridge over river with a small boat sailing underneath

Actions par coût en crédits

1 crédit = $0.0001. Chaque appel est facturé une fois quel que soit le nombre de lignes, jusqu'à 1 000 lignes par appel.
CoûtActionsNotes
Gratuit, sans clédomain, overview, stats, suggestIdéal pour les tableaux de bord et le vérificateur de DR
1 créditbulk_dr, compare, top, dr_distribution, tld_breakdownbulk_dr prend jusqu'à 2 000 domaines (GET domains= ou corps POST) ; compare jusqu'à 20
2 créditsrefdomains, backlinks, anchors, toppages, anchor_cloud, intersectintersect prend de 2 à 10 domaines
3 créditssearch, keywordRecherche 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.

bash
# 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" ;;
esac

Paramètres et erreurs

ÉlémentValeurSignification
qun domaineLa cible de la requête
page, perper de 10 à 5000Pagination ; le nombre de lignes par appel est limité à 1 000, la pagination profonde à 50 000
sort, orderorder=asc ou descTri des lignes retournées
okdans chaque réponseIndique si l'appel a réussi
_creditsuniquement pour les réponses authentifiéesCoût de l'appel et solde restant
HTTP 401clé manquante ou incorrecteVérifiez la clé ou l'en-tête
HTTP 402crédits épuisésRechargez avec USDT (TRC-20)
Carpenter measuring wood and selecting tools on a workshop bench

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.

Actions gratuites en premier

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.
Gardener arranging plants in neat rows in a garden

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 overview ou domain. 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 sur refdomains ou anchors uniquement 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 appel anchors et un appel tld_breakdown sur 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 page avec per. 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.