Whois Lookup API
curl --request POST \
--url https://api.socq.ai/v1/seo/whois \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/seo/whois"
payload = {
"target": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({target: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/seo/whois', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/seo/whois",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'target' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/seo/whois"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/seo/whois")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/whois")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}SEO
Whois Lookup
Look up a domain’s registrar, registration dates and name servers.
POST
/
v1
/
seo
/
whois
Whois Lookup API
curl --request POST \
--url https://api.socq.ai/v1/seo/whois \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"target": "<string>",
"callback_url": "<string>"
}
'import requests
url = "https://api.socq.ai/v1/seo/whois"
payload = {
"target": "<string>",
"callback_url": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({target: '<string>', callback_url: '<string>'})
};
fetch('https://api.socq.ai/v1/seo/whois', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/seo/whois",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'target' => '<string>',
'callback_url' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/seo/whois"
payload := strings.NewReader("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/seo/whois")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/seo/whois")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"target\": \"<string>\",\n \"callback_url\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Whois Lookup
Look up who manages a domain and when its registration runs out. Each lookup returns the current registration record: the registrar and its IANA ID, the registration, last update and expiry dates, domain status codes, name servers and whether DNSSEC is on, plus the registrant organization and country where the record lists them. Use it to check when a domain you want expires, verify a vendor’s domain age, or audit a portfolio of domains.{
"target": "github.com"
}
Standard Result Fields
Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, usefields for MCP queries, _result_fields for typed tools, or --result-fields in the CLI. Declared fields remain present when their value is null.
| Field | Type | Nullable | Description |
|---|---|---|---|
id | string | Yes | The registered domain, used as the identifier. |
platform | string | No | Platform the result belongs to, such as instagram or linkedin. |
resource | string | No | SocQ resource represented by the result, such as videos or comments. |
type | string | No | Category of the result item, such as video, post, or comment. |
url | string | Yes | Homepage URL of the domain. |
published_at | string | Yes | Time the domain was first registered, in ISO 8601 format. |
collected_at | string | No | Time SocQ collected or processed this result, in ISO 8601 format. |
domain | string | Yes | Registered domain name. |
registrar | string | Yes | Name of the registrar that manages the domain. |
registrar_iana_id | string | Yes | IANA ID of the registrar. |
registrant_organization | string | Yes | Organization of the registrant, as listed in the public registration record. |
registrant_country | string | Yes | Country of the registrant, as listed in the public registration record. |
updated_at | string | Yes | Time the registration record last changed, in ISO 8601 format. |
expires_at | string | Yes | Time the current registration expires, in ISO 8601 format. |
statuses | array<string> | Yes | Domain status codes, such as client transfer prohibited. |
nameservers | array<string> | Yes | Name servers the domain delegates to. |
is_dnssec_signed | boolean | Yes | Whether the domain is signed with DNSSEC. |
Completed Task Response
{
"code": 200,
"data": {
"task_id": "example-seo-whois",
"status": "succeeded",
"public_id": "seo/whois",
"result_count": 1,
"credits_amount": 5,
"results": {
"limit": 50,
"next_cursor": null,
"has_more": false,
"schema_id": "domain-registration",
"schema_version": "1.0",
"items": [
{
"id": "github.com",
"platform": "seo",
"resource": "whois",
"type": "domain-registration",
"url": "https://github.com",
"published_at": "2007-10-09T18:20:50Z",
"collected_at": "2026-11-17T14:43:28.384900Z",
"domain": "github.com",
"registrar": "MarkMonitor Inc.",
"registrar_iana_id": "292",
"registrant_organization": null,
"registrant_country": null,
"updated_at": "2026-09-07T09:22:52Z",
"expires_at": "2028-10-09T18:20:50Z",
"statuses": [
"client delete prohibited",
"client transfer prohibited",
"client update prohibited"
],
"nameservers": [
"dns1.p08.nsone.net",
"dns2.p08.nsone.net",
"dns3.p08.nsone.net",
"dns4.p08.nsone.net",
"ns-1283.awsdns-32.org"
],
"is_dnssec_signed": false
}
]
}
}
}
Authorizations
bearerAuthapiKeyAuth
Body
application/json

