- Kaspersky Threat Intelligence Portal
- What's new
- Data provision
- Licensing
- Interface of Kaspersky Threat Intelligence Portal
- File analysis
- Lookup requests
- Web address analysis
- Viewing public request results
- Private requests
- Submitting objects for re-validation
- Signing in
- Requesting Demo TAXII Server Token
- Working with the API
- Sending feedback
- Requesting a demo
- Information about third-party code
- Trademark notices
Looking up a web address
Kaspersky Threat Intelligence Portal provides an API for looking up a web address.
Request
Request method: GET
Endpoint: https://opentip.kaspersky.com/api/v1/search/url
Query parameter: request—Web address that you want to investigate.
cURL command sample:
Here:
|
Responses
Request processed successfully.
Endpoint returns a JSON object that contains lookup results for the specified domain.
200 OK response parameters
Parameter |
Type |
Description |
|---|---|---|
|
string |
Color of the zone that a web address belongs to. Available values:
|
|
object |
General information about the requested web address. |
|
string |
Requested web address. |
|
string |
Name of the upper-level domain of the requested web address. |
|
integer |
Number of IP addresses (IPv4) for the requested web address. |
|
integer |
Number of known malicious files. |
|
Array of strings |
Categories of the requested web address. If the web address does not belong to any defined categories, the |
|
Array of objects |
Categories of the requested web address and zones that the category belongs to:
|
|
object |
WHOIS information about the requested web address. |
|
string |
Name of the domain of the requested web address. |
|
string <date-time> |
Date when the requested web address was registered. |
|
string <date-time> |
Date when registration information about the domain for the requested web address was last updated. |
|
string <date-time> |
Expiration date of the prepaid domain registration term. |
|
Array of strings |
List of name servers of the domain for the requested web address. |
|
Array of strings |
Contact information for the owner of the requested web address. |
|
object |
Information about the domain's registrar:
|
|
Array of strings |
Statuses of the domain for the requested web address. |
|
string |
Name of the registration organization. |
Request not processed: incorrect query.
Make sure you enter the correct parameter, and then try to run the query again.
Request not processed: user authentication failed.
Make sure you enter the correct credentials, and then try to run the query again.
Request not processed: quota or request limit exceeded.
Check your quota and limitations, and try to run the query again later.
Request not processed: requested object lookup results not found.
Make sure the specified object is correct, and then run the query again.
Request not processed: Web address length exceeds 2000 characters.
For a web address, its length is limited to a maximum of 2000 characters. Web addresses with a length exceeding 2000 characters cannot be requested by using the RESTful API.
Specify another web address, and then run the query.