Browse the API reference
Subdomains
New hosts across everything
Every newly discovered host across all programs, newest first. Page with `meta.next_cursor`.
GET
https://chaos.thescope.top/api/v1/subdomains/newscope: readQuery parameters
hoursintegeroptionaldefault 24Look-back window in hours. Ignored when `since` is supplied.
sincestringoptionalISO-8601 timestamp; overrides `hours`.
limitintegeroptionaldefault 500Rows to return (max 2000).
before_tsstringoptionalCursor: `first_seen_at` of the last row from the previous page.
before_idstringoptionalCursor: `id` of the last row from the previous page.
Example response
200 application/json
{ "data": [ { "host": "a.example.com", "domain": "example.com", "first_seen_at": "…" } ], "meta": { "next_cursor": { "before_ts": "…", "before_id": "…" } } }Errors
400
invalid_bodyA POST body was missing or was not valid JSON.400
invalid_domainThe supplied domain is not a valid root domain.400
invalid_queryA required query parameter was missing or too short.400
invalid_idA path id was not a UUID.401
missing_tokenNo Authorization or X-API-Key header was sent.401
invalid_tokenThe token is malformed or unknown.401
revoked_tokenThe token was revoked by its owner.404
not_foundThe domain, platform, scan or endpoint does not exist.405
method_not_allowedThe HTTP verb is not supported on that path.500
query_failedA database query failed while serving the request.500
server_errorAn unexpected error occurred.Full catalogue with fixes on the errors page.
GETTry it
Kept in this browser tab only and sent straight to this API.
https://chaos.thescope.top/api/v1/subdomains/new?hours=24&limit=500
curl "https://chaos.thescope.top/api/v1/subdomains/new?hours=24&limit=500" \ -H "Authorization: Bearer chs_live_xxxxxxxxxxxx"