> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Firecrawl Parse

> Upload an HTML file and get its parsed markdown back — useful when you already have the HTML in hand.

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.


## OpenAPI

````yaml openapi/firecrawl.json POST /firecrawl/parse
openapi: 3.0.0
info:
  title: Firecrawl API
  version: 1.0.0
  description: >-
    Unified API documentation for Firecrawl endpoints including Scrape, Search,
    Map, Parse, Crawl, and Batch Scrape. Scrape, Search, Map, and Parse are
    synchronous. Crawl and Batch Scrape are asynchronous: the caller submits a
    job and then polls the returned job resource for status and results.


    Billing is metered per Firecrawl credit consumed rather than a flat
    per-request price, so total cost scales with the number of pages, links, or
    results the job produces. Approximate credit usage: Scrape = 1 credit per
    page, Map = 1 credit per page, Search = about 2 credits per 10 results,
    Crawl = 1 credit per page, Batch Scrape = 1 credit per page. The USD rate
    per credit depends on your tier (normal $0.005, vip $0.004, svip $0.0034).
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /firecrawl/parse:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/parse
      summary: Parse an uploaded HTML file into markdown.
      description: >-
        Synchronous. Upload a single HTML/HTM file and receive its parsed
        markdown. This endpoint uses 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 JSON string is limited to 64 KB. Billed at
        1 Firecrawl credit.
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: >-
                    The HTML/HTM file to parse. Must have a text/html content
                    type or an .html/.htm filename.
                options:
                  type: string
                  description: >-
                    JSON string of parse options. Must include proxy="basic";
                    may additionally include formats=["markdown"]. No other keys
                    are allowed.
                  example: '{"proxy":"basic","formats":["markdown"]}'
              required:
                - file
                - options
      responses:
        '200':
          description: Parse completed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: True when the parse succeeded.
                  data:
                    type: object
                    properties:
                      markdown:
                        type: string
                        description: The parsed content in markdown.
                  creditsUsed:
                    type: integer
                    description: Firecrawl credits consumed (1).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````