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.
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 from the gateway are plain text; errors from the answer service are { "detail": "message" }.
| HTTP status | X-RateLimit-Reason | When it happens |
|---|---|---|
400 | The JSON body is missing or has no query. | |
401 | Unknown token, an additional (secondary) token, or - on contract plans - no Dark Web API permission. | |
402 | insufficient_balance | Pay as you go: your balance is below the price of one answer. |
429 | rate_limit | Too many requests. |
429 | quota_exceeded | Contract plans: no Dark Web Answers credits left this month. |
429 | inactive_user | Your account email is not verified yet. |
502 | The answer service is temporarily unavailable - retry. |
| Plan | Price per answer | Failed request |
|---|---|---|
| Contract | 1 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 |
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].