Référence
Référence : chaque action, son coût, ses modes de défaillance
Gardez ceci ouvert pendant que vous scriptez votre audit. Il liste les actions, les prix, les limites de pagination et les deux erreurs que vous êtes susceptible de rencontrer.
Les bases avant les tableaux
Le point de terminaison est https://backlinkphoenix.com/api.php?action=<action>&q=<domain>&key=sk_.... Vous pouvez envoyer la clé via un en-tête Bearer à la place. Le CORS est ouvert, donc un script côté navigateur fonctionne également.
Chaque réponse comporte un indicateur ok. Celles authentifiées incluent également _credits, qui indique le coût et votre solde restant. Cela rend le suivi du budget trivial.
Par rapport aux tarifs de l'API Moz Backlinks, la structure diffère : Ahrefs vend des unités au sein d'abonnements à partir de 129 $ par mois pour 200 000 unités, tandis qu'ici vous payez à l'appel depuis un solde prépayé.
Il n'y a pas de palier d'abonnement à gravir ni de minimum mensuel. Un solde prépayé signifie qu'il n'y a pas de facture de dépassement. Une seule règle s'applique à tous. Un script qui s'exécute une fois par mois et un script qui s'exécute lors de l'onboarding de chaque client paient selon la même règle. Les nouveaux inscrits commencent avec 100 $ de crédit gratuit, suffisants pour environ 500 000 appels à 2 crédits.
Écrire votre premier script sans surprises
Commencez petit. Un script qui appelle l'API est simple à écrire et facile à faire déborder. Les règles ci-dessous maintiennent la première version honnête.
Limitez la première exécution à un seul domaine. Une fois que la sortie semble correcte, élargissez la liste par étapes, et lisez le solde entre chaque étape.
Les pages sont l'unité de coût
Un appel est facturé une fois, quel que soit le nombre de lignes qu'il retourne. Une page que vous récupérez constitue un autre appel, donc la pagination d'une grande liste coûte une facture par page.
Disons qu'un site a 2 500 domaines référents et que vous les voulez tous. À la taille de page que vous choisissez, cela représente quelques appels, et chacun a son propre coût. Comptez les pages avant de lancer la boucle. Choisissez une taille de page adaptée à la question, car une courte liste nécessite un appel et une longue liste nécessite le même soin à chaque page.
Lisez les crédits sur chaque réponse
Chaque réponse authentifiée contient _credits, qui indique ce que l'appel a coûté et ce qu'il reste. Enregistrez ce champ plutôt qu'un nombre que vous auriez estimé de tête.
Un script qui écrit le solde dans sa sortie vous permet de vous arrêter avant qu'une longue exécution n'épuise le compte. Gardez la vérification simple et visible.
Utilisez les appels gratuits pour tester le plan
domain, overview, stats et suggest n'ont pas besoin de clé et ne coûtent rien. Utilisez-les pour confirmer l'orthographe du domaine et la structure de base des données avant tout appel payant.
Ajoutez ensuite les appels payants, un par un, sur le même domaine. Une erreur capturée sur un appel gratuit ne coûte rien. Conservez les sorties gratuites dans le même dossier daté que les payantes.
Actions gratuites et à un crédit
| Action | Coût | À quoi cela sert |
|---|---|---|
| domain | Gratuit | Recherche rapide de DR, l'appel derrière le vérificateur sur la page d'accueil |
| overview | Gratuit | Chiffres clés pour un domaine |
| stats | Gratuit | Chiffres sur l'index lui-même |
| suggest | Gratuit | Recherche de type autocomplétion pour les domaines |
| bulk_dr | 1 crédit | Jusqu'à 2 000 domaines par appel, GET avec domains= ou un corps POST |
| compare | 1 crédit | Jusqu'à 20 domaines côte à côte |
| top | 1 crédit | Une liste classée de notre index |
| dr_distribution | 1 crédit | Comment le DR se répartit sur un ensemble |
| tld_breakdown | 1 crédit | Référents groupés par TLD |
Actions à deux et trois crédits
| Action | Coût | À quoi cela sert |
|---|---|---|
| refdomains | 2 crédits | Domaines qui lient vers une cible |
| backlinks | 2 crédits | Liens individuels |
| anchors | 2 crédits | Liste des ancres |
| toppages | 2 crédits | Pages qui attirent des liens |
| anchor_cloud | 2 crédits | Mots d'ancre pondérés par leur utilisation |
| intersect | 2 crédits | Qui lie vers 2 à 10 domaines à la fois, pour la recherche de liens de remplacement |
| search | 3 crédits | Recherche en texte intégral sur les ancres, les titres et les URL |
| keyword | 3 crédits | Qui est lié avec une ancre exacte |
Un appel est facturé une fois, quel que soit le nombre de lignes, jusqu'à 1 000 lignes par appel. Utilisez page et per (10-5000) pour parcourir les résultats, triez avec sort plus order=asc|desc. La pagination profonde s'arrête à 50 000.
Erreurs que vous pouvez voir
| Code HTTP | Signification | Que faire |
|---|---|---|
| 401 | Clé manquante ou invalide | Vérifiez le paramètre key ou l'en-tête |
| 402 | Le crédit est épuisé | Rechargez avec USDT (TRC-20) sur la page du compte |
Lorsqu'un appel échoue, et quoi vérifier en premier
Deux erreurs couvrent la plupart des échecs en pratique. Chacune a une correction différente, donc lisez le code avant de modifier autre chose.
Un appel échoué vous dit quand même quelque chose. Conservez l'URL de la requête, l'heure et le corps de la réponse dans le journal, avec la clé supprimée.
Un 401 signifie que la clé n'est pas acceptée
Une réponse 401 indique que la clé est manquante ou invalide. La correction réside dans la requête, pas dans les données. Vérifiez le paramètre key ou l'en-tête Bearer, et assurez-vous que la valeur a été copiée en entier. N'imprimez jamais la clé pendant le débogage.
Disons qu'un script fonctionne sur votre ordinateur portable mais échoue sur un serveur. Un 401 là-bas signifie souvent que la variable d'environnement n'a jamais été définie sur cette machine.
Un 402 signifie que le solde est épuisé
Une réponse 402 signifie que le crédit est dépensé. Rien dans les données n'est faux, et réessayer le même appel échouera de la même manière jusqu'à ce que vous rechargiez.
Les recharges sont effectuées en USDT sur le réseau TRC-20 depuis la page du compte. Vérifiez le solde avant une longue exécution, afin que le script ne s'arrête pas en plein milieu d'une liste. Définissez également un seuil d'avertissement, car un avertissement précoce est bien moins coûteux qu'un audit interrompu.
Nouvelles tentatives sans gaspillage
Réessayez uniquement les erreurs qui peuvent changer, comme un délai d'attente. Un 401 ou 402 réessayé dans une boucle ajoute du bruit au journal et aucune donnée à l'audit.
Faites une pause entre les tentatives, et conservez le domaine défaillant dans une liste séparée afin de pouvoir le relancer volontairement plutôt que par accident. Écrivez la règle de nouvelle tentative dans un commentaire en haut du script, afin que la prochaine modification la conserve.
Quelle action pour quelle question de récupération
Associez la question que vous avez à l'appel le moins cher qui y répond.
Quelle est l'ampleur des dégâts ?
Commencez par overview, qui est gratuit. Ensuite, exécutez refdomains une fois et comparez-le avec le fichier que vous avez enregistré le mois dernier. Notre routine mensuelle montre la différence.
À quoi ressemblent les liens indésirables ?
Utilisez anchors et anchor_cloud. Les mots étranges qui se répètent sur de nombreux domaines sont le motif à capturer avant d'ouvrir les mythes sur le disavow.
Quels donateurs valent la peine d'être poursuivis ?
intersect prend deux à dix domaines et retourne les sites qui lient vers plusieurs d'entre eux. Alimentez vos rivaux, cherchez les donateurs qui vous sautent, puis évaluez la liste avec bulk_dr.
La migration a-t-elle fuité ?
toppages sur l'ancien et le nouveau domaine montre où atterrissent les liens. Le guide de migration l'utilise étape par étape.
Un audit ponctuel en quatre appels
Cet ordre maintient les appels payants limités et chacun lié à une question. Exécutez-le une fois par domaine, puis répétez les appels payants chaque mois avec les mêmes paramètres.
Exécutez les appels gratuits
Commencez par overview et domain. Les deux sont gratuits, et leur sortie définit l'échelle pour chaque appel payant qui suit.
Récupérez les domaines référents
Utilisez refdomains à 2 crédits par appel. Comptez d'abord les pages, puis décidez combien vous en aurez besoin.
Vérifiez le mélange d'ancres
Exécutez anchors ou anchor_cloud à 2 crédits chacun. Cherchez des mots étranges qui se répètent sur de nombreux domaines.
Évaluez la liste des candidats
Alimentez les domaines douteux dans bulk_dr à 1 crédit par appel, qui gère jusqu'à 2 000 domaines. Conservez les scores dans le même fichier que les domaines référents.
Un appel paginé, annoté
Tous les paramètres après l'action sont facultatifs.
curl "https://backlinkphoenix.com/api.php?action=toppages&q=yourshop.com&page=2&per=500&order=desc&key=sk_live_..."
# q: the domain; page and per: paging; order: asc or desc; key: your secret
# every response includes ok, and authenticated ones add _creditsUne comparaison équitable avec une alternative à l'API Moz Backlinks
Les comparaisons équitables commencent par les mêmes unités. Les pages de tarification cachent souvent l'unité, alors notez ce que vous payez réellement pour chaque réponse avant de comparer les totaux.
Chez Ahrefs, les unités sont incluses dans un abonnement, qui commence à 129 $ par mois et achète 200 000 unités. Chaque requête utilise au moins 50 d'entre elles. C'est là le piège. Mettez-le à côté d'un prix par appel, et seulement alors la comparaison a un sens.
Un test équitable
Choisissez cinq domaines de taille connue et exécutez les mêmes questions via les deux services. Comparez les réponses dont vous avez besoin, pas les fonctionnalités que vous admirez.
Disons qu'un service retourne les domaines référents en un seul appel et qu'un autre en nécessite trois. Le coût par réponse compte alors plus que le prix affiché.
Tarification dans les mêmes unités
Convertissez tout en coût par réponse. Nos appels sont tarifés en crédits à 0,0001 $ chacun, donc un appel à 2 crédits coûte 0,0002 $ et un appel gratuit ne coûte rien. Disons qu'une exécution mensuelle utilise sept crédits. Cela représente 0,0007 $, soit moins d'un dixième de centime.
Incluez le coût du gaspillage, comme les relances après un appel échoué. Un appel bon marché qui échoue souvent peut finir par coûter plus cher qu'un appel plus cher qui fonctionne du premier coup.
Là où une suite complète gagne encore
La recherche de mots-clés, le suivi des positions et l'exploration quotidienne sont en dehors de cette API. Si ce sont vos questions, une suite complète y répond mieux, et la comparaison devrait le dire.
Utilisez le grand livre pour la question qu'il répond bien : comment le profil de liens a évolué, et quels donateurs méritent un examen plus approfondi. Nommez l'écart dans vos notes, par exemple « aucune donnée de mots-clés ici », afin que le prochain lecteur ne suppose pas que le grand livre le couvre.
