Aller au contenu
Anchor Social
Anchor SocialS'inscrire

Dépannage

Comment vérifier les backlinks par API lorsque les lignes semblent incorrectes

Un tableau centré sur les symptômes pour les moments où un tirage d'ancres renvoie moins de lignes que prévu, coûte plus cher que prévu ou diffère des résultats du mois dernier.

Quatre tuyaux en argile alimentant un bol représentant les erreurs de données API et les liens bloqués

Vérifiez d'abord ces trois points

La plupart des tirages incohérents remontent à l'une des trois causes suivantes. Chacune peut être vérifiée en moins d'une minute, ce qui rend judicieux de les écarter avant de passer une heure sur les lignes. Vérifiez ces trois éléments : la clé, le solde de crédits ou la date de l'instantané.

Chaque réponse authentifiée contient ok et un objet _credits avec le coût et le solde restant, donc la première étape est toujours d'imprimer ces deux champs. Commencez toujours par là. Si ok est faux, rien dans les lignes n'a encore d'importance.

Vérifiez ensuite le mois. Notre index se rafraîchit environ une fois par mois, et un lien ajouté la semaine dernière peut simplement ne pas y figurer, ce qui n'est pas un bug.

Une autre habitude à adopter. Gardez une ligne de journal pour chaque appel avec l'action, le numéro de page et le solde restant de _credits ; cela rend un manque de 7 crédits facile à tracer plus tard plutôt qu'une énigme en fin de mois.

Symptôme, cause, solution

SymptômeCause probableSolution
HTTP 401Clé manquante ou incorrecteEnvoyez key=sk_... ou Authorization: Bearer sk_... ; recopiez-la depuis la page du compte
HTTP 402Les crédits sont épuisésRechargez en USDT (TRC-20) depuis la page du compte et réessayez
Moins de lignes que ne l'indique le totalUn appel renvoie jusqu'à 1 000 lignesAjoutez page=2, page=3 ; la pagination profonde s'arrête à 50 000 lignes
Le coût semble supérieur à 2 créditsUne autre action a été appeléeanchors coûte 2 crédits ; keyword et search coûtent 3 ; vérifiez la valeur de action
Le total diffère du mois dernierL'index a été actualiséComparez les instantanés uniquement avec le même outil et la même fréquence mensuelle
Un nouveau lien manqueLe lien est apparu après le dernier rafraîchissementAttendez le prochain rafraîchissement mensuel ; ne relancez pas pour le traquer
La part de marque augmente soudainementDes liens site-wide ont ajouté de nombreuses lignesRecalculez par domaine de lien, consultez le guide d'exécution
Des chiffres différents d'Ahrefs ou SemrushDes crawls et des dates de rafraîchissement différentsChoisissez une source pour les tendances ; utilisez l'autre pour des vérifications ponctuelles

Lire correctement un résultat court

Un petit domaine peut simplement avoir peu d'ancres. Un domaine enregistré récemment, ou qui a peu de pages avec des liens externes, peut produire une liste courte pour des raisons parfaitement ordinaires. Court n'est pas cassé. Toute liste courte n'est pas un échec.

Comparez le nombre de lignes avec les chiffres de l'overview gratuit pour le même domaine : si l'overview signale des milliers de backlinks et que anchors renvoie quarante lignes sur la première page, vous avez probablement besoin de la page deux, pas d'un ticket de support. Si l'overview lui-même signale une poignée de liens, le domaine est jeune ou petit et le tirage est correct. Comptez d'abord, puis plaignez-vous.

L'inverse se produit aussi. Les gros domaines atteignent le plafond de pagination de 50 000 lignes, donc triez par la colonne qui vous intéresse et prenez le segment supérieur, ou appelez d'abord anchor_cloud pour voir quels termes dominent avant de parcourir tout.

Engrenages en argile entrelacés de tailles variées montrant comment les paramètres affectent les résultats

Les paramètres de tri et de pagination changent ce que vous voyez

Deux tirages peuvent différer pour une raison qui n'a rien à voir avec le web. Le tri, l'ordre et la taille de page agissent ensemble, donc changer l'un d'eux peut réordonner tout le résultat même lorsque le domaine et la clé restent exactement les mêmes. Le tri, l'ordre et la taille de page décident quelles lignes arrivent en premier et combien arrivent par appel. Vérifiez ceux-ci en premier.

Même domaine, différents leaders

Les premières lignes suivent le tri que vous avez demandé, donc un fichier trié d'une manière ne ressemblera pas à un fichier trié d'une autre manière. Le tri change les leaders. Si un fichier commence par les sites référents les plus grands et le suivant par les lignes les plus récentes, les deux peuvent être corrects. Notez le tri dans le nom du fichier.

Un test rapide aide. Lancez-le d'abord sur un petit domaine, afin que le test coûte presque rien et donne une réponse claire sur la requête. Appelez la même action deux fois avec des paramètres identiques. Si les lignes correspondent, la différence réside dans la requête, pas dans les données.

La page deux n'est pas une copie de la page une

Chaque page est un appel séparé avec sa propre ligne de facturation, et les lignes d'une page ne devraient pas se répéter sur la suivante. Les pages sont des appels distincts. Lorsqu'elles le font, la boucle a probablement conservé la même valeur de page. Imprimez le premier domaine de chaque page pour confirmer que les nombres changent.

Gardez le numéro de page dans votre journal à côté du solde. Une boucle qui bloque sur la page deux est beaucoup plus facile à corriger lorsque vous pouvez voir l'appel exact qui s'est arrêté. Les journaux font gagner des heures.

Testez deux pages en premier. Un court test après les deux premières pages suffit. Si la page deux répète la page une, arrêtez la boucle avant que le solde ne paie pour les mêmes lignes deux fois.

Imprimez les champs de facturation avant tout le reste

Une garde de trois lignes que vous pouvez coller dans un script cron.

bash
R=$(curl -s "https://anchorsocial.org/api.php?action=anchors&q=example.com&per=1000&key=$KEY")
echo "$R" | jq '{ok, _credits}'
[ "$(echo "$R" | jq -r .ok)" = "true" ] || exit 1

Réparer l'ordre lorsque un tirage semble incorrect

Travaillez de haut en bas. Chaque étape élimine une famille de causes avant que la suivante ne commence.

  1. 1

    Confirmez que l'appel a réussi

    Lisez ok dans la première réponse. Si c'est faux, les lignes n'ont pas encore d'importance.

  2. 2

    Comparez les paramètres

    Vérifiez action, q, sort, order, per et page par rapport au fichier avec lequel vous comparez.

  3. 3

    Vérifiez la date de l'index

    Demandez-vous si un rafraîchissement mensuel est intervenu entre les deux tirages, et notez cette date dans le tableau.

  4. 4

    Reconstruisez la requête à partir de zéro

    Écrivez à nouveau l'appel, paramètre par paramètre, pour attraper une faute de frappe qu'une URL copiée peut cacher.

Enveloppes en argile sous une loupe montrant les différences subtiles pour la résolution des litiges

Régler un litige avec le fichier du mois dernier

Lorsque deux fichiers sont en désaccord, la question est rarement de savoir qui a raison. La plupart des désaccords sont causés par un changement dans un paramètre que personne n'a noté, c'est pourquoi le journal est plus important que la mémoire. C'est quelle partie de la requête a changé entre les deux. Regardez d'abord la requête. Passez en revue trois vérifications dans l'ordre, et la plupart des litiges se résolvent à la première.

Commencez par la date de l'index

L'index se rafraîchit environ une fois par mois, et ce rafraîchissement est la première chose à écarter. Un lien devenu actif après le dernier rafraîchissement n'apparaîtra dans aucun des deux fichiers, et relancer le même jour ne corrigera pas cela. Les dates de rafraîchissement expliquent les écarts.

Étiquetez chaque fichier. Un fichier nommé avec sa date de tirage et son cycle de rafraîchissement répond à la question la plus courante avant que quelqu'un n'ait à la poser en réunion. Notez le cycle de rafraîchissement à côté de chaque nom de fichier. Ensuite, un écart se lit comme un écart dans le temps, pas comme un écart dans le web.

Gardez les dates de rafraîchissement ensemble dans une colonne, pas dispersées dans les notes. Un lecteur qui voit les dates à côté des totaux a rarement besoin de poser une deuxième question. Cela économise une question.

Comparer similaire avec similaire

Deux fichiers sont comparables uniquement lorsque l'action, le domaine, le tri et la valeur per correspondent. Si le tri diffère, les lignes de tête différeront même lorsque tous les totaux correspondent, et cela peut ressembler à un véritable changement dans le profil. Mélanger un fichier anchors avec un fichier backlinks est un moyen courant d'inventer une baisse qui ne s'est jamais produite. Les paramètres correspondants viennent en premier.

Si les paramètres correspondent et que les totaux diffèrent toujours, cette différence mérite un examen plus approfondi, et le journal vous indique où commencer. Ensuite, lisez le journal.

Donnez à la valeur per sa propre colonne également, car elle change le nombre de lignes arrivant par appel et donc le nombre d'appels qu'un tirage coûte. Gardez-la visible.

Lorsque les lignes ont bougé au lieu de disparaître

Après un changement de domaine ou une refonte, un lien peut toujours exister et pointer vers une nouvelle adresse. Les anciens hôtes conservent les liens. Comparez les pages principales pour l'ancien et le nouvel hôte avant de déclarer le lien perdu. La liste de vérification de migration passe en revue cet appariement.

Journalisez les deux côtés. Enregistrez les deux adresses sur une seule ligne, afin que le déplacement reste visible dans le tableau.

Les coûts qui surprennent les gens

Une facture qui augmente plus rapidement que prévu a généralement une cause. Beaucoup d'équipes ne remarquent une facture plus élevée qu'à la fin du mois, donc un examen hebdomadaire du total en cours attrape la dérive plus tôt. C'est l'action. Beaucoup de lecteurs demandent comment vérifier les backlinks sans trop dépenser, et la réponse commence par le nom de l'action. Lisez le solde à chaque réponse et gardez un total en cours à côté de votre tableau.

Un solde qui diminue plus vite que prévu

Les noms d'action comptent. Le coupable habituel est le nom de l'action. anchors coûte 2 crédits, tandis que keyword et search coûtent 3 chacun, donc un script qui a changé d'action a discrètement augmenté la facture. Vérifiez la valeur de action dans la requête avant le premier gros lancement.

Suivez la dérive. Gardez un total en cours de _credits dans le tableau. Une petite dérive chaque jour est facile à voir là-bas, bien avant la fin du mois.

Un 402 au milieu d'une boucle

Un 402 signifie que le solde est épuisé. Arrêtez la boucle. Les appels qui ont déjà été servis ont été facturés, tandis que le prochain appel échoue. Arrêtez la boucle, rechargez en USDT (TRC-20) depuis la page du compte et reprenez à partir de la page sur laquelle vous vous êtes arrêté.

Un point de reprise n'est utile que lorsqu'il est noté. Gardez le numéro de page dans le journal, afin que la reprise ne soit pas une devinette. Notez la page.

Lire un résultat trop grand

Un compte qui augmente soudainement mérite un examen de la source avant de devenir une histoire. Un seul lien de modèle peut ajouter des milliers de lignes, et une ligne de total seule ne vous dira pas si cela provient d'un seul site ou de plusieurs. Les lignes peuvent être correctes, et la raison peut résider dans un domaine plutôt que dans tout le profil. Vérifiez la source en premier.

Un footer site-wide derrière un grand compte

Un lien de modèle qui apparaît sur des milliers de pages d'un seul site peut expliquer un grand bloc de lignes. Regroupez le tirage par domaine de lien et voyez combien du total un site détient. Regroupez d'abord, puis jugez.

Si un domaine domine, le total est un fait concernant ce site, et l'analyse devrait être formulée de cette manière. Formulez-le de cette manière.

Lignes d'un domaine auquel vous n'avez pas lié

Les ancres étranges nécessitent une vérification. Leur présence ne prouve rien, mais cela signifie que la ligne mérite la même lecture que toute autre ligne dans votre analyse. Des domaines de lien inconnus avec des ancres non liées peuvent provenir d'un scraper ou d'une page compromise. Ouvrez l'une des pages de lien, comme le ferait un visiteur, avant de supposer que les lignes appartiennent à votre profil.

Journalisez le domaine, la date et l'ancre dans le tableau, et conservez la réponse brute, afin qu'une révision ultérieure dispose des preuves. La preuve bat la mémoire.

Si le tableau n'a pas résolu le problème

  • Exécutez une action gratuite telle que overview pour le même domaine ; si cela fonctionne, le problème est la clé
  • Confirmez que vous avez tapé le domaine nu dans q, sans chemin
  • Sauvegardez le JSON brut avant de changer quoi que ce soit
  • Vérifiez le solde dans le tableau de bord par rapport à _credits
  • Contactez-nous depuis votre page de compte avec l'action et un horodatage

Réponses rapides

Un appel échoué coûte-t-il des crédits ?

Un 401 ou 402 renvoie avant que des lignes ne soient servies. Chaque appel réussi est facturé une fois, quel que soit le nombre de lignes jusqu'à 1 000 lignes. Vérifiez _credits dans la réponse pour confirmer ce qu'un appel donné a coûté.

Pourquoi deux tirages le même jour diffèrent-ils ?

Ils ne devraient pas, car l'index ne change qu'à son rafraîchissement mensuel. S'ils diffèrent, comparez d'abord les paramètres de tri et de page, puis votre clé et l'action. La page de vérification gratuite couvre ce que les appels sans clé renvoient.