Domain Intelligence and Analysis API

Subdomains Lookup

discovers subdomains observed for a domain, each with first_seen and last_seen dates so you can tell live infrastructure from historical …

Subdomains Lookup
POST

Subdomains Lookup API — discovers subdomains observed for a domain, each with first_seen and last_seen dates so you can tell live infrastructure from historical records. Results are paginated: read total_pages and total_records from the first response, then pass page to walk the rest. Pass status to return only active or only inactive hosts. Built for attack-surface mapping, asset inventory and shadow-IT discovery. Each page is one billable call.

  • Global coverage
  • Real-time domain intelligence and analysis lookup
  • Structured JSON response
  • POST request with Bearer auth
Get API Key — Free View Full Docs
Endpoint
POST
https://app.way2api.com/api/v1/domain/subdomains

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

Request Parameters
Parameter Type Required Description
domain_name string Yes Root domain to enumerate, e.g. example.com. A scheme, path or www. prefix is stripped automatically.
page integer No Page number for paginated results (positive integer). Defaults to 1.
status string No Filter results by host status: "active" or "inactive". Defaults to all.
Request Example
<?php $ch = curl_init(); curl_setopt_array($ch, [ CURLOPT_URL => "https://app.way2api.com/api/v1/domain/subdomains", CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => [ "Authorization: Bearer YOUR_API_KEY", "Content-Type: application/json" ], CURLOPT_POSTFIELDS => json_encode([ "domain_name" => "way2api.com" ]) ]); $response = curl_exec($ch); $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); $data = json_decode($response, true); print_r($data);
const response = await fetch("https://app.way2api.com/api/v1/domain/subdomains", { method: "POST", headers: { "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, body: JSON.stringify({ "domain_name": "way2api.com" }) }); if (!response.ok) { throw new Error(`HTTP error: ${response.status}`); } const data = await response.json(); console.log(data);
curl -X POST https://app.way2api.com/api/v1/domain/subdomains \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{\"domain_name\":\"way2api.com\"}'
$.ajax({ url: "https://app.way2api.com/api/v1/domain/subdomains", type: "POST", contentType: "application/json", headers: { "Authorization": "Bearer YOUR_API_KEY" }, data: JSON.stringify({ "domain_name": "way2api.com" }), success: function(data) { console.log(data); }, error: function(xhr) { console.error(xhr.responseJSON); } });
const { data } = await axios.post( "https://app.way2api.com/api/v1/domain/subdomains", {"domain_name":"way2api.com"}, { headers: { "Authorization": "Bearer YOUR_API_KEY" } } ); console.log(data);
import requests response = requests.post( "https://app.way2api.com/api/v1/domain/subdomains", headers={ "Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json" }, json={ "domain_name": "way2api.com" } ) print(response.status_code) print(response.json())
Response Example
200 OK Success Response 
{
    "success": true,
    "message": "",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "result": {
            "domain_name": "way2api.com",
            "total_records": 3,
            "current_page": 1,
            "total_pages": 1,
            "subdomains": [
                {
                    "name": "app.way2api.com",
                    "first_seen": "2026-04-30",
                    "last_seen": "2026-05-03"
                },
                {
                    "name": "www.way2api.com",
                    "first_seen": "2020-09-21",
                    "last_seen": "2026-04-09"
                },
                {
                    "name": "stage-y4du5xz.way2api.com",
                    "first_seen": "2026-04-30",
                    "last_seen": "2026-06-30"
                }
            ],
            "queried_at": "2026-08-04T13:32:44.526753615"
        }
    }
}
4xx Error Response 
{
    "success": false,
    "message": "please pass correct parameters",
    "data": {
        "order_id": "W2A1739512345abcdef01",
        "error_code": "Invalid Param Exception"
    }
}
Common Response Codes
Code Meaning
200 OK — Request successful
400 Bad Request — Missing or invalid parameters
401 Unauthorized — Invalid or missing API key
429 Too Many Requests — Rate limit exceeded
500 Server Error — Try again later
Ready to integrate?

Start with free trial API calls. No credit card required.

Get API Key — Free Browse All APIs
Way2API Way2API
Contact Way2API

Login