Domain Search API

This API allows you to perform searches for domains that have been previously checked and analyzed. You can retrieve comprehensive information on whois, associated metadata, and current status.

How to Use?

GET https://inspector.gridinsoft.com/api/v1/domain/search

Request:

Use the following parameters to customize your search:

Field	Type	Required	Description
apikey	String	Yes	Your unique API key that authenticates requests to our services.
q	String	Yes	The search query (part or whole domain name, IP address).
p	Integer	No	The page number of the results (used for pagination).
limit	Integer	No	The number of results to return per page (defaults to 10).

Example:

curl -X GET "https://inspector.gridinsoft.com/api/v1/domain/search?apikey=YOUR_PRIVATE_APIKEY&q=example&p=1&limit=10" \
     -H "Accept: application/json"

Response:

The response will include a list of domains that match the search criteria along with pagination details:

{
    "q": "example",
    "results": [
        {
            "domain": "example.com",
            "checked_at": "2024-07-11 00:35:03",
            "verdict": "Safe",
            "report": "https://gridinsoft.com/online-virus-scanner/url/example-com",
            "hosting": {
                "ip": "159.223.3.206",
                "city": "Amsterdam",
                "region": "North Holland",
                "country": "NL",
                "org": "DigitalOcean, LLC"
            },
            "whois": {
                "registrar": "Moniker Online Services LLC",
                "creationDate": "1999-03-03",
                "expirationDate": "2024-03-03"
            },
            "site": {
                "title": "Example Domain",
                "description": "This domain is established to be used for illustrative examples in documents.",
                "tags": []
            }
        }
    ],
    "p": 1,
    "limit": 10,
    "total": 150
    }

Each result will provide detailed information about the domain, including hosting details, WHOIS data, and site metadata.

Ready to get started?