Skip to main content
All endpoints return standard HTTP status codes:
  • 200 OK: Request successful
  • 400 Bad Request: Invalid request parameters or body
  • 401 Unauthorized: Missing or invalid API key
  • 404 Not Found: Resource not found
  • 500 Internal Server Error: Server error

​
Error Response Format

Error responses follow this format: 
{
  "error": [
    {
      "message": "Error message description",
      "path": "field.path"
    }
  ]
}

​
Common Error Scenarios

​
Missing API Key

{
  "error": "API key is required"
}

​
Invalid Parameters

{
  "error": [
    {
      "message": "At least 3 and at most 10 keywords are required",
      "path": "keywords"
    }
  ]
}

​
Invalid Callback URL

{
  "error": [
    {
      "message": "Callback URL must be a valid HTTPS URL",
      "path": "callbackUrl"
    }
  ]
}

​
Insufficient Credits

{
  "error": "Insufficient credits"
}
This error occurs when creating a job and you don’t have enough credits in the appropriate tier (Pro credits for enriched searches, Basic credits for non-enriched searches, or Private Key credits when scraperKey is provided).

​
Invalid Firecrawl Scraper API Key

{
  "error": "Invalid Firecrawl Scraper API key"
}
This error occurs when you provide scraperKey but the Firecrawl key is invalid.

​
Firecrawl Account Has Less Than 50 Remaining Credits

{
  "error": "Firecrawl account has less than 50 remaining credits"
}
This error occurs when you provide scraperKey but the associated Firecrawl account has fewer than 50 remaining credits.