Séparer index et commandes
Une API de backlinks fournit les observations d’un index ; une API de commandes crée ou consulte des transactions. Recevoir des données ne publie aucun lien, et un reçu ne découvre pas le Web. L’exemple suit DataForSEO v3 Backlinks Live. L’inspecteur traite un fichier local sans clé ni appel payant. Les domaines réservés constituent un exercice fictif, pas les résultats d’un scan.
Valider la réponse avant les lignes
La documentation du point d’accès distingue réponse, tâche, requête et résultats. L’outil exige une tâche réussie et un résultat. Une erreur ne signifie pas zéro backlink ; un statut HTTP correct ne suffit pas. Consultez les définitions des erreurs. Conservez cible, filtres et regroupement. Le fournisseur peut regrouper plusieurs références d’une même source : une ligne ne compte pas forcément chaque ancre physique.
Lire quatre observations fictives
Le fichier annonce neuf résultats mais n’en fournit que quatre. Les cinq absents ne sont pas des liens perdus prouvés. Les lignes montrent un indicateur follow, sponsored/nofollow, une perte rapportée et des inconnues. Les dates sont des observations historiques du fournisseur. False, zéro et absence restent distincts ; les paires répétées sont gardées. Une structure JSON valide n’authentifie ni l’origine ni l’exactitude des affirmations.
| Contrôle | Champ ou valeur fictive | Interprétation | Ne pas déduire |
|---|---|---|---|
| Réponse et tâche | status_code: 20000 aux deux niveaux | Structure réussie prise en charge | Nouvelle inspection des sources |
| Total et reçu | total_count: 9; items_count: 4 | Quatre lignes ; résultat partiel | Cinq pertes ou inventaire complet |
| Source et cible | url_from; url_to | Conserver la paire exacte | Chaque ligne compte toutes les ancres |
| Valeurs typées | dofollow: false / null | Faux déclaré et inconnu diffèrent | Absent signifie follow |
| Observation historique | is_lost: true; last_seen: 2026-10-03 | Perte rapportée par le fournisseur | Suppression vérifiée aujourd’hui |
| Contexte | mode: as_is; backlinks_status_type: all | Garder le périmètre avec les lignes | Même total avec un autre filtre |
Borner les appels avant de dépenser
Une vraie intégration nécessite des secrets côté serveur, un budget approuvé et des paramètres enregistrés. Vérifiez prix et limites actuels, puis conservez la réponse brute. La pagination doit garder le même périmètre ; comparez lignes reçues et total. Ne répétez pas aveuglément un appel payant au résultat incertain. Un indicateur perdu n’est pas une nouvelle vérification de suppression. L’API Search Console ne propose pas le rapport Liens ; les lignes de trafic ne le remplacent pas.
Importer localement et garder l’original
Chargez l’exemple, collez une réponse compatible ou ouvrez un fichier UTF-8. Vérifiez total, lignes, avertissement partiel et contexte. CSV facilite les tableaux ; JSON préserve les types. Texte vide et absent deviennent tous deux des cellules vides en CSV, et un texte ressemblant à une formule reçoit une apostrophe de protection. Téléchargez module, script de commande et exemple dans le même dossier. Les commandes Node.js ci-dessous n’utilisent pas le réseau. Les feuilles CSV sont des notes, pas des entrées JSON.
Télécharger la revue API remplie · Télécharger la revue API vierge
node backlink-api-cli.mjs backlink-api-example-fr.json > backlink-api-records.csv
node backlink-api-cli.mjs backlink-api-example-fr.json --json > backlink-api-projection.jsonRespecter les limites du résultat
L’outil accepte une tâche, un résultat, 1 000 éléments et 512 KiB au maximum. Les métadonnées de requête sélectionnées sont limitées à 2 000 caractères. Tous les champs ne sont pas exportés ; gardez le brut. Les dates ne deviennent pas des dates de publication. L’outil ne récupère aucune source, ne fusionne pas les pages et n’authentifie aucun compte. Même vide, une réponse valide ne décrit que son périmètre. Livraison actuelle, indexation et classement exigent des preuves séparées.