API docs

Evaluate a domain's or IP address reputation based on numerous security data sources as well as on an instant host's audit procedure. For a given domain name or IP address, collect and evaluate over hundreds of parameters and calculate the resulting reputation score.

Making requests

GEThttps://domain-reputation-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&domainName=google.com

It takes up to 2 minutes to activate your account after Sign Up.

Input parameters: required

apiKey
Get your personal API KEY on My products page.
domainName
The target domain name or IPv4 address.

Input parameters: optional

mode
API can check your domain in 2 modes: 'fast' - some heavy tests and data collectors will be disabled. 'full' - all the data and the tests will be processed.

Acceptable values: fast (1 credit) | full (3 credits)

Default: fast
outputFormat
Response output format.

Acceptable values: JSON | XML

Default: JSON

Free access

After Sign Up you automatically get a free subscription plan limited to 100 queries per month.

Sample output

JSON
XML
                            {
   "reputationScore": 84.07,
   "testResults": [
      {
         "test": "WHOIS Domain check",
         "warnings": [
            "Owner details are publicly available"
         ]
      },
      {
         "test": "Malware databases check",
         "warnings": [
            "Listed on StopForumSpam"
         ]
      },
      {
         "test": "SSL certificate validity",
         "warnings": [
            "Recently obtained certificate, valid from  2019-03-01 09:43:57"
         ]
      },
      {
         "test": "SSL vulnerabilities",
         "warnings": [
            "HPKP headers not set",
            "HTTP Strict Transport Security not set",
            "Heartbeat extension disabled",
            "TLSA record not configured or configured wrong",
            "OCSP stapling not configured"
         ]
      }
   ]
}
                        
                            <xml>
   <reputationScore>84.07</reputationScore>
   <testResults>
     <testResult>
       <test>WHOIS Domain check</test>
       <warnings>
         <warning>Owner details are publicly available</warning>
       </warnings>
     </testResult>
     <testResult>
       <test>Malware databases check</test>
       <warnings>
         <warning>Listed on StopForumSpam</warning>
       </warnings>
     </testResult>
     <testResult>
       <test>SSL certificate validity</test>
       <warnings>
         <warning>Recently obtained certificate, valid from  2019-03-01 09:43:57</warning>
       </warnings>
     </testResult>
     <testResult>
       <test>SSL vulnerabilities</test>
       <warnings>
         <warning>HPKP headers not set</warning>
         <warning>HTTP Strict Transport Security not set</warning>
         <warning>Heartbeat extension disabled</warning>
         <warning>TLSA record not configured or configured wrong</warning>
         <warning>OCSP stapling not configured</warning>
       </warnings>
     </testResult>
   </testResults>
</xml>
                        
reputationScore
Composite safety score based on numerous security data sources. 0 is dangerous, and 100 is safe.
testResults[0].test

The test name which reduced the final score. By now, the following tests are available:

  • Open ports and services
  • WHOIS Domain check
  • WHOIS Domain status
  • Host configuration issues
  • Mail servers response
  • Malware databases check
  • Mail servers configuration check
  • WHOIS and DNS name servers match
  • Name servers response
  • Name servers configuration check
  • Name servers configuration meets best practices
  • Potentially dangerous content
  • Mail servers Real-time blackhole check
  • Mail servers Reverse IP addresses match
  • SOA record configuration check
  • SSL certificate validity
  • SSL vulnerabilities
testResults[0].warnings
The list of warnings detected during the test execution.

Account balance information

GEThttps://user.whoisxmlapi.com/service/account-balance?apiKey=YOUR_API_KEY
apiKey
Required. Get your personal API KEY on My products page.
productId
Optional. A list of the products' IDs can be found in the response.

- You can always check your account balance on the My products page. - Note that the following products use the same WHOIS credits: WHOIS API, Bulk WHOIS API, Domain Availability API. - Note that the following products use the same Domain Research Suite credits: Brand Alert API, Registrant Alert API, Reverse WHOIS API, WHOIS History API, Reverse IP/DNS API, Reverse MX API, Reverse NS API.
Try our Domain Reputation API for free
Get started
Have questions?
support@whoisxmlapi.com
We will get back to you within a day.
WHOIS API, Inc.

California
USA

Contact us