seo/
whois

Call the Whois Lookup API to read a domain's current registration record, returning the registrar and IANA ID, registration, update and expiry dates, status codes, name servers and DNSSEC state.

Whois Lookup API

Current registration record
Expiry date
Registrar and IANA ID
Name servers
5 credits / request
Ready
Ready

Enter parameters and send a request. The task status and normalized results will appear here.

README

By SocQ · Updated

Whois Lookup

Whois Lookup returns the public registration record of a domain, listing the registrar with its IANA ID, the dates the domain was registered, last updated and set to expire, its status codes, name servers and DNSSEC state, plus the registrant organization and country where the record lists them. Those dates and settings tell you how old a domain is, when its registration runs out, whether it is locked against transfer and where its DNS is delegated, which supports expiry monitoring, vendor checks and portfolio audits.

Whois Lookup API Features

  • Current record at request timeThe Whois Lookup API reads the registration record at request time, so dates and statuses reflect the domain as it stands when you ask.
  • Registration, update and expiry datespublished_at, updated_at and expires_at give the registration timeline in ISO 8601, from first registration to the current expiry.
  • Registrar with its IANA IDregistrar names the company managing the domain and registrar_iana_id gives its IANA number for matching against registrar lists.
  • Status codes, name servers and DNSSECstatuses lists domain status codes such as client transfer prohibited, nameservers shows where DNS is delegated, and is_dnssec_signed reports whether DNSSEC is on.
  • Subdomains resolved to the registered domainA host such as docs.example.com is looked up under example.com, so a hostname copied from a link or an email address can be submitted as it is.

Whois Lookup API Parameters

ParametersRequiredDescription
targetRequiredOne domain, such as github.com, or a site root such as https://github.com/. Subdomains are looked up under their registered domain; pass the host only, without a page path.

How to Use the Whois Lookup API

Send one domain to the Whois Lookup API and read its registration record as a single row.

  1. POST {"target": "github.com"} to /v1/seo/whois.
  2. Poll GET /v1/tasks/{task_id} until status is succeeded.
  3. Read the record from results.items; has_more and results.next_cursor follow the usual paging rules and stay empty for this single row.
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"}'

Whois Lookup API Use Cases

  • Expiry monitoring: Store the expires_at the Whois Lookup API returns for domains you own or want and schedule checks ahead of that date to renew in time or catch a release.
  • Checking a vendor's domain age: Compare published_at with today to see how long a supplier's or new contact's domain has existed before you trust it.
  • Auditing a domain portfolio: Line up registrar, nameservers, is_dnssec_signed and statuses across your domains to find ones at the wrong registrar, without DNSSEC or missing a transfer lock.
  • Spotting registration changes: Watch updated_at together with statuses and nameservers to notice when a domain's record changed, for example after a registrar transfer or a DNS move.

Whois Lookup API Pro Tips

  • When a list holds several subdomains of one domain, reduce them to the registered domain first, since each would return the same row at 5 credits per Whois Lookup API request.
  • Compute domain age and days to expiry from published_at and expires_at against collected_at, all of which are ISO 8601 timestamps.
  • Match statuses against the lowercase phrases they come back as, such as client transfer prohibited, rather than the camel-case EPP codes.

Beyond the Whois Lookup API, use these APIs when you need a different type of public SEO data.

  • Google Organic SERP API — Retrieve one live Google result page by query and market with normalized destinations, ranks, element types, and full result details.
  • Keyword Difficulty API — Compare organic ranking difficulty for a submitted keyword batch, returning each available keyword with its normalized score.
  • Keyword Overview API — Enrich a submitted keyword batch with available demand, paid competition, difficulty, monthly-search, and intent context.
  • Backlinks Summary API — Summarise the link profile of one domain, subdomain or page in a single row with authority rank, backlink and referring-domain totals, spam score and link source breakdowns.
  • Domain Overview API — Get one domain's organic and paid Google totals for a chosen country and language, with ranking keywords, estimated traffic and its ad cost, position bands and ranking changes.
  • Domain Technologies API — Detect the technologies a website runs from its domain, with categories, authority rank, social profiles and published contacts.

Explore other platforms

Combine SEO data with public data from other supported social platforms.

Whois Lookup API — FAQ

Whois Lookup API is a programmatic interface for reading the current registration record of a domain, given a domain or subdomain name. It returns the registrar and its IANA ID, registration, update and expiry dates, status codes, name servers, DNSSEC state and the registrant organization and country where the record lists them.

Lookups cover .com, .net, .org and other generic extensions as well as country extensions such as .uk and .ai, and each domain returns its full public registration record.

registrant_organization and registrant_country give the owner's organization and country whenever the public record lists them, and the registrar, dates and name servers come back for every domain.

Each request takes one domain in target, so submit one request per domain and collect expires_at from each result.

Each lookup checks one domain, returns one row and costs 5 credits.