No API key provided or the API key is invalid.
{ "error": { "code": "UNAUTHORIZED", "message": "Missing or invalid API key" } }Include a valid API key in the X-API-Key header. You can create keys at /dashboard/keys.
Your API key is valid but you don't have permission for this action.
{ "error": { "code": "FORBIDDEN", "message": "Feature not available on your plan" } }Upgrade your plan to access this feature. Check /dashboard/billing for available plans.
You need an active subscription to use scrape endpoints.
{ "error": { "code": "SUBSCRIPTION_REQUIRED", "message": "Active subscription required" } }Subscribe to a plan at /dashboard/billing to start scraping.
The request body is missing required fields or has invalid values.
{ "error": { "code": "BAD_REQUEST", "message": "Target is required" } }Check the API docs for required fields. Ensure all parameters have valid formats.
The input fails validation (e.g., invalid URL format, username too long).
{ "error": { "code": "VALIDATION_ERROR", "message": "Invalid Instagram username format" } }Verify the input matches the expected format for the scrape type.
You've exceeded your monthly credit limit.
{ "error": { "code": "RATE_LIMITED", "message": "Monthly credit limit exceeded" } }Wait for your billing cycle to reset, or upgrade to a higher plan for more credits.
An unexpected server error occurred.
{ "error": { "code": "INTERNAL_ERROR", "message": "Internal server error" } }Retry the request. If it persists, contact support.
The scraping worker is temporarily unavailable.
{ "error": { "code": "BAD_GATEWAY", "message": "Worker unavailable" } }Wait a moment and retry. The worker service may be restarting.
The service is temporarily overloaded or under maintenance.
{ "error": { "code": "SERVICE_UNAVAILABLE", "message": "Service temporarily unavailable" } }Wait and retry with exponential backoff. Check /status for service health.