Lookup

lookup-phone

GET /lookup/phone/{number}

Lookup phone number

Lookup line type and carrier

Parameters

Name	In	Type	Required	Description
number	path	string	true	URL-encoded phone number in international format (e.g. +441234567890)
x-api-key	header	string	false	API Authentication Key

Example responses

Phone validation results object

{
  "countryCode": "US",
  "phoneNumber": "+1234567890",
  "nationalFormat": "(123) 456-7890",
  "carrier": {
    "name": "Verizon",
    "type": "mobile"
  }
}

An error message

{
  "countryCode": "US",
  "phoneNumber": "+1234567890",
  "nationalFormat": "(123) 456-7890",
  "carrier": {
    "name": "Verizon",
    "type": "mobile"
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Phone validation results object	LookupPhoneResponse
500	Internal Server Error	An error message	LookupPhoneResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/phone/{number}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/phone/{number}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

POST /lookup/social

Lookup social accounts

Lookup social accounts by email and phone number to Check users are not using fake profiles by validating they have online social accounts

Name	In	Type	Required	Description
x-api-key	header	string	false	API Authentication Key
body	body	LookupSocialRequest	false	Transaction details object

Body parameter

{
  "email": "user@example.com",
  "phoneNumber": "string"
}

Example responses

200 Response

{
  "phoneNumber": {
    "accountDetails": {
      "facebook": {
        "registered": true
      },
      "google": {
        "registered": true
      }
    }
  },
  "email": {}
}

Status	Meaning	Description	Schema
200	OK	Phone validation results object	LookupSocialResponse
500	Internal Server Error	An error message	LookupSocialResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.post('https://data.autohost.ai/v1/lookup/social', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';
const inputBody = {
  "email": "user@example.com",
  "phoneNumber": "string"
};
const headers = {
  'Content-Type':'application/json',
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/social', {
  method: 'post',
  body: JSON.stringify(inputBody),
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-breaches

GET /lookup/breaches/{email}

Lookup breaches by email

Discover how many times a user has been compromised

Parameters

Name	In	Type	Required	Description
email	path	string	true	URL encoded email address
x-api-key	header	string	false	API Authentication Key

Example responses

200 Response

[
  {
    "Name": "string",
    "Domain": "string",
    "BreachDate": "string"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	Breaches results object	LookupBreachesResponse
500	Internal Server Error	An error message	LookupBreachesResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/breaches/{email}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/breaches/{email}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-whois

GET /lookup/whois/{domain}

Lookup whois records by domain

Discover who owns a domain

Parameters

Name	In	Type	Required	Description
domain	path	string	true	domain name (e.g. google.com)
x-api-key	header	string	false	API Authentication Key

Example responses

200 Response

[
  {
    "server": "string",
    "data": {
      "domainName": "string",
      "registrar": "string",
      "creationDate": "string",
      "expirationDate": "string"
    }
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	Whois results object	LookupWhoisResponse
500	Internal Server Error	An error message	LookupWhoisResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/whois/{domain}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/whois/{domain}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-domain

GET /lookup/domain/{domain}

Lookup company details by domain

Find company details by domain

Parameters

Name	In	Type	Required	Description
domain	path	string	true	domain name (e.g. oracle.com)
x-api-key	header	string	false	API Authentication Key

Example responses

Lookup results object

[
  {
    "name": "Google",
    "country": "US",
    "industry": "Internet",
    "size": "1000+ employees",
    "linkedin_url": "https://www.linkedin.com/company/google",
    "founded": "1998"
  }
]

An error message

[
  {
    "name": "Google",
    "country": "US",
    "industry": "Internet",
    "size": "1000+ employees",
    "linkedin_url": "https://www.linkedin.com/company/google",
    "founded": "1998"
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	Lookup results object	LookupDomainCompanyResponse
500	Internal Server Error	An error message	LookupDomainCompanyResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/domain/{domain}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/domain/{domain}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-geoip

GET /lookup/geoip/{ip}

Lookup geo-location by IP

Find location details by IP address

Parameters

Name	In	Type	Required	Description
ip	path	string	true	IP Address
x-api-key	header	string	false	API Authentication Key

Example responses

Lookup results object

{
  "country_code": "US",
  "country_name": "United States",
  "city": "Mountain View",
  "postal_code": "94043",
  "time_zone_name": "America/Los_Angeles",
  "latitude": 37.4192,
  "longitude": -122.0574
}

An error message

{
  "country_code": "US",
  "country_name": "United States",
  "city": "Mountain View",
  "postal_code": "94043",
  "time_zone_name": "America/Los_Angeles",
  "latitude": 37.4192,
  "longitude": -122.0574
}

Responses

Status	Meaning	Description	Schema
200	OK	Lookup results object	LookupGeoipResponse
500	Internal Server Error	An error message	LookupGeoipResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/geoip/{ip}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/geoip/{ip}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-sexoffender

GET /lookup/sexoffender

Lookup sex offenders

Search sex offenders in the USA

Parameters

Name	In	Type	Required	Description
fname	query	string	true	First name
lname	query	string	true	Last name
dob	query	string	true	Date of birth (YYYY-MM-DD)
state	query	string	true	State (e.g. CA)
x-api-key	header	string	false	API Authentication Key

Example responses

200 Response

{
  "items": [
    {
      "id": "string",
      "name": "string",
      "fname": "string",
      "lname": "string",
      "city": "string",
      "county": "string",
      "state": "string",
      "zip": "string",
      "dob": "2019-08-24",
      "timestamp": "2019-08-24T14:15:22Z",
      "imageURL": "http://example.com",
      "charge": [
        "string"
      ],
      "aliases": [
        "string"
      ]
    }
  ]
}

Responses

Status	Meaning	Description	Schema
200	OK	Lookup results object	LookupSexOffenderResponse
500	Internal Server Error	An error message	LookupSexOffenderResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

params = {
  'fname': 'string',
  'lname': 'string',
  'dob': 'string',
  'state': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/sexoffender', headers=headers, params=params)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/sexoffender', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-address

GET /lookup/geocode/{address}

Lookup postal address

Lookup or verify billing and shipping addresses

Parameters

Name	In	Type	Required	Description
address	path	string	true	Street or mailing address (URL-encoded)
x-api-key	header	string	false	API Authentication Key

Example responses

Lookup results object

{
  "address": "123 Main St",
  "street": "123 Main St",
  "city": "Mountain View",
  "state": "CA",
  "country": "US",
  "country_code": "US",
  "zipcode": "94043",
  "timezone": "America/Los_Angeles",
  "geo": {
    "lat": 37.4192,
    "lon": -122.0574
  }
}

An error message

{
  "address": "123 Main St",
  "street": "123 Main St",
  "city": "Mountain View",
  "state": "CA",
  "country": "US",
  "country_code": "US",
  "zipcode": "94043",
  "timezone": "America/Los_Angeles",
  "geo": {
    "lat": 37.4192,
    "lon": -122.0574
  }
}

Responses

Status	Meaning	Description	Schema
200	OK	Lookup results object	LookupAddressResponse
500	Internal Server Error	An error message	LookupAddressResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/geocode/{address}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/geocode/{address}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

lookup-ip

GET /lookup/ip-threats/{ip}

Lookup IP Threats

Lookup threat reports associated with an IP address

Parameters

Name	In	Type	Required	Description
ip	path	string	true	IP Address
x-api-key	header	string	false	API Authentication Key

Example responses

Lookup results object

[
  {
    "ip": "5.167.66.39",
    "title": "IP reported on blocklist.de feed",
    "link": "https://lists.blocklist.de/lists/",
    "timestamp": "2016-01-01T00:00:00Z",
    "source": "blocklist",
    "tags": [
      "attack",
      "suspicious"
    ],
    "reasons": [
      "The IP is blacklisted on blocklist.de"
    ]
  }
]

An error message

[
  {
    "ip": "5.167.66.39",
    "title": "IP reported on blocklist.de feed",
    "link": "https://lists.blocklist.de/lists/",
    "timestamp": "2016-01-01T00:00:00Z",
    "source": "blocklist",
    "tags": [
      "attack",
      "suspicious"
    ],
    "reasons": [
      "The IP is blacklisted on blocklist.de"
    ]
  }
]

Responses

Status	Meaning	Description	Schema
200	OK	Lookup results object	LookupIPThreatsResponse
500	Internal Server Error	An error message	LookupIPThreatsResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/ip-threats/{ip}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/ip-threats/{ip}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

adverse-media-search

GET /lookup/adverse-media/search

Adverse Media Search

Initiate an adverse media search for a person or company

Parameters

Name	In	Type	Required	Description
first_name	query	string	true	First name or alias
middle_name	query	string	false	Middle name
last_name	query	string	true	Last name or alias
year_of_birth	query	string	false	Year of birth (YYYY)
country	query	string	true	Country code (e.g. US)
city	query	string	false	City
state	query	string	false	State code (e.g. CA)
x-api-key	header	string	false	API Authentication Key

Example responses

Search status object

{
  "id": "ab48405329f526a3f43f6e9c711466f503395f86a18110641ae246df544e56f1",
  "status": "PENDING",
  "startDate": "2023-01-01T00:00:00.000Z"
}

400 Response

{
  "error": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Search status object	AdverseMediaSearchResponse
400	Bad Request	An error message	ErrorResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

params = {
  'first_name': 'string',
  'last_name': 'string',
  'country': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/adverse-media/search', headers=headers, params=params)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/adverse-media/search', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

adverse-media-report

GET /lookup/adverse-media/results/{id}

Adverse Media Report

View results of an adverse media search for a person or company

Parameters

Name	In	Type	Required	Description
id	path	string	true	Report ID
x-api-key	header	string	false	API Authentication Key

Example responses

Search status object

{
  "id": "ab48405329f526a3f43f6e9c711466f503395f86a18110641ae246df544e56f1",
  "status": "FINISHED",
  "startDate": "2023-01-01T00:00:00.000Z",
  "stopDate": "2023-01-01T00:10:00.000Z",
  "riskCategories": [
    "Discrimination",
    "Fraud or Financial Crime",
    "Harassment",
    "Violence",
    "Conflicts or Litigation",
    "Other News"
  ],
  "findings": [
    {
      "title": "Title of the news article",
      "snippet": "Snippet of the news article",
      "summary": "Summary of the news article",
      "displayLink": "example.com",
      "link": "https://www.example.com/article",
      "image": "https://www.example.com/article/image.jpg",
      "riskCategories": [
        "Discrimination"
      ]
    },
    {
      "title": "Title of the news article",
      "snippet": "Snippet of the news article",
      "summary": "Summary of the news article",
      "displayLink": "example.com",
      "link": "https://www.example.com/article",
      "image": "https://www.example.com/article/image.jpg",
      "riskCategories": [
        "Fraud or Financial Crime",
        "Harassment"
      ]
    }
  ]
}

400 Response

{
  "error": "string"
}

Responses

Status	Meaning	Description	Schema
200	OK	Search status object	AdverseMediaReportResponse
400	Bad Request	An error message	ErrorResponse

Code samples

"""
Python Code Snippet
"""
import requests

headers = {
  'Accept': 'application/json',
  'x-api-key': 'string'
}

r = requests.get('https://data.autohost.ai/v1/lookup/adverse-media/results/{id}', headers=headers)

print(r.json())

/*
TypeScript Code Snippet
*/

import fetch from 'node-fetch';

const headers = {
  'Accept':'application/json',
  'x-api-key':'string'
};

const response = await fetch('https://data.autohost.ai/v1/lookup/adverse-media/results/{id}', {
  method: 'get',
  
  headers,
});
const responseJson = await response.json();
console.log(responseJson);

Autohost

Talk to Sales

lookup-phone​

Parameters

Example responses​

Responses

Code samples​

lookup-social​

Parameters

Body parameter​

Example responses​

Responses

Code samples​

lookup-breaches​

Parameters

Example responses​

Responses

Code samples​

lookup-whois​

Parameters

Example responses​

Responses

Code samples​

lookup-domain​

Parameters

Example responses​

Responses

Code samples​

lookup-geoip​

Parameters

Example responses​

Responses

Code samples​

lookup-sexoffender​

Parameters

Example responses​

Responses

Code samples​

lookup-address​

Parameters

Example responses​

Responses

Code samples​

lookup-ip​

Parameters

Example responses​

Responses

Code samples​

adverse-media-search​

Parameters

Example responses​

Responses

Code samples​

adverse-media-report​

Parameters

Example responses​

Responses

Code samples​

Autohost

lookup-phone

Example responses

Code samples

lookup-social

Body parameter

Example responses

Code samples

lookup-breaches

Example responses

Code samples

lookup-whois

Example responses

Code samples

lookup-domain

Example responses

Code samples

lookup-geoip

Example responses

Code samples

lookup-sexoffender

Example responses

Code samples

lookup-address

Example responses

Code samples

lookup-ip

Example responses

Code samples

adverse-media-search

Example responses

Code samples

adverse-media-report

Example responses

Code samples