Text Analysis API Error Codes & Troubleshooting Guide
Common HTTP status codes and error responses returned by the Text Analyze API with reasons and fixes.
Try Text Analysis Demo →Authentication Errors
401 - AUTH_ERROR
Authentication failed
Reason: Invalid API key, signature mismatch, expired timestamp, or nonce reuse
Fix: Regenerate signature with correct payload and ensure fresh timestamp + unique nonce
Authentication failed
Reason: Invalid API key, signature mismatch, expired timestamp, or nonce reuse
Fix: Regenerate signature with correct payload and ensure fresh timestamp + unique nonce
Validation Errors
400 - INVALID_INPUT
Invalid request body
Cases:
• Missing required fields (projectId, apiKey, nonce, timestamp)
• Missing text (single) or texts (batch)
• Empty text or invalid format
• More than 10 texts in batch
• Total text length exceeds 500 characters
Fix: Validate payload before sending and respect limits
Invalid request body
Cases:
• Missing required fields (projectId, apiKey, nonce, timestamp)
• Missing text (single) or texts (batch)
• Empty text or invalid format
• More than 10 texts in batch
• Total text length exceeds 500 characters
Fix: Validate payload before sending and respect limits
Rate Limiting
429 - RATE_LIMIT_EXCEEDED
Too many requests
Reason: Requests per minute (RPM) exceeded
Fix: Retry later or upgrade plan
Too many requests
Reason: Requests per minute (RPM) exceeded
Fix: Retry later or upgrade plan
Server Errors
503 - SERVICE_UNAVAILABLE
Service under maintenance
Fix: Retry after some time
Service under maintenance
Fix: Retry after some time
500 - SERVER_ERROR
Unexpected failure during processing
Fix: Retry or contact support if persistent
Unexpected failure during processing
Fix: Retry or contact support if persistent
Ensure payload size ≤500 chars, max 10 texts, and correct signature generation to avoid most errors.