API docs

Making requests

GEThttps://website-contacts-api.whoisxmlapi.com/api/v1?apiKey=YOUR_API_KEY&domainName=cisco.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 website's domain name.

Input parameters: optional

outputFormat
Response output format.

Acceptable values: JSON | XML

Default: JSON
hardRefresh
0 is used for getting the cached contacts information if there is one.
1 is used for demanding the website contacts information from scratch.

Acceptable values: 0 | 1

Default: 0

Free access

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

Sample output

JSON
XML
                            {
   "companyNames": [
      "YouTube",
      "YouTube LLC",
      "Brand Resources",
      "Google Inc.",
      "Fair Use"
   ],
   "countryCode": "US",
   "domainName": "youtube.com",
   "emails": [
      {
         "description": "",
         "email": "press@google.com"
      }
   ],
   "meta": {
      "description": "Enjoy the videos and music you love, upload ...",
      "title": "YouTube"
   },
   "phones": [
      {
         "callHours": "",
         "description": "",
         "phoneNumber": "1-800-273-8255"
      },
      {
         "callHours": "24 hours a day 7 days a week",
         "description": "",
         "phoneNumber": "1-800-273-8255."
      }
   ],
   "postalAddresses": [],
   "socialLinks": {
      "facebook": "",
      "googlePlus": "https://plus.google.com/+youtube",
      "instagram": "",
      "linkedIn": "",
      "twitter": ""
   },
   "websiteResponded": true
}
                        
                            <xml>
   <companyNames>
     <companyName>YouTube</companyName>
     <companyName>YouTube LLC</companyName>
     <companyName>Brand Resources</companyName>
     <companyName>Google Inc.</companyName>
     <companyName>Fair Use</companyName>
   </companyNames>
   <countryCode>US</countryCode>
   <domainName>youtube.com</domainName>
   <emails>
     <email>
       <description/>
       <email>press@google.com</email>
     </email>
   </emails>
   <meta>
     <description>Enjoy the videos and music you love, upload ...</description>
     <title>YouTube</title>
   </meta>
   <phones>
     <phone>
       <callHours/>
       <description/>
       <phoneNumber>1-800-273-8255</phoneNumber>
     </phone>
     <phone>
       <callHours>24 hours a day 7 days a week</callHours>
       <description/>
       <phoneNumber>1-800-273-8255.</phoneNumber>
     </phone>
   </phones>
   <postalAddresses/>
   <socialLinks>
     <facebook/>
     <googlePlus>https://plus.google.com/+youtube</googlePlus>
     <instagram/>
     <linkedIn/>
     <twitter/>
   </socialLinks>
   <websiteResponded>1</websiteResponded>
</xml>
                        
domainName
Website's URL
websiteResponded
Determines if the website was active during the crawling. The website is considered to be active if it:
  • Responds within 20 seconds timeout (Connection timeout - 10s, Response read timeout - 10s)
  • Responds with 200 HTTP code
  • Sends Content-Type header which is either text/html or text/plain
meta.title
Website title provided in the title tag.
meta.description
Website description defined in the description meta tag on the main page.
countryCode
Website country (ISO-3166).
companyNames[]
The list of possible company names.
emails[0].email
Email address itself.
emails[0].description
Email address description. (e.g. department, person, etc.)
phones[0].phoneNumber
Phone number itself.
phones[0].description
Phone number description (e.g. department, person, etc.)
phones[0].callHours
Hours during which the phone number is available. (e.g. 11 am to 4 pm PST)
postalAddresses[]
The list of postal addresses. Every address is presented in the format of: street, city, state, zip code, country. Some positions may be missing.
socialLinks.facebook
Facebook URL found on the main website's page.
socialLinks.googlePlus
Google Plus URL found on the main website's page.
socialLinks.instagram
Instagram URL found on the main website's page.
socialLinks.linkedIn
LinkedIn URL found on the main website's page.
socialLinks.twitter
Twitter URL found on the main website's page.

Usage limits and requests throttling

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

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.

List of possible errors

403 Forbidden
Access restricted. Check credits balance or enter the correct API key.
422 Unprocessable Entity
Input correct domain name.
429 Too Many Requests
Too Many Requests. Try your call again later.
5XX
Internal server error. Try your call again or contact us.
Try our Website Contacts 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