Recette
Comment vérifier mes backlinks ? Une recette avec quatre requêtes
Quatre requêtes, une clé, environ 5 crédits au total. Remplacez example.org par votre domaine et le reste s'exécute tel quel.

Ingrédients et méthode
- 1
Obtenir une clé
Connectez-vous avec Google sur la page de compte. Vous recevez 100 $ de crédit, soit 1 000 000 de crédits, et une clé commençant par sk_live_.
- 2
Obtenir l'aperçu (0 crédit)
Un appel gratuit confirme que le domaine est indexé et affiche les totaux de son titre.
- 3
Extraire les domaines référents (2 crédits)
La liste des sites distincts qui vous lient, jusqu'à 1 000 par appel.
- 4
Lire les anchors (2 crédits)
Le libellé que les autres sites utilisent pour vous. Comparez-le avec le nom de marque que vous attendriez.
- 5
Filtrer vos voisins (1 crédit)
Exécutez bulk_dr sur les sites qui vous lient, ou sur vos concurrents, pour voir où vous en êtes.
Les quatre requêtes
Échangez le domaine et la clé. Le formulaire d'en-tête maintient la clé hors des journaux serveur.
KEY=sk_live_...
D=example.org
curl "https://linkmidasai.com/api.php?action=overview&q=$D&key=$KEY"
curl -H "Authorization: Bearer $KEY" "https://linkmidasai.com/api.php?action=refdomains&q=$D&per=1000"
curl -H "Authorization: Bearer $KEY" "https://linkmidasai.com/api.php?action=anchors&q=$D"
curl -H "Authorization: Bearer $KEY" "https://linkmidasai.com/api.php?action=bulk_dr&domains=rival1.com,rival2.com"
Lire l'assiette
Goûtez avant d'assaisonner. Regardez les totaux avant les listes, et les listes avant de tirer une conclusion sur quoi que ce soit.
Si refdomains renvoie dix lignes et que votre site a deux ans, cela peut simplement être la réalité. S'il renvoie dix et que vous avez lancé une campagne il y a six mois, attendez le prochain rafraîchissement mensuel avant de décider quoi que ce soit, car les nouveaux liens atteignent l'index avec retard.
Chaque réponse authentifiée comporte un champ _credits avec le coût et le solde restant, afin qu'un script puisse s'arrêter avant de dépenser plus que prévu. Le code HTTP 402 signifie que le solde est épuisé.
Les lignes et les totaux peuvent diverger un certain temps après un rafraîchissement. Si le total de l'aperçu est supérieur aux lignes que vous avez extraites, vérifiez si une limite de lignes ou un paramètre de pagination a coupé la liste avant de qualifier la différence d'une perte.
Pour savoir quoi faire avec les chiffres, passez au modèle de notation ou lisez la comparaison des coûts.
Conservez chaque réponse dans un fichier nommé par date, action et domaine, de sorte qu'un tel nom vous indique ce qu'il contient. Dans trois mois, vous aurez une trace qu'aucun tableau de bord ne peut reconstituer, car la vue d'hier disparaît de la plupart des outils dès leur rafraîchissement.
Si vous exécutez la séquence pour un client, ajoutez la date et le coût en crédits au rapport. Un client qui voit que toute l'audit a coûté moins d'un centime cessera de se demander si cela vaut la peine de vérifier deux fois.
Lorsqu'un appel échoue dans un script
Un script qui exécute la recette sans surveillance rencontrera tôt ou tard des réponses lentes et des appels refusés. Prévoyez les deux avant la première boucle.
Lire le statut avant le corps
Vérifiez d'abord le statut HTTP. Un 401 signifie que la clé est incorrecte, et un 402 signifie que le solde est épuisé. Ni l'un ni l'autre ne se résout en renvoyant la même requête encore et encore.
Traitez toute autre erreur comme une raison de s'arrêter et de lire le message, et non comme un bruit à ignorer.
Une ligne de statut dans le journal, avec l'action et le code, suffit souvent pour diagnostiquer une exécution échouée le lendemain matin.
Donner de la marge aux appels lents
Un gros pull de refdomains peut mettre beaucoup plus de temps à retourner qu'un petit aperçu. Définissez un délai d'attente généreux pour les appels de liste et un court pour les actions gratuites, afin qu'une réponse lente ne soit pas confondue avec un échec.
Si la plupart des appels réussissent mais que quelques-uns prennent plusieurs secondes, ne masquez pas les lents. Exécutez les appels de liste moins souvent et les appels gratuits plus souvent, et le budget reste honnête.
Écrivez les valeurs de délai d'attente dans un commentaire en haut du script, afin que quiconque les modifie sache pourquoi elles ont été définies.
Relancer uniquement ce qui peut récupérer
Un délai d'attente peut être relancé une fois, après une pause. Une clé refusée ou un solde vide ne peuvent pas récupérer de cette manière, donc le script doit s'arrêter sur ces cas sans réessayer.
Journalisez chaque relance avec son heure et son action. Le journal montre alors à quelle fréquence la connexion a trébuché, ce qui est une preuve utile lorsqu'un exécution mensuelle revient en dessous des attentes.
Gardez le nombre de relances petit, afin qu'une mauvaise connexion ne puisse pas dépenser l'allocation du mois à l'intérieur d'une boucle qui pose la même question encore et encore.
Garder la clé hors de vue
Le formulaire d'en-tête dans la recette maintient la clé hors de l'adresse, donc elle n'apparaît pas dans un lien copié ou une ligne de journal partagée. Le formulaire URL est pratique pour un test rapide dans un terminal, mais c'est le premier à retirer avant qu'un script ne parte nulle part.
Stockez la clé dans une variable d'environnement, et ne la collez jamais dans un fichier qui sera partagé. Une clé qui apparaît dans une capture d'écran doit être considérée comme exposée, et remplacée.
Trois variations une fois que la base fonctionne
Changez un ingrédient à la fois. Chaque variation ci-dessous réutilise la même clé.
Mettez en place une surveillance mensuelle. Placez l'appel d'aperçu dans une tâche cron le premier du mois et ajoutez la sortie à un fichier daté. L'index se rafraîchit environ une fois par mois. Une exécution quotidienne ne vous apprend rien de nouveau.
Pour une comparaison avec un rival, exécutez compare avec jusqu'à 20 domaines pour un seul crédit et conservez le tableau. Trois rivaux, une fois par trimestre, c'est largement suffisant.
L'outreach ensuite. Utilisez intersect avec deux ou trois listes de concurrents pour trouver les sites qui lient vers plusieurs d'entre eux. Ces sites citent déjà votre catégorie, donc ils constituent une meilleure première liste d'e-mails qu'un annuaire à froid. Exécutez search (3 crédits) avec une phrase exacte lorsque vous voulez trouver qui est lié avec un anchor spécifique.
Total pour les trois : environ 6 crédits par mois, soit 0,0006 $. Même dix fois cela reste sous un centime.

Lire les notes avant d'exécuter la recette
La recette est courte, et c'est son attrait. Une courte recette n'est sûre que si vous avez lu les notes qui l'accompagnent.
Lire les notes sur les paramètres une fois
Chaque action a son propre coût et sa propre limite de lignes. La référence des champs les liste, et les quatre requêtes ci-dessus supposent que vous avez lu ce tableau.
Sauter cette étape est la façon dont un script finit par payer pour plus de lignes que nécessaire, généralement sans que personne ne s'en rende compte jusqu'à ce que le solde semble incorrect.
Un appel est facturé une fois quel que soit le nombre de lignes qu'il retourne, jusqu'à 1 000 par appel. Une valeur per de 1000 coûte donc les mêmes 2 crédits qu'une petite liste, ce qui en fait le moyen le moins cher de voir plus d'un profil.
Revérifier après un changement dans les notes
Les paramètres et les prix peuvent changer entre les versions. Lorsqu'une note change, exécutez le premier appel à la main et comparez ses clés et sa valeur _credits avec ce que votre script attend.
Seulement alors mettez à jour la boucle. Un script qui lit silencieusement la mauvaise clé est plus difficile à repérer qu'un qui échoue bruyamment.
Planifiez la vérification pour le lendemain du rafraîchissement mensuel plutôt que la veille, afin de comparer avec les nouvelles données et non les anciennes.
Conserver une copie de ce que vous lisez
Enregistrez la date et la page que vous avez lues dans le même dossier que la sortie. Une question ultérieure sur pourquoi un nombre a bougé est plus facile à répondre lorsque vous savez quelles règles étaient en vigueur ce jour-là.
Notez le coût en crédits de toute l'exécution dans le même dossier. Cinq crédits valent demi-centime, et un chiffre aussi petit est facile à oublier jusqu'à ce que le total du mois arrive.
Lorsque vous partagez les fichiers sauvegardés avec un client, retirez d'abord la clé et laissez les dates, les actions et les totaux en place.
Avant de sauvegarder la sortie
- Date écrite dans le nom de fichier
- Clé conservée hors du dépôt
- per défini à 1000 pour les appels de liste
- Le total _credits noté
- Une deuxième exécution planifiée après le prochain rafraîchissement mensuel
Questions sur l'exécution de la recette
Cinq questions se posent une fois que cette recette passe d'un terminal à un script. Les réponses courtes ci-dessous sont celles que nous donnerions à un collègue.
Comment vérifier mes backlinks depuis un script sans trop dépenser ?
Lisez la valeur _credits sur chaque réponse authentifiée et comparez-la avec une limite écrite dans le script. Chaque réponse porte le coût de cet appel, donc une boucle peut vérifier le solde avant le prochain pull.
Ai-je besoin d'une clé pour la première requête ?
Non. L'appel d'aperçu est l'une des actions gratuites, donc la première requête s'exécute sans clé. Les trois autres facturent des crédits et nécessitent une clé, c'est pourquoi le formulaire d'en-tête est celui à conserver dans le script.
Pourquoi stocker les réponses au lieu de rappeler la prochaine fois ?
Une réponse enregistre ce que l'index disait un jour donné. Rappeler retourne l'index tel qu'il est alors, et vous facture à nouveau. Un fichier enregistré vous permet de comparer les mois sans payer deux fois pour la même lecture.
Que faire si un résultat semble vide ?
Une liste vide signifie pas encore vu par l'index, pas que le domaine n'a pas de liens. Vérifiez d'abord les totaux de l'aperçu, puis attendez le prochain rafraîchissement mensuel avant de conclure quoi que ce soit.
Combien coûte la recette à quatre requêtes au total ?
L'aperçu est gratuit, refdomains coûte 2 crédits, anchors coûte 2 et bulk_dr coûte 1 pour une liste de rivaux. Cela fait 5 crédits, soit 0,0005 $, pour un tour complet. Douze passages mensuels font 60 crédits, soit 0,006 $, ce qui est un chiffre utile à mettre devant un client.
Elle ne montrera pas les liens de la semaine dernière, les classements par mot-clé ou le trafic. Pour cela, Search Console et une suite complète restent prioritaires.