Docs
Référence des endpoints et tarification
Une URL, de nombreuses actions. C'est l'intégralité de la surface d'exposition.
Équipe de recherche SEOCheck ·

Actions et coûts
| Action | Crédits | Ce que cela retourne |
|---|---|---|
| domain | gratuit | Fiche de base et DR pour un domaine |
| overview | gratuit | Résumé du profil de liens d'un domaine |
| stats | gratuit | Statistiques à l'échelle de l'index |
| suggest | gratuit | Suggestions de domaines au fur et à mesure de la frappe |
| bulk_dr | 1 | DR pour jusqu'à 2 000 domaines |
| compare | 1 | Côte à côte pour jusqu'à 20 domaines |
| top | 1 | Domaines les plus cités |
| dr_distribution | 1 | Répartition du DR parmi les domaines référents |
| tld_breakdown | 1 | Liens par domaine de premier niveau |
| refdomains | 2 | Domaines référents |
| backlinks | 2 | Backlinks individuels |
| anchors | 2 | Textes d'ancrage |
| toppages | 2 | Pages les plus liées |
| anchor_cloud | 2 | Poids des ancres |
| intersect | 2 | Liens communs pour 2 à 10 domaines |
| search | 3 | Recherche en texte intégral sur les ancres, les titres et les URLs |
| keyword | 3 | Qui est lié avec une ancre exacte |
Auth et format
URL de base : https://seocheck.dev/api.php?action=<action>&q=<domain>&key=sk_.... Vous préférez les en-têtes ? Envoyez Authorization: Bearer sk_... à la place.
Cette API d'analyse des backlinks répond en JSON et permet les appels cross-origin, de sorte qu'un navigateur peut l'appeler directement. Chaque réponse contient un champ ok. Celles qui sont authentifiées incluent également _credits, qui indique le coût de cet appel et votre solde restant.
Les erreurs sont brutales. Un HTTP 401 signifie que la clé est manquante ou incorrecte. Un HTTP 402 signifie que le solde est épuisé. Les deux sont faciles à gérer et ne doivent pas faire l'objet de nouvelles tentatives en boucle.
Avant le premier appel payant
- Exécutez
overviewsur un domaine que vous connaissez. C'est gratuit. - Vérifiez que votre clé fonctionne avec un appel de 1 crédit, tel que
compare. - Lisez
_creditsdans la réponse et confirmez que le coût correspond au tableau ci-dessus. - Définissez une alarme de script pour le HTTP 402 afin qu'un solde vide ne fasse pas échouer la tâche silencieusement.
Pagination et tri
Le nombre de lignes par appel peut atteindre 1 000. Demandez-en moins ou plus avec per, de 10 à 5000, naviguez avec page, et triez avec sort et order.
curl -s "https://seocheck.dev/api.php?action=backlinks&q=example.com&per=500&page=2&sort=dr&order=desc&key=sk_live_..." | jq '._credits'
Paramètres qui modifient la réponse
Chaque action prend les deux bases, action et q, puis un ensemble court d'options. Lisez-les d'abord. La plupart des erreurs proviennent d'options qui semblent optionnelles mais qui modifient le coût ou la forme des lignes. Lisez les options avant de copier un appel depuis un forum ou un blog.
Les exemples ci-dessous supposent une clé dans le paramètre key. Remplacez l'espace réservé par la vôtre. Conservez la clé dans une variable d'environnement, et non dans un fichier que vous validez. Chaque exemple dans cette référence d'API d'analyse des backlinks utilise la même URL de base.
Pagination avec page et per
L'option per définit le nombre de lignes retournées, de 10 à 5000. L'option page vous fait naviguer dans l'ensemble. Un appel demandant 500 lignes puis page 2 retourne le bloc suivant, et non le prochain tirage des mêmes lignes.
La pagination profonde s'arrête à 50 000 lignes. Si un traitement nécessite plus que cela, affinez la requête avec sort ou divisez le travail par domaine, afin que chaque appel reste dans les limites.
Tri avec sort et order
Tri sur le serveur, et non dans votre script. Demander sort=dr&order=desc retourne les domaines référents les plus forts en premier, de sorte que les lignes qui vous intéressent arrivent sur la première page. Filtrer après un téléchargement complet gaspille à la fois du temps et des crédits.
Utilisez order=asc lorsque vous souhaitez les lignes les plus faibles, par exemple pour trouver des liens minces ou repérer une chute soudaine dans un profil.
Listes : bulk_dr, compare et intersect
Les actions de liste prennent plusieurs domaines en un seul appel. bulk_dr accepte jusqu'à 2 000 domaines pour un crédit, avec une chaîne de requête GET ou un corps POST. compare prend jusqu'à 20 domaines, et intersect en prend deux à dix.
Puisque le prix ne dépend pas du nombre de lignes, une longue liste en un seul appel est moins chère que de nombreux appels courts. Disons que vous vérifiez 1 500 sites prospects le lundi. C'est un appel, et non 1 500.
Les appels de recherche et de mot-clé coûtent plus cher
L'action search effectue une recherche en texte intégral sur les ancres, les titres et les URLs. L'action keyword demande qui est lié avec une ancre exacte. Les deux coûtent trois crédits par appel, utilisez-les donc pour répondre à une question spécifique plutôt que pour naviguer.
Choix de per et page pour un premier tirage
Pour un premier aperçu d'un nouveau domaine, commencez avec un per petit, comme 50. Vous verrez la forme des lignes, les noms de champs et le coût en une courte réponse. Augmentez per uniquement lorsque vous savez que les lignes sont ce dont vous avez besoin. La même habitude fonctionne pour chaque action du tableau ci-dessus.
Une erreur courante est de demander 5000 lignes dès la première tentative, puis de rejeter la plupart d'entre elles. La réponse est plus volumineuse, l'attente est plus longue et l'économie espérée n'apparaît pas.
Lecture du compteur de crédits
Chaque réponse authentifiée se termine par _credits, qui indique le coût de cet appel et votre solde après celui-ci. Journalisez-le. Additionnez-le à la fin du mois et vous connaîtrez votre facture réelle au cent près.
Un budget approximatif aide. Un millier d'appels refdomains coûtent 2 000 crédits, soit 0,20 $. Un millier d'appels search coûtent 3 000 crédits, soit 0,30 $. Un bulk_dr quotidien sur une liste de 2 000 domaines coûte 1 crédit, soit environ 0,003 $ par mois.
Par rapport aux plans à partir de 129 $ par mois pour 200 000 unités API, comme les liste Ahrefs, la forme de la facture est différente. Voir la comparaison pour savoir comment.

Lecture des erreurs et du champ _credits
Une réponse peut échouer de deux manières différentes, et votre code doit les traiter différemment. Ce sont des problèmes différents. Une clé incorrecte est un problème de configuration. Un solde vide est un problème de facturation. Traiter les deux comme une erreur générique masque la correction nécessaire.
Lisez d'abord le champ ok. Ensuite, lisez le bloc _credits. Ce n'est qu'après cela que vous devez examiner les lignes, car un résultat manquant ou court est plus facile à expliquer lorsque vous connaissez déjà le coût de l'appel.
Gérez 401 et 402 séparément
Le HTTP 401 signifie que la clé est manquante ou incorrecte. Arrêtez le traitement et corrigez la clé. Le HTTP 402 signifie que le solde est épuisé. Rechargez depuis la page du compte, puis continuez. Relancer un 401 n'aide jamais, et relancer un 402 sans rechargement n'aide jamais non plus.
Journalisez le solde avant et après un traitement
Notez le solde _credits au début et à la fin d'un traitement. La différence devrait correspondre à ce que vous attendiez des appels effectués. Un saut plus important signifie qu'une boucle a tourné plus souvent que prévu.
Pour une vérification rapide, multipliez le nombre d'appels par leur coût en crédits. Si la réponse est 40 et que le solde a diminué de 4 000, quelque chose ne va pas avec le script, et non avec la liste des prix.
Vérifiez les lignes demandées
Une réponse réussie avec moins de lignes que prévu n'est pas automatiquement une erreur. Un petit domaine peut simplement avoir peu de liens. Comparez le nombre de lignes avec la valeur per que vous avez envoyée, et traitez un écart comme une question à laquelle répondre, et non comme un défaut à masquer.
Testez d'abord les appels peu coûteux
Avant d'intégrer un appel dans un traitement, exécutez-le une fois à la main avec les options les plus petites raisonnables. Vérifiez la réponse, les noms de champs et la valeur _credits. Un traitement qui échoue sur la deuxième ligne est beaucoup plus difficile à déboguer qu'un appel qui a échoué dès sa première tentative.
Une première session avec l'API
Quatre appels, dans l'ordre, de sorte que chaque appel ultérieur soit un que vous comprenez déjà. Seul le premier est gratuit, et c'est intentionnel.
Exécutez overview sur un domaine que vous connaissez
C'est gratuit et ne nécessite pas de clé. Comparez le résumé avec ce que vous voyez dans la console de recherche et sur le site lui-même, afin de savoir à quoi ressemble une réponse normale.
Testez la clé avec un appel de 1 crédit
Envoyez compare avec votre domaine et un rival. Confirmez que le champ ok est vrai et que _credits indique un coût d'un crédit.
Récupérez une liste de 2 crédits avec un per petit
Demandez refdomains avec per=50 et sort=dr. Vérifiez que le nombre de lignes et le coût en crédits correspondent au tableau ci-dessus.
Écrivez le coût dans votre journal
Enregistrez le solde avant et après. À partir de maintenant, chaque script que vous écrivez commence par cette habitude, et une facture surprise devient une ligne dans un journal au lieu d'un mystère.
Tarification
Crédits prépayés. Un crédit vaut 0,0001 $. Il n'y a pas d'abonnement ni de minimum mensuel.
Actions gratuites
$0
- domain, overview, stats, suggest
- Aucune clé nécessaire
- Alimente le vérificateur web
Payer à l'usage
$0.10par 1 000 appels de 1 crédit
- 100 $ de crédits gratuits à l'inscription
- Pas de carte nécessaire
- Recharger avec USDT (TRC-20)
- Facturé une fois par appel, et non par ligne
Limites à connaître
L'index couvre 181 132 097 domaines et 2 774 625 913 liens de domaine. Il se rafraîchit environ mensuellement. C'est plus lent qu'un crawl quotidien.
La pagination profonde s'arrête à 50 000 lignes. Pour des tirages plus importants, affinez la requête avec sort ou divisez par domaine.
La connexion est uniquement Google, et les recharges sont en USDT. Commencez par le vérificateur DR, essayez un audit de concurrent avec le guide concurrent, ou lisez pourquoi certaines équipes abandonnent l'API Ahrefs pour le travail de liens pur.
FAQ
Puis-je payer par ligne ?
Non. Un appel est facturé une fois, qu'il retourne 10 lignes ou 1 000.
Que se passe-t-il lorsque les crédits s'épuisent ?
L'API retourne HTTP 402. Rechargez avec USDT (TRC-20) depuis la page du compte et continuez.
Où puis-je trouver ma clé ?
Dans le tableau de bord après la connexion Google.