Webz.io logoDocs
MCPs
Overview
Webz.io MCPs
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
News Answers API
Firehose
Dark Web API
Introduction
Quickstart
Filters
Post Data Fields
SOCMint API
API Reference
Query Syntax
Time Range
Endpoints & Authentication
Request Parameters
Response Format
Pagination
Segmentation API
Dark Cache & Images
Discover (Pay as you go)
Errors, Rate Limits & Credits
FAQ
Dark Web Answers API
Data Breaches API
MFA Bypass Monitoring API
Non-Human Identities (NHI) API
Domain Exposure API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io logo
MCPs
Overview
Webz.io MCPs
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
News Answers API
Firehose
Dark Web API
Introduction
Quickstart
Filters
Post Data Fields
SOCMint API
API Reference
Query Syntax
Time Range
Endpoints & Authentication
Request Parameters
Response Format
Pagination
Segmentation API
Dark Cache & Images
Discover (Pay as you go)
Errors, Rate Limits & Credits
FAQ
Dark Web Answers API
Data Breaches API
MFA Bypass Monitoring API
Non-Human Identities (NHI) API
Domain Exposure API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io DocumentationContact our team© 2026

Discover (Pay as you go)

Discover is a ready-made feed of dark web posts that mention your organization's domains. There is no query to write: you verify your domains once, and every call returns the newest posts about them.

Discover is available to pay-as-you-go accounts on the main API token only. Contract plans use the search endpoint instead. Any other token returns 401.

Endpoint

GET

https://api.webz.io/darkwebDiscover?token=YOUR_TOKEN

POST with the same parameters is also accepted. Authenticate with token or an Authorization: Bearer YOUR_TOKEN header.

Before you start: verify your domains

Discover only searches domains you have verified in the playground Assets page (app.webz.io/playground/assets), by adding a DNS TXT record or, for your primary domain, by email approval. A request that names an unverified domain returns 403 with X-RateLimit-Reason: unverified_asset; an account with no verified domain gets the same 403.

Parameters

ParameterRequiredDefaultDescription
tokenYes—Your main API token (or the Authorization header).
domainNoall verified domainsWhich verified domains to search. Repeat the parameter or separate values with commas, up to 20. Each must equal a verified domain or sit under one (sub.example.com under example.com).
sizeNo5Posts per page, 1-100.
fromNo0Offset for paging. Use the next URL instead of computing it.
tsNo3 months agoReturn posts crawled at or after this time, epoch milliseconds UTC - as on /cyberFilter. Capped at 2 years back.

Posts are sorted by publication date, newest first. Any other value for size or from returns 400.

curl "https://api.webz.io/darkwebDiscover?token=YOUR_TOKEN&domain=example.com&ts=1759276800000"

Response

json
{
  "posts": [ ... ],
  "totalResults": 42,
  "moreResultsAvailable": 37,
  "next": "/darkwebDiscover?token=YOUR_TOKEN&domain=example.com&size=5&from=5&ts=1759276800000",
  "cost": 0.75,
  "balance": 4.25
}
FieldTypeDescription
postsarrayDark Web API posts - the same fields as Post Data Fields, with links hidden (see below).
totalResultsintegerPosts matching your domains in the time window.
moreResultsAvailableintegerPosts still available after this page.
nextstringRelative URL of the next page, or null when there is none. Append it to https://api.webz.io. It carries the same domains and time window, so every page of one feed covers the same span.
costnumberWhat this page cost, in USD.
balancenumberYour balance after the charge, in USD.

Hidden links

Discover shows that your domain is being discussed, not where. Link fields (url, thread.url, author_extended.user_link, main_image, external_links, cache_link, and similar) are null, and any web or .onion address inside text fields is replaced with [hidden]. The search endpoint on a contract plan returns the full posts - contact [email protected].

Pricing

Every page is a billed call:

Price
Per request$0.25
Per post returned$0.10

A page of 5 posts costs $0.75; an empty page costs $0.25. Before the search, your balance must cover a full page at the requested size ($0.25 + $0.10 × size); after it, only the posts actually returned are charged.

Errors

Errors are plain text.

StatusX-RateLimit-ReasonWhen
400size outside 1-100, negative from, an invalid domain, or more than 20 domains.
401Unknown token, an additional token, or an account that is not pay as you go.
402insufficient_balanceBalance below the price of a full page. Top up at app.webz.io/playground/settings/credits.
403unverified_assetA requested domain is not verified, or you have no verified domain.
429rate_limitMore than about 1 request per second.
429inactive_userYour account email is not verified yet.
500Internal error - retry.

Related documentation

  • Dark Web Answers API - ask questions about what Discover surfaces.
  • Post Data Fields
  • Errors, Rate Limits & Credits
Last updated: November 22, 2026
PreviousDark Cache & ImagesNextErrors, Rate Limits & Credits