seo/
whois

Consulta il record di registrazione attuale di un dominio e ricevi registrar e ID IANA, date di registrazione, aggiornamento e scadenza, codici di stato, name server e stato DNSSEC.

Whois Lookup API

Record di registrazione attuale
Data di scadenza
Registrar e ID IANA
Name server
5 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

Whois Lookup

Whois Lookup restituisce il record di registrazione pubblico di un dominio, con il registrar e il suo ID IANA, le date di registrazione, ultimo aggiornamento e scadenza, i codici di stato, i name server e lo stato DNSSEC, oltre all’organizzazione e al paese del registrante quando il record li riporta. Queste date e impostazioni dicono quanto è vecchio un dominio, quando scade la registrazione, se è bloccato contro i trasferimenti e dove è delegato il suo DNS, e supportano il monitoraggio delle scadenze, le verifiche sui fornitori e gli audit dei portafogli di domini.

Funzionalità della Whois Lookup API

  • Record aggiornato al momento della richiestaOgni consultazione legge il record di registrazione al momento della richiesta, quindi date e stati riflettono il dominio così com’è quando lo chiedi.
  • Date di registrazione, aggiornamento e scadenzapublished_at, updated_at ed expires_at descrivono la cronologia della registrazione in ISO 8601, dalla prima registrazione alla scadenza attuale.
  • Registrar con il suo ID IANAregistrar indica la società che gestisce il dominio e registrar_iana_id il suo numero IANA, utile per il confronto con gli elenchi dei registrar.
  • Codici di stato, name server e DNSSECstatuses elenca codici di stato del dominio come client transfer prohibited, nameservers mostra dove è delegato il DNS e is_dnssec_signed indica se DNSSEC è attivo.
  • Sottodomini ricondotti al dominio registratoUn host come docs.example.com viene cercato sotto example.com, quindi puoi inviare così com’è un nome host copiato da un link o da un indirizzo email.

Parametri della Whois Lookup API

ParametriObbligatorioDescrizione
targetObbligatorioUn dominio, come github.com, o la radice di un sito, come https://github.com/. I sottodomini vengono cercati sotto il loro dominio registrato; passa solo l’host, senza percorso di pagina.

Come usare la Whois Lookup API

Invia un dominio e leggi il suo record di registrazione come riga singola.

  1. Invia con POST {"target": "github.com"} a /v1/seo/whois.
  2. Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
  3. Leggi il record da results.items; has_more e results.next_cursor seguono le normali regole di paginazione e restano vuoti per questa riga singola.
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"}'

Casi d’uso della Whois Lookup API

  • Monitoraggio delle scadenze: Salva expires_at dei domini che possiedi o che ti interessano e pianifica controlli prima di quella data per rinnovare in tempo o cogliere un dominio che si libera.
  • Verificare l’età del dominio di un fornitore: Confronta published_at con la data di oggi per capire da quanto esiste il dominio di un fornitore o di un nuovo contatto prima di fidarti.
  • Audit di un portafoglio di domini: Affianca registrar, nameservers, is_dnssec_signed e statuses dei tuoi domini per trovare quelli presso il registrar sbagliato, senza DNSSEC o privi del blocco dei trasferimenti.
  • Individuare modifiche alla registrazione: Osserva updated_at insieme a statuses e nameservers per accorgerti di quando il record di un dominio è cambiato, per esempio dopo un trasferimento di registrar o un cambio di DNS.

Consigli degli esperti per la Whois Lookup API

  • Quando un elenco contiene più sottodomini dello stesso dominio, riducili prima al dominio registrato, perché ognuno restituirebbe la stessa riga a 5 crediti per richiesta.
  • Calcola l’età del dominio e i giorni alla scadenza da published_at ed expires_at rispetto a collected_at, tutti timestamp in ISO 8601.
  • Confronta statuses con le frasi in minuscolo con cui vengono restituiti, come client transfer prohibited, e non con i codici EPP in camel case.

Oltre alla Whois Lookup API, usa queste API quando ti serve un altro tipo di dati pubblici di SEO.

  • Google Organic SERP API — Recupera una pagina di risultati Google in tempo reale per query e mercato con destinazioni, posizioni, tipi di elemento e dettagli completi dei risultati normalizzati.
  • Keyword Difficulty API — Confronta la difficoltà di posizionamento organico per un gruppo di parole chiave inviato, restituendo ogni parola chiave disponibile con il suo punteggio normalizzato.
  • Keyword Overview API — Arricchisce un gruppo di parole chiave inviato con domanda, concorrenza a pagamento, difficoltà, ricerche mensili e contesto dell’intento, se disponibili.
  • Backlinks Summary API — Riassume in una sola riga il profilo di link di un dominio, sottodominio o pagina con rank di autorità, totali di backlink e domini di riferimento, spam score e ripartizione delle fonti dei link.
  • Domain Overview API — Ottiene i totali Google organici e a pagamento di un dominio per un paese e una lingua, con parole chiave posizionate, traffico stimato e suo costo pubblicitario, fasce di posizione e variazioni di ranking.
  • Domain Technologies API — Rileva le tecnologie usate da un sito web a partire dal dominio, con categorie, rank di autorità, profili social e contatti pubblicati.

Esplora altre piattaforme

Combina i dati di SEO con i dati pubblici delle altre piattaforme social supportate.

Whois Lookup API — FAQ

Whois Lookup API è un’interfaccia programmatica per leggere il record di registrazione attuale di un dominio a partire dal nome di un dominio o di un sottodominio. Restituisce registrar e relativo ID IANA, date di registrazione, aggiornamento e scadenza, codici di stato, name server, stato DNSSEC e, quando il record li riporta, organizzazione e paese del registrante.

Le consultazioni coprono .com, .net, .org e le altre estensioni generiche, oltre a estensioni nazionali come .uk e .ai, e ogni dominio restituisce il suo record di registrazione pubblico completo.

registrant_organization e registrant_country indicano organizzazione e paese del registrante quando il record pubblico li riporta; registrar, date e name server vengono restituiti per ogni dominio.

Ogni richiesta accetta un solo dominio in target, quindi invia una richiesta per dominio e raccogli expires_at da ogni risultato.

Ogni consultazione controlla un dominio, restituisce una riga e costa 5 crediti.