> For the complete documentation index, see [llms.txt](https://docs.webz.io/llms.txt). Any docs page is also available as markdown at `https://docs.webz.io/markdown/<environment>/<slug>`.

# Introduction

The Dark Web Answers API turns a plain-language threat-intelligence question into a direct answer backed by citations from Webz.io dark web content - Tor sites, hacking forums, marketplaces, and chat platforms.

## What you get

- **An answer** written from the most relevant posts, with `[S1]`, `[S2]`... markers that point to its sources.
- **Sources** - the cited posts with title, site, network, language, dates, a risk score, and how strongly each one supports the answer.
- **Warnings** - for example when the evidence is thin.

Ask questions like:

- Which ransomware groups are targeting healthcare organizations, and what tactics are they using?
- Which vulnerabilities are threat actors discussing exploiting in the wild?
- What types of corporate access are initial access brokers advertising on dark web forums?

## How it works

1. Send a `POST` request with your question - see [Request & Response](https://docs.webz.io/docs/webz/dark-web-answers-api-reference).
2. The API runs the searches itself: time window, sources, and language are read from the question. No filters needed.
3. Read `answer.text` and check the cited `sources` before acting on it.

An answer takes time - usually well under two minutes - because several search rounds run before it is written.

> [!NOTE]
> Answers are AI-generated and can make mistakes. Always check the references.

## Masking

Answers and sources are **masked by default**: personal data and other sensitive details are redacted, and source URLs are not returned. Accounts with the unmasked-answers permission can request the full version - see [Request & Response](https://docs.webz.io/docs/webz/dark-web-answers-api-reference).

## Access and pricing

The Dark Web Answers API is available on:

- **Pay-as-you-go accounts** - billed from your dollar balance per answer. It does not require the Dark Web API permission.
- **Contract plans** - billed in Dark Web Answers credits; the Dark Web API permission is required.

See [Errors, Limits & Credits](https://docs.webz.io/docs/webz/dark-web-answers-api-errors-limits) for the exact prices.

