Y2 Elite workspaces are rolling out for teams
Y2Y2Docs
Endpoint ReferenceIntel

Look up a domain's DNS footprint

Returns the DNS footprint of a domain from DNSDumpster. The footprint contains A, MX, NS, CNAME, and TXT records. Each address includes its network operator (ASN), netblock, country, reverse DNS, and service banners. Send `domain`. Or send `entityId` to use the official website that Y2 records for that entity. A snapshot younger than 14 days answers every caller with `outcome: reused`. It does not use the workspace allowance. Otherwise Y2 takes a new snapshot with `outcome: fetched`. A new snapshot uses one monthly DNS lookup. Pro includes 5. Elite includes 1,000. `usage` reports the allowance after this request. A failed provider call returns the lookup to the allowance. Y2 stores each snapshot with the time when it arrived. The snapshot adds the domain, hosts, addresses, netblocks, and network operators to the shared ontology. A known organization whose official website is the domain `operates` it. Each relation records when snapshots first and last evidenced it. The free tier returns up to 50 A records for each domain. `truncated` is true when the provider has more. The request can wait up to about 40 seconds while Y2 paces provider calls. Requires a workspace-bound API key with `intel:cyber` on a Pro or Elite plan. Not available through x402.

Loading API reference...