Introduction

Features

Scrape

Extract content from any webpage in markdown or json format.

Crawl

Crawl entire websites, extract their content and metadata.

Map

Get a complete list of URLs from any website quickly and reliably.

Search

Search the web and get full page content in any format.

Agentic Features

Extract

Extract structured data from entire webpages using natural language.

Base URL

All requests contain the following base URL:

https://api.firecrawl.dev

Authentication

For authentication, it’s required to include an Authorization header. The header should contain Bearer fc-123456789, where fc-123456789 represents your API Key.

Authorization: Bearer fc-123456789

Response codes

Firecrawl employs conventional HTTP status codes to signify the outcome of your requests. Typically, 2xx HTTP status codes denote success, 4xx codes represent failures related to the user, and 5xx codes signal infrastructure problems.

Status	Description
200	Request was successful.
400	Verify the correctness of the parameters.
401	The API key was not provided.
402	Payment required
404	The requested resource could not be located.
408	The request timed out (e.g., page took too long to load).
429	The rate limit has been surpassed.
5xx	Signifies a server error with Firecrawl.

Refer to the Error Codes section for a detailed explanation of all potential API errors.

Firecrawl error codes

When a 408 or 5xx error occurs, Firecrawl provides more specific error codes to clarify what went wrong.

Error Code	Status	Description
`SCRAPE_TIMEOUT`	408	The page took too long to load or render. Try increasing the `timeout` parameter (up to 60000ms).
`SCRAPE_ALL_ENGINES_FAILED`	500	All scraping engines failed.
`SCRAPE_SSL_ERROR`	500	Page SSL certificate is invalid. You can use `skipTlsVerification:true` to bypass this check.
`SCRAPE_SITE_ERROR`	500	Unrecoverable site error.
`SCRAPE_DNS_RESOLUTION_ERROR`	500	DNS resolution failed.
`SCRAPE_ACTION_ERROR`	500	Error while performing a page action.
`SCRAPE_PDF_PREFETCH_FAILED`	500	Failed to prefetch PDF.
`SCRAPE_PDF_INSUFFICIENT_TIME_ERROR`	500	Not enough time to process PDF.
`SCRAPE_PDF_ANTIBOT_ERROR`	500	PDF blocked by anti-bot mechanisms.
`SCRAPE_ZDR_VIOLATION_ERROR`	500	Zero Data Retention conflict: occurs when `zeroDataRetention:true` but another option (e.g. `screenshot`) requires temporary storage.
`SCRAPE_UNSUPPORTED_FILE_ERROR`	500	Unsupported file type or file size exceeds 10MB limit.
`SCRAPE_LOCKDOWN_CACHE_MISS`	404	Lockdown mode is enabled but no cached data is available for the URL. Seed the cache with a non-lockdown scrape first, or disable `lockdown`. See Lockdown Mode.
`UNKNOWN_ERROR`	500	Generic or unexpected error.

429 responses

When you exceed your plan’s rate or concurrency limits, the API returns a 429 response code. See Rate Limits for per-plan limits.

Using the API

Search Endpoints

Scrape Endpoints

Interact Endpoints

Research Index Endpoints

Map Endpoints

Parse Endpoints

Crawl Endpoints

Monitor Endpoints

Feedback Endpoints

Agentic Debugging Endpoints

Account Endpoints

Webhook Payloads

Partner Integration

Features

Scrape

Crawl

Map

Search

Agentic Features

Extract

Base URL

Authentication

Response codes

Firecrawl error codes

429 responses

​Features

Scrape

Crawl

Map

Search

​Agentic Features

Extract

​Base URL

​Authentication

​Response codes

​Firecrawl error codes

​429 responses

Features

Agentic Features

Base URL

Authentication

Response codes

Firecrawl error codes

429 responses