API documentation

The REST API allows Enterprise users to programmatically interact with various areas.

Accessing the API requires generating a key via your account security section.

All API responses will be returned in JSON format. Errors will always return a response code in the 400 range. Successful requests will return a 200 code.

Request bodies must be sent using the application/x-www-form-urlencoded encoding. Parameters may also be passed via the query string.

All request data must use the UTF-8 character set.

Requests must pass the API key to use via the Api-Key header. This must be present in all requests.

PHP Example:
$ch = curl_init('https://iolabs.io/api/cookies?' . http_build_query([
        'cookie_domain' => '.google.com',
        'cookie_name' => 'GOOGLE_ABUSE_*'
]));
curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_HTTPHEADER => [
                'Api-Key: <YOUR-API-KEY>'
        ],
]);
$response = curl_exec($ch);

echo $response;

GET https://iolabs.io/api/campaign/{id}/domains
Query for domains that are part of a campaign.

Parameters

Input Type Description
include_finished bool If true, domains that are flagged as being finished with campaign will be included.

Response

Output Type Description
domains Domain[] List of domains in campaign.

POST https://iolabs.io/api/campaign/{id}/domains
Flag domain(s) as being finished with campaign.

Parameters

Input Type Description
domains array Array of domains to be flagged in a campaign.
unflag bool If true, domains will be unflagged.

Response

Output Type Description
success true

GET https://iolabs.io/api/cookies
Query for cookies we have record of.

Parameters

Input Type Description
cookie_domain string The domain the cookie was set at.
cookie_name string Name of the cookie (can have a trailing wildcard [*]).
cookie_value_filter string Cookie value must contain this string if given.

Response

Output Type Description
cookies Cookie[] List of matching cookies.

POST https://iolabs.io/api/domains
Add a domain to the spidering queue.

Parameters

Input Type Description
domain string Domain name to be spidered.

Response

Output Type Description
domain Domain[] Domain added to spidering queue.

GET https://iolabs.io/api/headers
Query for headers we have record of.

Parameters

Input Type Description
header string Header to search for.

Response

Output Type Description
headers Header[] List of matching headers.

GET https://iolabs.io/api/hostnames
Query for hostnames we have record of.

Parameters

Input Type Description
hostname string Hostname to search for.

Response

Output Type Description
hostnames Hostname[] List of matching hostnames.

GET https://iolabs.io/api/javascript
Query for JavaScript objects we have record of.

Parameters

Input Type Description
javascript string JavaScript object to search for.

Response

Output Type Description
javascript JavaScript[] List of matching JavaScript objects.

GET https://iolabs.io/api/spider
Trigger a real-time spider of URL.

Parameters

Input Type Description
url string URL to spider instantly.

Response

Output Type Description
cookies Cookie[] List of cookies received from spidering URL.
headers Header[] List of headers from spidering URL.
hostnames Hostname[] List of hostnames used when spidering URL.
javascript JavaScript[] List of JavaScript objects from spidering URL.
miscellaenous Miscellaneous[] List of miscellaneous items from spidering URL.

Data type: Cookie

Column Type Description
domain string
cookie_domain string
cookie_name string
cookie_value string
date date

Data type: Domain

Column Type Description
domain string

Data type: Header

Column Type Description
domain string
header string
value string
date date

Data type: Hostname

Column Type Description
domain string
hostname string
date date

Data type: JavaScript

Column Type Description
domain string
name string
date date

Data type: Miscellaneous

Column Type Description
key string
value various
Back
Top