Skip to main content
POST
Parse an uploaded HTML file into markdown.
Parse an HTML file you upload and get markdown back. This is multipart/form-data with two fields: file (an HTML upload that must carry a text/html content type or an .html/.htm filename) and options (a JSON string that must set proxy to basic, may additionally set formats to ["markdown"], and is capped at 64 KB). Returns success and data.markdown with metadata. Billed 1 Firecrawl credit. ⚠️ Not available as an MCP tool. A tool call carries JSON, so the file arrives as a plain form field with no filename and upstream rejects it — verified. Over MCP use post_firecrawl_scrape with a URL instead. This endpoint is for HTTP clients that hold an actual file.

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).