Skip to main content
The Firecrawl API gives you programmatic access to web data. All endpoints share a common base URL, authentication scheme, and response format described on this page.

​
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

Agent

Autonomously navigate and extract structured data from websites.

Browser

Create and control browser sessions for interactive web tasks.

​
Base URL

All requests use the following base URL: 
https://api.firecrawl.dev

​
Authentication

Every request requires an Authorization header with your API key: 
Authorization: Bearer fc-YOUR-API-KEY
Include this header in all API calls. You can find your API key in the Firecrawl dashboard. 
curl -X POST "https://api.firecrawl.dev/v2/scrape" \
  -H "Authorization: Bearer fc-YOUR-API-KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

​
Response codes

Firecrawl uses conventional HTTP status codes to indicate the outcome of your requests. Codes in the 2xx range indicate success, 4xx codes indicate client errors, and 5xx codes indicate server errors.
StatusDescription
200Request was successful.
400Invalid request parameters.
401API key is missing or invalid.
402Payment required.
404The requested resource was not found.
429Rate limit exceeded.
5xxServer error on Firecrawl’s side.
When a 5xx error occurs, the response body includes a specific error code to help you diagnose the issue.

​
Rate limit

The Firecrawl API enforces rate limits on all endpoints to ensure service stability. Rate limits are based on the number of requests within a specific time window. When you exceed the rate limit, the API returns a 429 status code. Back off and retry the request after a short delay.