Lookalike Domains API
This endpoint returns lookalike domains detected for your organization. It supports two modes:
Org-wide mode (when
query
is empty): return all lookalikes for your organization.Domain mode (when
query
is a domain): return lookalikes only if that domain exists in your org’s watchlist; otherwise, return an error with the list of allowed domains.
Endpoint
POST https://api.whiteintel.io/get_lookalike_domains.php
Content-Type: application/json
Auth: API key in the request body. Access: Enterprise (and higher) plans only.
Request Body
apikey
string
✅
—
—
Your API key.
query
string
❌
""
domain or empty
If empty, returns all org results. If provided, must be in your org’s watchlist.
page
int
❌
1
>= 1
1-based page index.
limit
int
❌
500
1..5000
Page size.
Example Requests Org-wide (all lookalikes for your org):
curl -L 'https://api.whiteintel.io/get_lookalike_domains.php' \
-H 'Content-Type: application/json' \
--data '{"apikey":"<YOUR_KEY>","page":1,"limit":500}'
Single watchlist domain:
curl -L 'https://api.whiteintel.io/get_lookalike_domains.php' \
-H 'Content-Type: application/json' \
--data '{"apikey":"<YOUR_KEY>",query:"example.com","page":1,"limit":500}'
Behavior
Validate API key, plan eligibility, rate limit, and daily quota.
Normalize
query
(trim/lowercase).If
query
is empty → return all lookalikes for the user’sorganization_id
(paginated).If
query
is not empty:Ensure the domain exists in the org’s watchlist (
entry_type = 'domain'
).If it doesn’t, return an error with
allowed_queries
(the user’s/org’s watchlist domains).If it does, return lookalikes where
original_entry = query
(exact match; no LIKE).
Success Response
{
"success": true,
"remaining_daily_calls": 472,
"results": [{
"data_type": "lookalike",
"original_entry": "example.com",
"detected_domain": "examp1e.com",
"detected_domain_ip": ["203.0.113.10", "2001:db8::10"],
"detected_domain_ns": ["ns1.provider.net", "ns2.provider.net"],
"whois_json": {
"domain_name": "examp1e.com",
"registrar": "Registrar LLC",
"creation_date": "2023-06-01T00:00:00Z",
"creation_date_iso": "2023-06-01T00:00:00Z"
},
"creation_date_iso": "2023-06-01 00:00:00",
"discovered_at": "2025-09-06 11:28:53"
}]
}
Validation Failure (200 with guidance)
{
"success": false,
"error": "Query must be empty or one of your watchlist domains.",
"allowed_queries": ["example.com", "acme.org", "brand.io"]
}
Last updated