Skip to main content
POST
Scrape a single page and return its main content as markdown.
Fetch one URL and return its cleaned main content as markdown. Use this as the fast, single-page entry point when you already know the exact page you need. On the AIsa metered profile the request is deliberately narrow: the URL must be HTTPS and must not be a PDF, proxy must be set to "basic", and if you send formats it must be exactly ["markdown"]. Advanced Firecrawl options (actions, headers, parsers, profile, lockdown, zeroDataRetention) are not accepted. Billing is metered per Firecrawl credit — Scrape costs 1 credit per page. To discover URLs first, use post_firecrawl-map; to scrape many pages at once, use post_firecrawl-batch-scrape.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
url
string<uri>
required

The HTTPS URL to scrape. PDF URLs are not supported on the metered profile.

Example:

"https://docs.firecrawl.dev"

proxy
enum<string>
required

Proxy tier. Must be explicitly set to "basic" on the metered profile.

Available options:
basic
Example:

"basic"

formats
enum<string>[]

Optional output formats. When present it must be exactly ["markdown"].

Available options:
markdown
Example:

Response

200 - application/json

Scrape completed successfully.

success
boolean

True when the scrape succeeded.

data
object
creditsUsed
integer

Firecrawl credits consumed by the request (1 per page).