Subdomain Finder

Uncover the subdomains of your target domain with our powerful Subdomain Scanner. This documentation provides you with all the information you need to leverage this invaluable feature.

Enqueue a Subdomain Finder Job

Used to initialize a subdomain finder job

Request

To request the endpoint, you must enter the required credentials, as shown in the following example:

API Key Subdomain Request

API Key Subdomain Request

POSThttps://api.vscanner.ai/v1/api/subdomain

Body

application/json

urlstring

Example: "globo.com"

Response

200

Request

JavaScriptCurlPython

const response = await fetch('https://api.vscanner.ai/v1/api/subdomain', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "url": "globo.com"
    }),
});
const data = await response.json();

Example CURL request

curl --location --request POST 'https://api.vscanner.ai/v1/api/subdomain' \
--header 'Authorization: Bearer <API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "url": "example.com"
}'

*Filling in the API_KEY value is mandatory.

Return

The request response, in Json format, contains the identification of the analysis for monitoring and obtaining the result.

Successful response

{"enqueued_scan_id": "<SUBDOMAIN_SCAN_JOB_ID>"} 

Subdomain Scan Result

Request

Used to retrieve the results of a specific subdomain job

Get Subdomain Job

Get Subdomain Job

GEThttps://api.vscanner.ai/v1/api/subdomain/<ENQUEUED_JOB_ID>

Response

200

Request

JavaScriptCurlPython

const response = await fetch('https://api.vscanner.ai/v1/api/subdomain/<ENQUEUED_JOB_ID>', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Example CURL request

curl --location --request GET 'https://api.vscanner.ai/v1/api/subdomain/<ENQUEUED_JOB_ID>' \
--header 'Authorization: Bearer <API_KEY>'

*Filling in the API_KEY value is mandatory.

Return

The request response, in Json format, contains the state of the subdomain finder job, the results, and the last update date.

Successful response

{
    "start_date": 1690026648,
    "url": <SCANNED_DOMAIN>,
    "total_subdomains": 20,
    "subdomains": [
        "<SUBDOMAIN_1>",
        "<SUBDOMAIN_2>",
        ...
    ],
    "subdomain_job_id": <SUBDOMAIN_FINDER_JOB_ID>
}

List Subdomain Finder Jobs

Request

List all subdomain jobs the user initiated

API Key List Subdomains

API Key List Subdomains

GEThttps://api.vscanner.ai/v1/api/list_subdomain_scans

Response

200

Request

JavaScriptCurlPython

const response = await fetch('https://api.vscanner.ai/v1/api/list_subdomain_scans', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

curl --location --request GET 'https://api.vscanner.ai/v1/api/list_subdomain_scans' \
--header 'Authorization: Bearer <API_KEY>'

*Filling in the API_KEY value is mandatory.

Return

The request response, in Json format, contains the state of the Subdomain Scan, the results, and the last update date.

Successful response

{
    "subdomain_jobs": {
        "<SCANNED_DOMAIN_1>": [
            {
                "start_date": 1690026648,
                "url": <SCANNED_DOMAIN>,
                "total_subdomains": 20,
                "subdomains": [
                    "<SUBDOMAIN_1>",
                    "<SUBDOMAIN_2>",
                    ...
                ],
            }
        ],
        "<SCANNED_DOMAIN_2>": [
                "start_date": 1690026648,
                "url": <SCANNED_DOMAIN>,
                "total_subdomains": 20,
                "subdomains": [
                "<SUBDOMAIN_1>",
                "<SUBDOMAIN_2>",
                ...
            ],
        ]
    }
}