Error Codes
All error responses follow this format:
{
"detail": "Error message"
}HTTP Status Codes
| Status | Meaning | Common Cause |
|---|---|---|
| 400 | Bad Request | Missing or invalid parameters |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | Insufficient scope or blocked |
| 404 | Not Found | Resource doesn’t exist |
| 429 | Too Many Requests | Rate limit or quota exceeded |
| 500 | Internal Error | Server-side failure |
Platform-Specific Errors
Threads
| Error | Cause |
|---|---|
execution error | Post doesn’t exist or was deleted |
Not found | Invalid post ID or shortcode |
User not found | Username doesn’t exist or hasn’t enabled Threads |
| Error | Cause |
|---|---|
Invalid URL | URL format not recognized |
Page not found | Facebook page doesn’t exist |
X / Twitter
| Error | Cause |
|---|---|
User suspended | Account has been suspended |
Protected tweets | User’s tweets are private |
| Error | Cause |
|---|---|
Subreddit not found | Subreddit doesn’t exist or is private |
User not found | Reddit username doesn’t exist |
Rate Limit Errors
When you receive a 429 response, check:
- Your monthly quota on the Billing page
- Per-minute rate limits (if applicable)
The response may include a Retry-After header indicating when you can retry.
Credit verification unavailable
HTTP 503 with Credit verification unavailable. means the database could not confirm the debit. No provider job is started for that request. A lost database response can still leave a committed debit; the gateway does not blindly replay the non-idempotent RPC. Check account usage before retrying an uncertain charge.
When a failed provider request cannot confirm its refund, X-Credit-Refund-Status: unconfirmed is returned and X-Credit-Cost is reduced only by confirmed refunds. Do not treat an unconfirmed refund as a completed credit return.
Last updated on