Comment fonctionne une vérification des backlinks de domaine via l'API ?

Envoyez le domaine sous forme de q à une action telle que overview, refdomains ou backlinks et lisez le JSON. Les actions gratuites n'ont pas besoin de clé. Les actions payantes nécessitent une clé dans un en-tête bearer ou sous forme de key= et coûtent de 1 à 3 crédits par appel, quel que soit le nombre de lignes.

Dois-je mettre la clé dans le navigateur ?

Non, et vous ne devriez pas. Le CORS est ouvert, donc le navigateur peut appeler l'API, mais une clé dans le code client est publique pour tous les visiteurs. Gardez les appels payants sur votre serveur et laissez le front-end parler à votre propre route.

Que se passe-t-il lorsque le crédit est épuisé ?

L'API répond HTTP 402. Une clé manquante ou incorrecte renvoie HTTP 401. Traitez les deux comme des signaux d'arrêt plutôt que de retenter. Vous rechargez avec USDT (TRC-20) depuis la page de compte et la même clé continue de fonctionner.

Combien de lignes sont renvoyées par appel ?

Jusqu'à 1 000 lignes par appel, et chaque appel est facturé une fois quel que soit le nombre de lignes. Page avec page et per. La pagination profonde est limitée à 50 000 lignes, donc pour des exportations plus volumineuses, restreignez la requête avec un tri ou une action différente.

Le DR est-il le même nombre que chez Ahrefs ?

Non. Le DR ici est notre propre métrique : round(100 log(ref_domains + 1) / log(2 10^7)). Il est similaire dans l'esprit au DR d'Ahrefs ou au DA de Moz mais est calculé à partir de notre propre index, donc comparez les tendances au sein d'un seul outil, pas les valeurs entre les outils.

À quelle fraîcheur sont les données de liens ?

Environ un mois. L'index est reconstruit environ une fois par mois, donc les liens récents peuvent manquer. Si votre produit promet des alertes quotidiennes sur les nouveaux liens, vous avez besoin d'un fournisseur de crawling quotidien et de cette API pour les chiffres en masse à bas coût.

Y a-t-il des frais mensuels ou un minimum ?

Pas d'abonnement et pas de minimum. Le crédit est prépayé : 1 crédit coûte $0.0001, donc 1 000 appels à 1 crédit coûtent $0.10. Les nouveaux comptes reçoivent $100 de crédit gratuit, sans carte nécessaire, avec connexion Google uniquement.

Données de backlinks en JSON : 100 $ de crédit gratuit, sans carte, connexion Google.

798,5 milliards de backlinks indexés

Vérification des backlinks de domaine pour votre propre tableau de bord

Un endpoint REST qui renvoie les domaines référents, les ancres, les pages principales et le DR au format JSON. Créez votre outil autour de celui-ci, et les premiers $100 d'appels sont offerts.

Obtenez $100 gratuits Lire le script DR en masse

Quatre actions ne nécessitent aucune clé
Un seul appel évalue jusqu'à 2 000 domaines
CORS ouvert, clé bearer ou dans la chaîne de requête

GET /api.php?action=domainJSON

$ curl "https://seomasters.dev/api.php?action=overview&q=nytimes.com&key=sk_live_..."

À quoi ça sert

Vérification des backlinks de domaine : quatre endpoints à intégrer en premier

Chaque action prend la cible dans q et renvoie du JSON avec un indicateur ok. Choisissez en fonction des besoins de votre interface, et non de ce qui semble impressionnant.

Recherches gratuites, sans clé

domain, overview, stats et suggest sont gratuits. Utilisez-les pour un widget public ou un test de fumée dans CI.

DR en masse pour un portefeuille entier

bulk_dr évalue jusqu'à 2 000 domaines par appel pour 1 crédit. Une seule requête nocturne couvre une grande liste de clients.

Domaines référents et ancres

refdomains, anchors et backlinks coûtent 2 crédits par appel, jusqu'à 1 000 lignes chacun, avec page, per, sort et order.

Intersection pour les tableaux d'écarts

intersect prend de 2 à 10 domaines et liste ceux qui les lient ensemble. Deux crédits, quel que soit le nombre de lignes.

Pour qui

Ce qui se cache derrière le JSON

Les chiffres proviennent de notre propre crawler et de notre propre index de liens : 181 132 097 domaines, 2 774 625 913 liens domaine à domaine et environ 798,5 milliards de backlinks. Rien n'est revendu par un tiers.

L'index est actualisé environ une fois par mois. Un lien placé la semaine dernière peut manquer, donc concevez votre interface pour afficher l'âge de l'index plutôt que de promettre des données en temps réel.

Les réponses authentifiées contiennent un objet _credits avec le coût de l'appel et votre solde restant. Journalisez-le. Votre responsable financier vous demandera où l'argent a été dépensé, et la réponse est déjà dans chaque réponse.

Deux pages sont à lire avant d'écrire du code : la référence du champ DR explique ce qu'est le score de 0 à 100, et le guide du proxy de tableau de bord montre où la clé doit se trouver.

Le premier rendu a-t-il besoin des chiffres ?

Cela dépend de qui lit la page. Une recherche publique que vous voulez indexer par les moteurs de recherche doit avoir ses chiffres déjà dans le HTML. Un tableau de bord connecté peut récupérer ses lignes après le chargement, bien qu'un tableau vide sur un téléphone lent ait l'air cassé.

La suggestion par défaut est simple : votre serveur appelle l'API, rend les lignes, et le navigateur trie et filtre uniquement. Le guide du proxy montre cette répartition dans Next.js, avec le gestionnaire de route inclus.

Où mettre la clé, une fois de plus

La clé ne doit jamais appartenir à une page qu'un visiteur peut ouvrir. Gardez-la dans une variable d'environnement côté serveur, et faites l'appel depuis du code qui s'exécute là où ce secret vit.

Les outils qui promettent de masquer une clé dans le bundle la cachent à un lecteur occasionnel, pas à quiconque a l'onglet réseau ouvert.

Chaînes d'argent reliant des piliers de pierre à travers une vallée brumeuse représentant les backlinks de domaine

Une requête, de bout en bout

Remplacez par votre clé. La valeur q est le domaine nu sans schéma ni chemin.

bash

curl -s "https://seomasters.dev/api.php?action=refdomains&q=example.com&per=100&sort=dr&order=desc" \
  -H "Authorization: Bearer sk_live_..."

# header or ?key= both work
# ok=false or HTTP 401/402 means stop and read the error

Checklist

Avant le premier déploiement en production

La clé vit dans une variable d'environnement côté serveur, jamais dans un bundle navigateur
Chaque réponse est vérifiée pour ok, pas seulement le statut HTTP
Les erreurs HTTP 401 et 402 ne sont pas retentées automatiquement
_credits est écrit dans votre propre journal à chaque appel
L'interface affiche l'actualisation mensuelle, donc personne ne lit les données comme étant en temps réel
La pagination s'arrête à la limite de 50 000 lignes au lieu de boucler indéfiniment

Périmètre

Une API de données de liens, pas une suite SEO complète

La recherche de mots-clés, le suivi des positions et le crawling quotidien frais sont mieux servis par Ahrefs ou Semrush. Ahrefs vend des unités API dans des abonnements à partir de $129 par mois pour 200 000 unités. Cette API facture les données de liens par appel.

Bon ajustement : tableaux de bord, audits, scoring en masse, outils internes
Ajustement faible : suivi des positions, volumes de mots-clés, alertes de liens en temps réel
Les données sont actualisées mensuellement, et les docs le disent clairement

Comment ça marche

De la connexion à un job nocturne

1
Connectez-vous avec Google
La page de compte émet votre clé sk_ et affiche le solde de démarrage de $100, 1 000 000 de crédits.
2
Exécutez une action gratuite
Appelez overview pour un domaine que vous connaissez bien. Comparez la sortie avec ce à quoi vous vous attendez avant de construire quoi que ce soit.
3
Écrivez la couche fetch
Enveloppez fetch une fois : injection de clé, vérification ok, journalisation _credits. Voir les notes de pagination pour la boucle de pagination.
4
Planifiez-le
Exécutez mensuellement pour les tirages profonds, quotidiennement pour bulk_dr. Le tableau des erreurs couvre ce qu'il faut faire lorsqu'une nuit se passe mal.

FAQ

Questions que les développeurs posent en premier

Comment fonctionne une vérification des backlinks de domaine via l'API ?: Envoyez le domaine sous forme de q à une action telle que overview, refdomains ou backlinks et lisez le JSON. Les actions gratuites n'ont pas besoin de clé. Les actions payantes nécessitent une clé dans un en-tête bearer ou sous forme de key= et coûtent de 1 à 3 crédits par appel, quel que soit le nombre de lignes.
Dois-je mettre la clé dans le navigateur ?: Non, et vous ne devriez pas. Le CORS est ouvert, donc le navigateur peut appeler l'API, mais une clé dans le code client est publique pour tous les visiteurs. Gardez les appels payants sur votre serveur et laissez le front-end parler à votre propre route.
Que se passe-t-il lorsque le crédit est épuisé ?: L'API répond HTTP 402. Une clé manquante ou incorrecte renvoie HTTP 401. Traitez les deux comme des signaux d'arrêt plutôt que de retenter. Vous rechargez avec USDT (TRC-20) depuis la page de compte et la même clé continue de fonctionner.
Combien de lignes sont renvoyées par appel ?: Jusqu'à 1 000 lignes par appel, et chaque appel est facturé une fois quel que soit le nombre de lignes. Page avec page et per. La pagination profonde est limitée à 50 000 lignes, donc pour des exportations plus volumineuses, restreignez la requête avec un tri ou une action différente.
Le DR est-il le même nombre que chez Ahrefs ?: Non. Le DR ici est notre propre métrique : round(100 log(ref_domains + 1) / log(2 10^7)). Il est similaire dans l'esprit au DR d'Ahrefs ou au DA de Moz mais est calculé à partir de notre propre index, donc comparez les tendances au sein d'un seul outil, pas les valeurs entre les outils.
À quelle fraîcheur sont les données de liens ?: Environ un mois. L'index est reconstruit environ une fois par mois, donc les liens récents peuvent manquer. Si votre produit promet des alertes quotidiennes sur les nouveaux liens, vous avez besoin d'un fournisseur de crawling quotidien et de cette API pour les chiffres en masse à bas coût.
Y a-t-il des frais mensuels ou un minimum ?: Pas d'abonnement et pas de minimum. Le crédit est prépayé : 1 crédit coûte $0.0001, donc 1 000 appels à 1 crédit coûtent $0.10. Les nouveaux comptes reçoivent $100 de crédit gratuit, sans carte nécessaire, avec connexion Google uniquement.