Quickstart

Create a token, call your first endpoint and set up an hourly delta feed.

Create an API token

Sign in, open the account page and create a key. Read-only keys can query everything; add the write scope only if you need to queue scans.

Call the API

Send the token as a bearer header. Every response is JSON.

curl "https://chaos.thescope.top/api/v1/domains?limit=5" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx"

Pull the newest hosts

The discovery feed returns everything first seen inside the window you ask for.

curl "https://chaos.thescope.top/api/v1/subdomains/new?hours=24&limit=100" \
  -H "Authorization: Bearer chs_live_xxxxxxxxxxxx" | jq -r '.data[].host'

Automate it

Run the delta call on a schedule and append the results. See recipes for cursor pagination and bulk exports.

5 * * * * /usr/local/bin/chaos-delta.sh >> /var/log/chaos.log 2>&1

Overview

Authentication

Need a token?

Tokens are created on your account page and shown once. Only a hash is stored, so save it immediately.