Webz.io logoDocs
Overview
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Firehose
Cyber 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
Errors, Rate Limits & Credits
FAQ
Data Breaches API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)
Webz.io logo
Overview
Start Here
News, Blogs, Forums & Reviews APIs
News Search API
Firehose
Cyber 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
Errors, Rate Limits & Credits
FAQ
Data Breaches API
News, Blogs, Forums & Reviews Archive
Web Content API (Deprecated)

On this page

No sections

Webz.io DocumentationContact our team© 2026

Errors, Rate Limits & Credits

Requests are metered two ways - how fast you call, and how many Cyber credits you spend. Both are visible in your responses.

Request rate

Requests are rate-limited per token, about 1 request per second. Sending faster returns 429 with rate limit exceeded.

Credits

The Cyber API has its own monthly credit quota, separate from other Webz.io products:

  • Every search, segmentation, cached-page, and image request costs 1 credit.
  • requestsLeft in every response shows your remaining balance (also in the X-WebHose-Requests-Left header).
  • When the quota is exhausted, requests return 429 with Too many requests: used X out of Y allowed in a month.

Error responses

StatusWhen
400Invalid query (Failed to execute query: invalid query), or an unknown sort, order, or segmentation field value
401Missing or unknown token, or your account lacks Cyber API permission (/cyberSeg returns 429 in this case)
429Rate limit exceeded or monthly quota used up
500Internal error, including unbalanced quotes or parentheses in q

Need access, more credits, or additional networks? Contact [email protected].

Last updated: July 28, 2026
PreviousDark Cache & ImagesNextFAQ