Browse the API reference

Stats

Discovery time-series

Bucketed new-host counts for charting.

GEThttps://chaos.thescope.top/api/v1/stats/timeseriesscope: read

Query parameters

bucketstringoptionaldefault hour

Bucket width.

hourdayweekmonth
hoursintegeroptionaldefault 24

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

sincestringoptional

ISO-8601 timestamp; overrides `hours`.

Example response

200 application/json
{ "data": [ { "ts": "2026-08-13T09:00:00Z", "new_subdomains": 143 } ] }

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.

GETTry it

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

https://chaos.thescope.top/api/v1/stats/timeseries?bucket=hour&hours=24
curl "https://chaos.thescope.top/api/v1/stats/timeseries?bucket=hour&hours=24" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx"