seo/
whois

Consultez la fiche d’enregistrement actuelle d’un domaine, avec le bureau d’enregistrement et son ID IANA, les dates d’enregistrement, de mise à jour et d’expiration, les codes de statut, les serveurs de noms et l’état DNSSEC.

Whois Lookup API

Fiche d’enregistrement actuelle
Date d’expiration
Bureau d’enregistrement et ID IANA
Serveurs de noms
5 crédits par requête
Prêt
Prêt

Saisissez des paramètres et envoyez une requête. L’état de la tâche et les résultats normalisés s’afficheront ici.

README

Par SocQ · Mis à jour le

Whois Lookup

Une recherche whois renvoie la fiche d’enregistrement publique d’un domaine, avec le bureau d’enregistrement et son ID IANA, les dates d’enregistrement, de dernière mise à jour et d’expiration, les codes de statut, les serveurs de noms et l’état DNSSEC, ainsi que l’organisation et le pays du titulaire lorsque la fiche les mentionne. Ces dates et réglages indiquent l’âge d’un domaine, la fin de son enregistrement, son éventuel verrouillage contre les transferts et l’endroit où son DNS est délégué, ce qui sert à surveiller les expirations, à vérifier des fournisseurs et à auditer un portefeuille de domaines.

Fonctionnalités de la Whois Lookup API

  • La fiche à jour au moment de la requêteChaque recherche lit la fiche d’enregistrement au moment de la requête : dates et statuts reflètent le domaine tel qu’il est à cet instant.
  • Dates d’enregistrement, de mise à jour et d’expirationpublished_at, updated_at et expires_at retracent la chronologie de l’enregistrement en ISO 8601, du premier enregistrement à l’expiration en cours.
  • Bureau d’enregistrement et ID IANAregistrar nomme la société qui gère le domaine et registrar_iana_id donne son numéro IANA pour le rapprocher des listes de bureaux d’enregistrement.
  • Codes de statut, serveurs de noms et DNSSECstatuses liste les codes de statut du domaine comme client transfer prohibited, nameservers montre où le DNS est délégué et is_dnssec_signed indique si DNSSEC est activé.
  • Les sous-domaines ramenés au domaine enregistréUn hôte comme docs.example.com est recherché sous example.com : un nom d’hôte copié depuis un lien ou une adresse e-mail peut être envoyé tel quel.

Paramètres de la Whois Lookup API

ParamètresObligatoireDescription
targetObligatoireUn domaine, comme github.com, ou une racine de site comme https://github.com/. Les sous-domaines sont recherchés sous leur domaine enregistré ; indiquez seulement l’hôte, sans chemin de page.

Comment utiliser la Whois Lookup API

Envoyez un domaine et lisez sa fiche d’enregistrement sous forme d’une seule ligne.

  1. Envoyez {"target": "github.com"} en POST à /v1/seo/whois.
  2. Interrogez GET /v1/tasks/{task_id} jusqu’à ce que status vaille succeeded.
  3. Lisez la fiche dans results.items ; has_more et results.next_cursor suivent les règles de pagination habituelles et restent vides pour cette ligne unique.
curl -X POST "https://api.socq.ai/v1/seo/whois" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"target":"github.com"}'

Cas d’usage de la Whois Lookup API

  • Surveillance des expirations : Stockez expires_at pour les domaines que vous possédez ou convoitez et planifiez des vérifications avant cette date pour renouveler à temps ou saisir une libération.
  • Vérifier l’âge du domaine d’un fournisseur : Comparez published_at à la date du jour pour savoir depuis combien de temps existe le domaine d’un fournisseur ou d’un nouveau contact avant de lui faire confiance.
  • Auditer un portefeuille de domaines : Alignez registrar, nameservers, is_dnssec_signed et statuses pour tous vos domaines afin de repérer ceux qui sont chez le mauvais bureau d’enregistrement, sans DNSSEC ou sans verrou de transfert.
  • Repérer les changements d’enregistrement : Surveillez updated_at avec statuses et nameservers pour remarquer quand la fiche d’un domaine a changé, par exemple après un transfert de bureau d’enregistrement ou un déplacement du DNS.

Conseils d’expert pour la Whois Lookup API

  • Lorsqu’une liste contient plusieurs sous-domaines d’un même domaine, ramenez-les d’abord au domaine enregistré, puisque chacun renverrait la même ligne à 5 crédits par requête.
  • Calculez l’âge du domaine et le nombre de jours avant expiration à partir de published_at et expires_at rapportés à collected_at, tous horodatés en ISO 8601.
  • Comparez statuses aux expressions en minuscules sous lesquelles ils sont renvoyés, comme client transfer prohibited, plutôt qu’aux codes EPP en camel case.

En complément de la Whois Lookup API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques SEO.

  • Google Organic SERP API — Récupérez une page de résultats Google en direct par requête et marché, avec destinations, positions, types d’éléments et détail complet des résultats normalisés.
  • Keyword Difficulty API — Comparez la difficulté de classement organique d’un lot de mots-clés soumis et obtenez chaque mot-clé disponible avec son score normalisé.
  • Keyword Overview API — Enrichissez un lot de mots-clés soumis avec la demande, la concurrence payante, la difficulté, les recherches mensuelles et l’intention de recherche disponibles.
  • Backlinks Summary API — Résumez en une ligne le profil de liens d’un domaine, d’un sous-domaine ou d’une page, avec score d’autorité, totaux de backlinks et de domaines référents, score de spam et répartition des sources de liens.
  • Domain Overview API — Obtenez les totaux Google organiques et payants d’un domaine pour un pays et une langue, avec mots-clés positionnés, trafic estimé et son coût publicitaire, tranches de positions et évolutions de classement.
  • Domain Technologies API — Détectez les technologies qu’utilise un site web à partir de son domaine, avec leurs catégories, le score d’autorité, les profils sociaux et les coordonnées publiées.

Explorer d’autres plateformes

Combinez les données SEO avec les données publiques d’autres plateformes sociales prises en charge.

Whois Lookup API — FAQ

Whois Lookup API est une interface programmatique qui lit la fiche d’enregistrement actuelle d’un domaine à partir d’un nom de domaine ou de sous-domaine. Elle renvoie le bureau d’enregistrement et son ID IANA, les dates d’enregistrement, de mise à jour et d’expiration, les codes de statut, les serveurs de noms et l’état DNSSEC, ainsi que l’organisation et le pays du titulaire lorsque la fiche les mentionne.

Les recherches couvrent .com, .net, .org et les autres extensions génériques, ainsi que des extensions nationales comme .uk et .ai, et chaque domaine renvoie sa fiche d’enregistrement publique complète.

registrant_organization et registrant_country donnent l’organisation et le pays du titulaire chaque fois que la fiche publique les mentionne, et le bureau d’enregistrement, les dates et les serveurs de noms sont renvoyés pour chaque domaine.

Chaque requête accepte un seul domaine dans target : envoyez une requête par domaine et récupérez expires_at dans chaque résultat.

Chaque recherche vérifie un domaine, renvoie une ligne et coûte 5 crédits.