Référence
Rapport de backlinks Ahrefs versus sortie API : référence des actions
Si vous avez l'habitude d'exporter un rapport de backlinks Ahrefs, cette référence montre quelles parties vous pouvez reconstruire à partir de nos actions, le coût de chaque appel et où les grandes suites logicielles restent en avance.
Actions, prix et ce qu'elles remplacent dans un rapport
| Action | Crédits | Partie la plus proche d'un rapport typique | Notes |
|---|---|---|---|
| domaine, aperçu, statistiques, suggestion | 0 | Comptes de titres | Aucune clé nécessaire |
| bulk_dr | 1 | Une colonne DR pour une liste | Jusqu'à 2 000 domaines par appel |
| compare | 1 | Domaines côte à côte | Jusqu'à 20 domaines |
| top, distribution_dr, répartition_tld | 1 | Graphiques récapitulatifs | Résumés de type distribution |
| refdomains | 2 | Onglet des domaines référents | Paginé |
| backlinks | 2 | Onglet des backlinks | Paginé |
| anchors, nuage_ancres | 2 | Onglet des ancres | Le nuage est destiné à l'affichage |
| toppages | 2 | Meilleures pages par liens | Pages qui attirent les liens |
| intersect | 2 | Intersection de liens | 2 à 10 domaines |
| search, keyword | 3 | Pas de correspondance directe | Recherche par ancre, titre et URL |
Comment les onglets du rapport correspondent à nos actions
La plupart des exports de rapports se présentent sous forme d'onglets, et chaque onglet a un équivalent approximatif ici. Ce n'est pas une copie exacte. Lisez le mappage comme point de départ, car un champ présent dans un onglet peut ne pas exister du tout dans notre réponse.
L'onglet des domaines référents
Imaginez un rapport qui s'ouvre sur les domaines référents triés par DR. Notre équivalent le plus proche est refdomains, à 2 crédits, et il peut être trié de la même manière. Attendez-vous à renommer une ou deux colonnes dans votre script, car les noms de champs des lignes varient selon l'action.
Corrigez le tri entre les mois. Une liste triée par DR un mois et par le trafic le mois suivant ne peut pas être comparée honnêtement, donc inscrivez la clé de tri dans le nom du fichier.
L'onglet des ancres, et pourquoi le nuage est destiné à l'affichage
anchors est l'appel pour l'onglet des ancres, à 2 crédits. anchor_cloud coûte la même chose, mais comme le tableau ci-dessus l'indique, il est destiné à l'affichage. Si une décision dépend de chiffres, lisez la liste brute.
Lisez les ancres avec une question : un rédacteur humain taperait-il ces mots ? Les noms de marque et les URLs brues passent généralement. Un bloc de phrases identiques répété sur de nombreux domaines ne passe pas, et c'est ce bloc à vérifier en premier.
Pages principales et vue de deux à dix domaines
toppages est la chose la plus proche d'un onglet des meilleures pages par liens. Il montre quelles pages attirent les liens, et cela dit souvent plus qu'un total de domaine lorsqu'un mouvement de classement touche un dossier du site.
intersect prend entre deux et dix domaines et coûte 2 crédits par appel. Disons que vous comparez votre site avec deux concurrents. La superposition montre alors quels sites référents les trois partagent, ce qui est simple et peu coûteux.
Paramètres qui s'appliquent à tous les appels
Trois choses contrôlent chaque liste. Il s'agit de page, per et de la paire sort avec order. Gardez-les fixes entre les mois.
per accepte de 10 à 5000, bien qu'un appel retourne jusqu'à 1 000 lignes, et la pagination profonde s'arrête à 50 000 lignes. Chaque appel est facturé une fois quel que soit le nombre de lignes, donc demander une page complète coûte autant que demander dix lignes.
L'authentification prend soit key=sk_... dans la requête, soit un en-tête Authorization: Bearer sk_.... CORS est ouvert, mais gardez la clé sur votre serveur de toute façon, car le code du navigateur l'expose à tous les visiteurs.
L'ordre compte. Lorsque vous parcourez les résultats, triez par DR décroissant pour les domaines qui comptent probablement, ou ascendant pour inspecter la longue traîne des petits sites. Quel que soit votre choix, notez-le à côté du fichier.
Traitez le tableau ci-dessus comme une carte et les réponses enregistrées comme le territoire. Si un champ que vous attendiez est absent, adaptez-vous à ce qui est présent.
Un export mensuel, en cinq étapes
Exécutez les cinq mêmes étapes chaque mois, afin que les fichiers enregistrés s'alignent lorsque vous les comparez.
- 1
Choisissez les appels
Choisissez
refdomains,anchorsettoppagespour chaque domaine. L'aperçu et les statistiques sont gratuits, ajoutez-les donc au même dossier. - 2
Fixez la profondeur
Définissez
page,per,sortetorderune fois et gardez-les. Per peut aller jusqu'à 5000, mais un seul appel retourne jusqu'à 1 000 lignes. - 3
Enregistrez chaque réponse telle quelle
Écrivez le JSON brut sur le disque avant tout traitement. Si un script échoue plus tard, la copie enregistrée est celle que vous relancez.
- 4
Lisez l'objet _credits
Chaque réponse authentifiée rapporte son coût et le solde restant. Copiez les deux dans une ligne de journal, afin que la dépense du mois soit visible sans tableau de bord.
- 5
Comparez avec le mois dernier
Différenciez les copies enregistrées. La recette de diff liste les trois colonnes worth keeping.
Crédits, limites de lignes et facture mensuelle
La liste des prix est courte. La facture dépend de la fréquence des appels et de votre pagination. Trois habitudes décident de la majeure partie.
Une facturation par appel, quel que soit le nombre de lignes
Chaque appel est facturé une fois, donc per=1000 coûte autant que per=10 pour la même action. Une page complète est le choix économique pour une liste que vous réutiliserez, et gaspilleur pour un coup d'œil rapide.
Disons que vous extrayez refdomains pour un domaine le même jour chaque mois. Cela représente 2 crédits, soit 0,0002 $ par mois au tarif publié de 0,0001 $ par crédit.
Le plafond de 50 000 lignes
La pagination profonde s'arrête à 50 000 lignes. Une boucle qui continue de demander la page suivante après cela ne reçoit rien de nouveau, donc plafonnez le nombre de pages avant le début de la boucle.
Atteindre le plafond à 1 000 lignes par appel nécessite cinquante appels. À 2 crédits chacun, cela fait 100 crédits, soit 0,01 $. Pas cher, mais seulement si le script s'arrête quand il doit.
Un petit budget pour une habitude mensuelle
Imaginez dix domaines, chacun avec refdomains et anchors extraits une fois par mois. Cela représente 40 crédits par mois, soit 0,004 $, prélevés sur les 100 $ de crédits gratuits à l'inscription, qui équivalent à 1 000 000 de crédits.
À ce rythme, le crédit gratuit dure longtemps, et le journal des dépenses montre si le rythme se maintient. Maintenez-le.
Dépannage des réponses
| Vous voyez | Cause | Solution |
|---|---|---|
| HTTP 401 | Clé manquante ou incorrecte | Vérifiez la clé et l'orthographe de l'en-tête |
| HTTP 402 | Les crédits sont épuisés | Rechargez en USDT (TRC-20) sur la page du compte |
| ok est faux | La requête a été rejetée | Lisez le message dans le corps et les paramètres que vous avez envoyés |
| Moins de lignes qu'une grande suite n'en affiche | Index et timing de crawl différents | Comparez les tendances, pas les totaux |
| Un lien que vous avez créé la semaine dernière est manquant | Index reconstruit environ mensuellement | Vérifiez à nouveau lors du prochain cycle |
Une ligne manquante est une question, pas une réponse
Une ligne qui disparaît entre deux réponses est une surprise courante. Avant de décider de ce que cela signifie, séparez les histoires qu'elle pourrait raconter.
Trois histoires derrière une ligne manquante
Le lien n'a peut-être jamais été indexé, ou il a peut-être été supprimé. La troisième histoire est le timing : la page a été crawlée avant ou après une reconstruction de l'index, et la ligne apparaît dans un cycle ultérieur.
Un seul appel ne peut pas séparer ces cas. Une seule seconde copie prise plus tard, plus un coup d'œil à la page elle-même, réduit la liste.
Pesez la ligne avant de la poursuivre
Vérifiez le DR du domaine et la page de liaison avant toute prospection. Un lien supprimé provenant d'un site faible modifie rarement un plan. Un lien supprimé provenant d'une page qui a attiré des lecteurs peut mériter une note à son propriétaire. Le tableau des suspects montre où se situe une ligne manquante parmi les causes plus larges.
Déplacer un export vers nos appels
Puis-je exporter les mêmes colonnes qu'Ahrefs ?
Pas un pour un. Les champs des lignes varient selon l'action, donc ouvrez une réponse enregistrée et mappez les noms vous-même. Le tableau ci-dessus nomme l'action la plus proche pour chaque partie d'un rapport, mais les noms de champs différeront.
L'API est-elle moins chère qu'un abonnement Ahrefs ?
La réponse dépend du volume d'appels. Notre prix publié est de 0,10 $ pour 1 000 appels d'un crédit. Ahrefs vend des unités API dans les abonnements, à partir de 129 $ par mois pour 200 000 unités, avec au moins 50 unités par requête. Comptez vos appels avant de décider.
Les anciens exports seront-ils encore comparables aux nouveaux ?
Seulement si le tri, la profondeur et la source correspondent. Un fichier extrait d'un outil différent une semaine différente est un échantillon différent. Gardez les anciens fichiers et commencez la nouvelle série avec une paire clairement étiquetée.
Dois-je garder la clé sur mon serveur ?
Oui. CORS est ouvert, donc un navigateur peut appeler l'API, mais une clé dans le code front-end est visible par tous les visiteurs. Envoyez les requêtes depuis votre serveur et lisez la clé depuis une variable d'environnement.
Avant de construire un rapport au-dessus de ces appels
- Ouvrez une réponse enregistrée par action et notez les noms de champs de ligne que vous recevez réellement.
- Décidez quelle étiquette de mois va dans chaque nom de fichier.
- Gardez
page,per,sortetorderidentiques entre les extractions mensuelles. - Journalisez l'objet
_creditsde chaque réponse authentifiée afin que la dépense par tâche soit visible. - Plafonnez la pagination profonde dans votre script, car les listes s'arrêtent à 50 000 lignes.
- Ajoutez une note de fraîcheur à tout rapport que vous remettez, indiquant que l'index se rafraîchit environ mensuellement.
Lire l'enveloppe
Chaque réponse contient ok. Celles authentifiées ajoutent également _credits, vous pouvez donc journaliser la dépense par tâche et surveiller le solde.
curl -s "https://rankele.com/api.php?action=toppages&q=example.com&per=50&key=sk_live_..." | head -c 600
# header style
curl -s -H "Authorization: Bearer sk_live_..." \
"https://rankele.com/api.php?action=bulk_dr&domains=example.com,example.org"Ahrefs vend des unités API dans les abonnements, à partir de 129 $ par mois pour 200 000 unités avec un minimum de 50 unités par requête. Il propose également des mots-clés, le suivi des classements et un crawl plus frais, tout comme Semrush. Nous couvrons les données de liens à un prix par appel faible et rien au-delà. Utilisez le manuel mensuel si c'est l'écart que vous devez combler. L'arbre décisionnel des pics de spam est une bonne première utilisation des appels de résumé peu coûteux.
