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

Errors, Limits & Credits

Contract plans are charged only after an answer is produced successfully. Pay-as-you-go accounts pay per answer, with a small charge for a request that was accepted but failed.

Rate limits

Requests are rate-limited per token, about 1 request per second. Sending faster returns 429 with the X-RateLimit-Reason: rate_limit header. Contact [email protected] if you need a higher limit.

Errors

Errors from the gateway are plain text; errors from the answer service are { "detail": "message" }.

HTTP statusX-RateLimit-ReasonWhen it happens
400The JSON body is missing or has no query.
401Unknown token, an additional (secondary) token, or - on contract plans - no Dark Web API permission.
402insufficient_balancePay as you go: your balance is below the price of one answer.
429rate_limitToo many requests.
429quota_exceededContract plans: no Dark Web Answers credits left this month.
429inactive_userYour account email is not verified yet.
502The answer service is temporarily unavailable - retry.

Credits and PAYG pricing

PlanPrice per answerFailed request
Contract1 Dark Web Answers credit (separate from Dark Web API credits)Free
Pay as you go$0.30 per search round + $0.03 per Dark Web query, between $0.30 and $1.00$0.10 when the request was accepted and the service failed
  • Pay as you go: you need at least $1.00 of balance before the call; the actual price is charged after the answer. Simple questions cost less than complex ones that need several rounds.
  • Contract: one credit is needed before the call and charged only on a 200.

Contract responses include credits_used and requests_left. Pay-as-you-go responses include cost and the remaining balance.

Answers are masked by default - see Introduction. Need unmasked answers or a higher limit? Contact [email protected].

Last updated: November 22, 2026
PreviousRequest & ResponseNextData Breaches API