Making requests

Overview

The Typosquatting API provides four endpoints for detecting and investigating typosquatting domains. All requests are made via HTTP GET.

1. Check domain

Find the typosquatting groups that a domain belongs to.

1 request costs 1 DRS credit.

GET https://typosquatting.whoisxmlapi.com/api/v1/checkDomain?apiKey=YOUR_API_KEY&domainName=amoreresidences.com

Input parameters

apiKey

Required. Get your personal API key on the My products page.

domainName

Required. The domain name to check for typosquatting group membership. Accepts any UTF-8 string.

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Sample output

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "totalNoOfGrpMembers": 13
    }
]

Output fields

date
The date when the typosquatting group was detected, in YYYY-MM-DD format.
groupNumber
The typosquatting group identifier for the given date.
totalNoOfGrpMembers
The total number of domains in this typosquatting group.

2. Check domain (enriched)

Get enriched data for all domains in all groups that the given domain belongs to. This is the most detailed single-domain query, returning full WHOIS and registration details for every group member.

1 request costs 5 DRS credits.

GET https://typosquatting.whoisxmlapi.com/api/v1/checkDomainEnriched?apiKey=YOUR_API_KEY&domainName=iwin.exposed

Input parameters

apiKey

Required. Get your personal API key on the My products page.

domainName

Required. The domain name to check. Accepts any UTF-8 string. The example domain iwin.exposed is useful for testing as it appears in multiple groups.

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Sample output

Returns a JSON array of enriched records. See the enriched output fields section below for full field descriptions.

3. Get group

Get all domains in a specific typosquatting group (basic fields).

1 request costs 5 DRS credits.

GET https://typosquatting.whoisxmlapi.com/api/v1/getGroup?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Input parameters

apiKey

Required. Get your personal API key on the My products page.

date

Required. The detection date in YYYY-MM-DD format. Must be >= 2020-07-01.

groupNumber

Required. The typosquatting group number (integer).

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Sample output

[
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 1,
        "totalNoOfGrpMembers": 13,
        "domain": "example1.com",
        "domainUtf": "example1.com"
    },
    {
        "date": "2022-05-10",
        "groupNumber": 1,
        "groupMemberNumber": 2,
        "totalNoOfGrpMembers": 13,
        "domain": "example2.com",
        "domainUtf": "example2.com"
    }
]

Output fields

date
The date when the typosquatting group was detected, in YYYY-MM-DD format.
groupNumber
The typosquatting group identifier.
groupMemberNumber
The member's position within the group, ordered ascending.
totalNoOfGrpMembers
The total number of domains in this group.
domain
The domain name (ASCII).
domainUtf
The domain name in UTF-8 encoding (useful for internationalized domain names).

4. Get group (enriched)

Get all domains in a specific typosquatting group with full enriched WHOIS and registration data.

1 request costs 5 DRS credits.

GET https://typosquatting.whoisxmlapi.com/api/v1/getGroupEnriched?apiKey=YOUR_API_KEY&date=2022-05-10&groupNumber=1

Input parameters

apiKey

Required. Get your personal API key on the My products page.

date

Required. The detection date in YYYY-MM-DD format. Must be >= 2020-07-01.

groupNumber

Required. The typosquatting group number (integer).

outputFormat

Optional. Response output format.

Acceptable values: JSON | XML

Default: JSON

Sample output

Returns a JSON array of enriched records. See the enriched output fields section below for full field descriptions.

Enriched output fields

The enriched endpoints (checkDomainEnriched, getGroupEnriched) return the following fields for each record:

date
The date when the typosquatting group was detected, in YYYY-MM-DD format.
groupNumber
The typosquatting group identifier.
groupMemberNumber
The member's position within the group.
totalNoOfGrpMembers
The total number of domains in this group.
domain
The domain name (ASCII).
domainUtf
The domain name in UTF-8 encoding.
registrantName
The registrant's name from WHOIS records.
registrantOrganization
The registrant's organization.
registrantCountry
The registrant's country.
registrantState
The registrant's state or province.
registrantCity
The registrant's city.
registrantEmail
The registrant's email address.
registrarName
The name of the domain registrar.
registrarIANAID
The IANA ID of the registrar.
whoisServer
The WHOIS server for the domain.
nameServers
The name servers associated with the domain.
status
The domain status codes (e.g., clientTransferProhibited).
createdDate
The domain creation date as reported by the registrar.
updatedDate
The domain last-updated date as reported by the registrar.
expiresDate
The domain expiration date as reported by the registrar.
standardRegCreatedDate
The standardized domain creation date in YYYY-MM-DD HH:MM:SS format.
standardRegUpdatedDate
The standardized domain last-updated date in YYYY-MM-DD HH:MM:SS format.
standardRegExpiresDate
The standardized domain expiration date in YYYY-MM-DD HH:MM:SS format.
ips
The IP addresses associated with the domain.

价格

Each endpoint deducts a fixed number of DRS credits per successful request:

It takes up to a minute to activate your account after the registration.

Free access

After Sign Up you automatically get a free subscription plan limited to 500 DRS credits.

Usage limits and requests throttling

The maximum number of requests per second is 30. In case that the limit is breached, your subsequent requests will be rejected until the next second.

This API is also available with a dedicated load balancer and premium endpoint to enable faster querying as part of our Premium API Services and Enterprise API Packages.