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.