Quickstart

Four steps from zero to your first records. You need an API token with Leaked Cookies API permission.

1. Get your token

Find your API token in your Webz.io dashboard. Your account must have Leaked Cookies API access - without it, requests return 401.

2. Run a query

GET

https://api.webz.io/cookies?token=YOUR_TOKEN&domain=example.com

Every request needs a token and a domain. Send the bare domain (example.com) - schemes, paths, and ports are ignored.

3. Read the response

The JSON response contains a records array plus paging and status fields:

{
  "records": [ ... ],
  "totalResults": 105,
  "moreResultsAvailable": 5,
  "next": "/cookies?token=YOUR_TOKEN&domain=example.com&next=CURSOR",
  "requestsLeft": 989,
  "domainStatus": "active"
}

If this is the first time anyone queried the domain, domainStatus is pending and records may be empty - come back in a few minutes.

4. Get the next page

Append the next value to https://api.webz.io and call it again. Repeat until moreResultsAvailable reaches 0. See Pagination.

That's it - you are up and running. Next, learn the Filters and Record Data Fields.