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:

Common Error Scenarios

Missing API Key

Invalid Parameters

Invalid Callback URL

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

This error occurs when you provide scraperKey but the Firecrawl key is invalid.

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.