Guide de configuration

Trouvez votre liste de backlinks et configurez un suivi mensuel

Dix minutes de configuration vous donnent un enregistrement daté de qui vous lie. En cas de problème, vous comparez deux fichiers au lieu de deviner.

Équipe de recherche DarkSEO · Mis à jour 2026-10-28

Configuration en six étapes

Connectez-vous avec Google

Utilisez la page de compte pour vous connecter. Les nouveaux comptes bénéficient de 100 $ de crédit, sans carte requise.

Créez une clé API

La clé commence par sk_. Gardez-la hors des dépôts publics ; traitez-la comme un mot de passe.

Essayez la recherche gratuite

action=overview&q=yourdomain.com ne coûte rien et confirme votre clé et l'orthographe du domaine.

Récupérez les vraies listes

Exécutez refdomains, anchors et toppages, 1 000 lignes par appel, 2 crédits chacun.

Enregistrez avec la date

Nommez les fichiers comme refdomains-2026-10.json. Ne remplacez jamais le fichier du mois dernier.

Diff

Comparez les lignes avec le mois précédent. Les nouveaux domaines sont ce que vous devez lire.

Un appel, avec chaque champ expliqué

Remplacez le domaine et la clé. Le même schéma fonctionne pour toutes les actions.

bash

curl "https://darkseo.net/api.php?action=refdomains&q=yourdomain.com&per=1000&page=1&key=sk_live_..." \
  -o refdomains-2026-10.json

Référence des paramètres

Paramètre	Signification	Notes
action	Quel rapport exécuter	refdomains, backlinks, anchors, toppages et autres
q	Le domaine que vous examinez	Domaine nu, sans schéma
key	Votre clé API	Ou envoyez Authorization: Bearer sk_...
page	Numéro de page	La pagination profonde est limitée à 50 000 lignes
per	Lignes par page	De 10 à 5000 ; la facturation est une fois par appel
sort, order	Colonne de tri et asc ou desc	Utile pour voir les plus récents ou les plus gros en premier

Nommer, stocker et comparer les fichiers

Une liste de backlinks n'est utile que si les fichiers peuvent être comparés sans aide. Une règle de nommage claire et un dossier par mois font la majeure partie du travail. Passez dix minutes sur la règle maintenant, car une heure de tri plus tard est pire. Ensuite, ne les renommez jamais.

Utilisez le même schéma pour chaque domaine et chaque appel, afin qu'un tri simple aligne les fichiers par mois. Des schémas mixtes cassent le tri, et un tri cassé est la raison pour laquelle le fichier du mois dernier est écrasé.

Noms de fichiers qui s'alignent

Mettez l'année et le mois en premier, puis le domaine, puis le nom de l'appel, comme 2026-10 suivi du domaine et de refdomains. Les mois complétés à zéro s'alignent correctement, et un nom dans cet ordre se lit comme un journal.

Évitez les espaces et les caractères accentués dans les noms. Les scripts les gèrent mal, et une copie échouée peut ressembler à une copie réussie.

Un dossier par mois

Créez un dossier pour chaque mois et copiez les trois fichiers pour chaque domaine dedans. Un dossier par mois garde le mois dernier intact, donc un diff devient une comparaison entre deux dossiers.

Marquez le dossier en lecture seule une fois le mois fermé, si votre système le permet. Un fichier sauvegardé qui ne peut pas être édité est un enregistrement beaucoup plus solide.

Un court journal des modifications

Gardez un journal en texte brut dans le dossier racine. Écrivez une ligne par extraction avec la date, les domaines et les appels effectués. Un journal des modifications vous permet d'expliquer un écart dans la série des années plus tard, quand personne ne se souvient de la raison.

Ajoutez le coût en crédit de chaque réponse à la même ligne, afin que le journal double de facture.

Enregistrez chaque changement de la liste de domaines dans le même journal, avec la raison. Un domaine ajouté un mois explique un saut ce mois-là, et cela économise une longue recherche plus tard. Gardez les lignes simples, afin qu'un script puisse lire le journal si vous voulez un résumé automatique.

Erreurs et corrections

Erreur	Symptôme	Correction
Clé manquante ou incorrecte	HTTP 401	Vérifiez l'orthographe de la clé et de l'en-tête
Solde vide	HTTP 402	Rechargez avec USDT (TRC-20) depuis la page de compte
Lecture de `ok` ignorée	Fichier vide traité comme succès	Testez le drapeau ok dans votre script avant de sauvegarder
Écrasement du dernier mois	Pas de diff possible	Indiquez le mois dans le nom du fichier
Données en direct attendues	Nouveau lien manquant	L'index s'actualise environ mensuellement ; comparez mensuellement, pas quotidiennement

Automatisation

Une tâche cron le premier du mois suffit. Regroupez les trois appels curl dans un seul script shell, ajoutez le mois à chaque nom de fichier et configurez-le pour vous envoyer un email uniquement si le nombre de nouveaux domaines dépasse votre seuil.

Les réponses authentifiées incluent _credits avec le coût et le solde restant, permettant au script de vous avertir avant épuisement du solde. Testez-le une fois manuellement. Ensuite, laissez-le tranquille jusqu'à la réception de l'email.

Pour une équipe, associez le tirage mensuel aux seuils d'exemple, afin que tout le monde applique la même règle.

Gardez le script simple. Curl brut, une boucle sur vos domaines, un dossier par mois. Les scripts simples survivent aux changements de personnel.

Gestion d'une exécution échouée

Une exécution échouée ne doit pas modifier les fichiers du mois précédent et doit ajouter une ligne au journal des modifications. Le piège classique est un téléchargement partiel : un fichier qui existe mais contient un corps d'erreur ressemble à des données à première vue. Vérifiez la taille et le drapeau ok avant de le déplacer. Rien n'atteint le dossier mensuel sans vérification.

Si l'exécution échoue deux fois de suite, vérifiez d'abord l'orthographe de la clé et du domaine. L'appel de vue gratuite teste les deux à moindre coût, donc un échec à ce niveau indique si le problème vient de la configuration ou de l'appel payant.

Maintenir la surveillance dans un budget

Une surveillance est peu coûteuse une fois que vous maîtrisez l'arithmétique. Chaque appel payant est facturé une fois, quel que soit le nombre de lignes, jusqu'à 1 000 lignes par appel. Multipliez le nombre d'appels par leur coût en crédits, puis par 0,0001 $ par crédit, et vous obtenez la facture mensuelle. Faites cela en premier.

Voici le calcul pour trois appels sur un domaine. refdomains, anchors et toppages coûtent 2 crédits chacun, soit six crédits, ce qui revient à 0,0006 $ pour le mois.

Estimation de la facture mensuelle

Ajoutez un appel bulk_dr pour les nouveaux venus à 1 crédit, et le total augmente d'un crédit supplémentaire. Le tableau de la page des seuils calcule le cas de dix sites, vous permettant de voir comment les chiffres augmentent avec la liste.

Conservez l'estimation dans le même journal que les tirages. Une facture qui augmente est plus facile à expliquer si l'estimation a été notée au préalable.

S'arrêter avant l'épuisement du solde

Les réponses authentifiées incluent le coût et le solde restant. Lisez-les dans le script, comparez le solde avec l'estimation du mois suivant et avertissez-vous lorsque la marge est faible. Une réponse avec ok défini à false doit arrêter l'exécution avant toute sauvegarde de fichier.

Un HTTP 402 signifie que le solde est épuisé. Rechargez avec USDT (TRC-20) depuis la page de compte, puis relancez les appels de ce mois plutôt que de le sauter.

Une boucle mensuelle

Un croquis, pas un produit. Il sauvegarde trois rapports par domaine avec le mois dans le nom. Ajustez la liste et la clé.

bash

#!/bin/bash
M=$(date +%Y-%m)
for D in yourdomain.com second-site.org; do
  for A in refdomains anchors toppages; do
    curl -s "https://darkseo.net/api.php?action=$A&q=$D&per=1000&key=$DARKSEO_KEY" -o "$D-$A-$M.json"
  done
done

Que faire avec les fichiers

Ouvrez les fichiers refdomains du mois dernier et de ce mois côte à côte et listez les domaines qui ne sont présents que dans le nouveau. Cette liste est votre lecture du mois.

Envoyez la liste via bulk_dr pour un score de qualité rapide, vérifiez le fichier anchors pour toute expression qui a augmenté, et lisez les pages principales pour les URLs que vous ne reconnaissez pas. Si tout semble ordinaire, écrivez une ligne dans votre journal et fermez l'onglet.

Si quelque chose semble incorrect, ouvrez le runbook et le tableau de décision de désavouement. Le tirage mensuel coûte une fraction de centime, donc le vrai coût est votre attention.

Rédaction de la note mensuelle

Écrivez une courte note à la fin de chaque mois. Nommez les domaines, le nombre de nouveaux domaines, la plus grande part d'ancres et la décision. Quatre lignes suffisent. Une note écrite le jour même vaut plus qu'une longue écrite plus tard.

Conservez la note à côté des fichiers, pas à l'intérieur. Un lecteur futur devrait trouver la décision à un seul endroit, avec les chiffres qui l'ont justifiée. Ce lecteur peut être vous, un an plus tard, sans souvenir du mois.

Questions sur la surveillance mensuelle

Ai-je besoin d'un plan payant pour exécuter cela ?

Il n'y a pas d'abonnement ni de minimum mensuel, car le service fonctionne avec des crédits prépayés. Les nouveaux comptes reçoivent 100 $ de crédit gratuit sans besoin de carte. Les recherches gratuites ne coûtent rien, vous pouvez donc tester la configuration avant de télécharger toute liste payante.

Pourquoi ne pas exécuter le script tous les jours ?

L'index s'actualise environ une fois par mois, donc un travail quotidien téléchargerait à nouveau la même image. Les exécutions quotidiennes dépensent également des crédits pour aucune nouvelle information. Le rythme mensuel est le rythme honnête pour ces données.

Que faire si le nouveau fichier est beaucoup plus gros ?

Vérifiez le nombre de lignes par rapport à votre ligne de base, puis ouvrez les nouveaux venus dans le diff. Un fichier plus gros peut provenir d'un pic réel ou d'une limite de lignes modifiée. Éliminez d'abord la seconde cause, car c'est la vérification la moins coûteuse.

Un seul script peut-il surveiller plusieurs domaines ?

Oui. La boucle mensuelle ci-dessus gère une liste de domaines, et chacun obtient ses propres fichiers. Gardez la liste suffisamment courte pour que chaque domaine fasse l'objet d'une véritable lecture chaque mois, car une surveillance que personne ne lit n'est qu'un coût de stockage.

Deux limites à retenir

L'index s'actualise environ une fois par mois, donc une tâche cron quotidienne ne ferait que télécharger la même image. Et une liste de liens n'est pas un verdict : associez chaque signal au rapport de liens de Search Console avant d'agir.