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
Dark Web Answers API
Introduction
Request & Response
Errors, Limits & Credits
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
Dark Web Answers API
Introduction
Request & Response
Errors, Limits & Credits
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

Request & Response

Endpoint

POST

https://api.webz.io/api/cyber/answers

Authentication

Use your main Webz API token in one of these ways:

  • Recommended: send Authorization: Bearer YOUR_API_KEY.
  • Alternative: add ?token=YOUR_API_KEY to the endpoint URL.

Additional (secondary) tokens are not accepted and return 401. Pay-as-you-go accounts need enough balance for one answer; contract plans need the Dark Web API permission and a Dark Web Answers credit left - see Errors, Limits & Credits.

Request body

Send a JSON body with Content-Type: application/json.

ParameterTypeRequiredDefaultDescription
querystringYes—Your question in plain language.
lookback_daysintegerNoautoHow far back to search, 1-730. When omitted the search starts at 90 days and widens if too little is found.

The API infers the searches, sources, time window, and language from query. You do not send Dark Web API filters.

curl -X POST "https://api.webz.io/api/cyber/answers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Which ransomware groups are targeting healthcare organizations, and what tactics are they using?", "lookback_days": 90}'

Unmasked answers

Answers are masked by default. To request the unmasked version, add ?mask=false to the URL:

https://api.webz.io/api/cyber/answers?mask=false

mask=false is honored only for accounts with the unmasked-answers permission. Any other account still receives a masked answer, plus an unmask_denied field explaining why. Contact [email protected] to enable unmasked answers.

Response

json
{
  "query": "Which ransomware groups are targeting healthcare organizations, and what tactics are they using?",
  "answer": {
    "text": "Several groups have claimed healthcare victims in the period, most actively ... [S1][S3]. Their posts describe initial access through exposed RDP and phishing ... [S2].",
    "insufficient_evidence": false
  },
  "sources": [
    {
      "id": "S1",
      "uuid": "e2a9c1f0b4d6...",
      "title": "New victim announced",
      "site": "ransomware-blog",
      "site_type": "blogs",
      "network": "tor",
      "language": "english",
      "published": "2026-10-02T14:21:00.000+00:00",
      "crawled": "2026-10-02T14:40:12.000+00:00",
      "authors": [
        "admin"
      ],
      "risk": 8,
      "relevance": 3,
      "evidence_note": "Names the victim organization and the sector.",
      "supporting_text": "..."
    }
  ],
  "warnings": [],
  "cost": 0.63,
  "balance": 4.37
}

Root fields

FieldTypeDescription
querystringThe question as received.
answer.textstringThe answer. [Sn] markers cite the matching entry in sources.
answer.insufficient_evidencebooleantrue when the sources found do not support a confident answer.
sourcesarrayThe cited posts - see below.
warningsarray of stringsNotes about the run, for example a widened time window.
unmask_deniedstringPresent only when mask=false was requested without the permission.
credits_usedintegerContract plans: Dark Web Answers credits charged for this request.
requests_leftintegerContract plans: Dark Web Answers credits left this month.
costnumberPay as you go: amount charged for this request, in USD.
balancenumberPay as you go: your balance after the charge, in USD.

Each account receives only its own billing fields: credits_used and requests_left on contract plans, cost and balance on pay as you go.

Source fields

FieldTypeDescription
idstringS1, S2... - matches the markers in answer.text.
uuidstringPost id in the Dark Web API.
parent_uuidstringId of the thread's first post, when the source is a reply.
titlestringPost or thread title.
sitestringSite name.
site_typestringSite type, as in the Dark Web API site.type field.
networkstringtelegram, openweb, tor, public_chat, or discord.
languagestringPost language.
published, crawledstringISO 8601 timestamps.
authorsarray of stringsAuthor names.
riskintegerCyber risk score, 1-10.
relevanceinteger3 directly supports the answer, 2 partly.
evidence_notestringWhy this post was cited.
supporting_textstringThe passage the answer relies on.
url, thread_url, site_domainstringUnmasked answers only. Where the post was found.

Timeouts

An answer can take up to two minutes. Set your client timeout to at least three minutes; the request is not streamed.

Related documentation

  • Introduction
  • Errors, Limits & Credits
  • Dark Web API - the posts the answers are built from.
Last updated: November 22, 2026
PreviousIntroductionNextErrors, Limits & Credits