> ## 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 Scrape

> Scrape a single web page and get its main content back as clean markdown — no HTML parsing on your side.

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`](/docs/api-reference/search/post_firecrawl-map); to scrape many pages at once, use [`post_firecrawl-batch-scrape`](/docs/api-reference/search/post_firecrawl-batch-scrape).


## OpenAPI

````yaml openapi/firecrawl.json POST /firecrawl/scrape
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/scrape:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/scrape
      summary: Scrape a single page and return its main content as markdown.
      description: >-
        Synchronous. Fetch one URL and return its cleaned main content as
        markdown. On the AIsa metered profile the request is restricted: the URL
        must be HTTPS and must not point at a PDF, proxy must be set to "basic",
        and if formats is supplied it must be exactly ["markdown"]. Advanced
        options (actions, headers, parsers, profile, lockdown,
        zeroDataRetention) are rejected. Billed at 1 Firecrawl credit per page
        scraped.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: >-
                    The HTTPS URL to scrape. PDF URLs are not supported on the
                    metered profile.
                  example: https://docs.firecrawl.dev
                proxy:
                  type: string
                  enum:
                    - basic
                  description: >-
                    Proxy tier. Must be explicitly set to "basic" on the metered
                    profile.
                  example: basic
                formats:
                  type: array
                  items:
                    type: string
                    enum:
                      - markdown
                  description: >-
                    Optional output formats. When present it must be exactly
                    ["markdown"].
                  example:
                    - markdown
              required:
                - url
                - proxy
      responses:
        '200':
          description: Scrape completed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: True when the scrape succeeded.
                  data:
                    type: object
                    properties:
                      markdown:
                        type: string
                        description: The scraped page content in markdown.
                      metadata:
                        type: object
                        description: >-
                          Page metadata such as title, description, source URL,
                          and HTTP status.
                        properties:
                          title:
                            type: string
                          description:
                            type: string
                          sourceURL:
                            type: string
                          statusCode:
                            type: integer
                  creditsUsed:
                    type: integer
                    description: Firecrawl credits consumed by the request (1 per page).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````