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* (for simple search)	The search query (part or whole domain name, IP address, tags, etc.).
domain	String	No* (for advanced search)	Search by domain name. Supports partial matching.
detect	String	No* (for advanced search)	Search by detection category (e.g., "Scam Website", "Phishing").
tags	String	No* (for advanced search)	Search by tags (e.g., "Cryptocurrency", "Shopping").
fingerprint	String	No* (for advanced search)	Search by fingerprint hash or pattern.
hosts	String	No* (for advanced search)	Search by 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).

* Either 'q' for simple search OR at least one advanced search parameter (domain, detect, category, tags, fingerprint, hosts) must be provided.

Examples:

Simple Search:

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"

Advanced Search:

curl -X GET "https://inspector.gridinsoft.com/api/v1/domain/search?apikey=YOUR_PRIVATE_APIKEY&detect=Scam%20Website&domain=.xyz&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:

Simple Search Response:

{
    "search_type": "simple",
    "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
}

Advanced Search Response:

{
    "search_type": "advanced",
    "params": {
        "detect": "Malware"
    },
    "results": [
        {
            "domain": "suspicious-site.com",
            "checked_at": "2024-07-11 00:35:03",
            "verdict": "Suspicious",
            "report": "https://gridinsoft.com/online-virus-scanner/url/suspicious-site-com",
            "hosting": {
                "ip": "192.168.1.100",
                "city": "Unknown",
                "region": "Unknown",
                "country": "Unknown",
                "org": "Unknown"
            },
            "whois": {
                "registrar": "Unknown",
                "creationDate": null,
                "expirationDate": null
            },
            "site": {
                "title": "Suspicious Site",
                "description": "This site has been flagged for malware distribution.",
                "tags": ["Malware", "Suspicious"]
            }
        }
    ],
    "p": 1,
    "limit": 10,
    "total": 25
}

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

Search by specific parameters for more targeted results.

Ready to get started?

Billed monthly

Billed annually

Basic

$49

$ _{per month}

Designed for small to medium enterprises requiring regular API access with standard support.

1500 API credits per month
Max 20 results per request
Access to domain, URL, and file check APIs
Email support
Standard response times within 24 hours

Standard

$149

$ _{per month}

Suited for businesses needing high-volume access and additional API capabilities, along with priority support.

5000 API credits per month
Max 30 results per request
Extended access to all primary APIs including domain, URL, and file checks
Email and ticket support
Access to beta features and early releases
Priority response time

Premium

$599

$ _{per month}

For large organizations requiring full-scale API integration with the highest level of support and customization.

20000 API credits per month
Max 50 results per request
Full access to all API capabilities, including exclusive premium features
Dedicated account manager and 24/7 premium support
Custom configuration and onboarding assistance
Access to in-depth analytics and usage reports

Need more?

If you would like to discuss custom arrangements, please do not hesitate to contact us. We are always ready to help you find the perfect solution that meets your needs.