Skip to main content
POST
Parse an uploaded HTML file into markdown.
Upload a single HTML/HTM file and receive its parsed markdown. Use this when you already hold the raw HTML (for example a saved page or a document your own pipeline produced) and want Firecrawl to clean it into markdown without a live fetch. The request is multipart/form-data with two fields: file (the HTML upload) and options (a JSON string). On the metered profile options must set proxy to "basic" and may only additionally set formats to ["markdown"]; the options string is limited to 64 KB. Billing is metered per Firecrawl credit — Parse costs 1 credit.

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
file
file
required

The HTML/HTM file to parse. Must have a text/html content type or an .html/.htm filename.

options
string
required

JSON string of parse options. Must include proxy="basic"; may additionally include formats=["markdown"]. No other keys are allowed.

Example:

"{\"proxy\":\"basic\",\"formats\":[\"markdown\"]}"

Response

200 - application/json

Parse completed successfully.

success
boolean

True when the parse succeeded.

data
object
creditsUsed
integer

Firecrawl credits consumed (1).