BizKitHub
DocsAPI ReferenceVikitron/api/v1/vikitron/subdomain-finder
getVikitronPublic API v1

/api/v1/vikitron/subdomain-finder

Discovers and returns all known subdomains for a given host. If indexing is still in progress, a background crawl is triggered automatically. Results are sorted by HTTP status code.

vikitrongetApiV1VikitronSubdomain-finder

Parameters

1 query

Query parameters

· 1
hoststringRequired

Root hostname to scan for subdomains.

Length: 4–∞
Exampleexample.com

Response schema

1 status code documented

200SuccessSubdomain scan results.
itemCountnumberRequired

Total number of discovered subdomains.

indexablePagesCountnumberRequired

Number of subdomains that are indexable by search engines.

itemsobject[]Required

List of discovered subdomains.

Each array item:
idstringRequired

Subdomain identifier (same as domain).

domainstringRequired

Full subdomain name.

Examplewww.example.com
insertedDateDate | string | string | numberRequired

When the subdomain was first discovered.

One of 4:
Variant 1
Date

When the subdomain was first discovered.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
lastCheckDateDate | string | string | numberOptional

When the subdomain was last checked.

One of 4:
Variant 1
Date

When the subdomain was last checked.

Variant 2
stringdate-time
Variant 3
stringdate
Variant 4
number
httpCodenumberRequired

Last observed HTTP status code.

Examples200301404
httpsSupportbooleanOptional

Whether the subdomain supports HTTPS.

titlestringOptional

Page title or crawl error message.

serverstringOptional

HTTP server software.

ExamplesnginxApache
responseTimenumberOptional

Response time in milliseconds.

uptimeOkbooleanOptional

Whether the subdomain is currently up.

Response example

application/json
{
  "itemCount": 0,
  "indexablePagesCount": 0,
  "items": [
    {
      "id": "example_id",
      "domain": "www.example.com",
      "httpCode": 200,
      "httpsSupport": false,
      "title": "example_title",
      "server": "nginx",
      "responseTime": 0,
      "uptimeOk": false
    }
  ]
}

Request example

GET /api/v1/vikitron/subdomain-finder

get
curl -X GET "https://api.bizkithub.com/api/v1/vikitron/subdomain-finder?host=example.com" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key