Chaos.beta
Browse the API reference

Export

Bulk export

Streaming export of hosts for any scope. Handles 100k+ rows; returns text, CSV or JSON rather than the standard envelope.

GEThttps://chaos.thescope.top/api/v1/exportscope: read

Query parameters

domainstringoptional

Export one root domain.

platformstringoptional

Export a whole platform.

scopestringoptionaldefault all

Which hosts to include.

allnewinactive
hoursintegeroptionaldefault 24

Look-back window in hours. Ignored when `since` is supplied.

searchstringoptional

Substring match on the host.

formatstringoptionaldefault txt

Output format.

txtcsvjson

Example response

200 application/json
www.lovable.app
connect.lovable.app
yt.lovable.app

Errors

400invalid_bodyA POST body was missing or was not valid JSON.
400invalid_domainThe supplied domain is not a valid root domain.
400invalid_queryA required query parameter was missing or too short.
400invalid_idA path id was not a UUID.
401missing_tokenNo Authorization or X-API-Key header was sent.
401invalid_tokenThe token is malformed or unknown.
401revoked_tokenThe token was revoked by its owner.
404not_foundThe domain, platform, scan or endpoint does not exist.
405method_not_allowedThe HTTP verb is not supported on that path.
500query_failedA database query failed while serving the request.
500server_errorAn unexpected error occurred.

Full catalogue with fixes on the errors page.

Previous

Top domains by new hosts

GETTry it

Kept in this browser tab only and sent straight to this API.

https://chaos.thescope.top/api/v1/export?scope=all&hours=24&format=txt
curl "https://chaos.thescope.top/api/v1/export?scope=all&hours=24&format=txt" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx"