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

> Discover the URLs on a website — a fast way to build a link inventory before scraping or crawling.

Given a starting URL, discover the links reachable on that site and get them back as a list. This is the cheapest way to understand a site's shape before deciding what to scrape or crawl. The `url` must be HTTPS and `limit` is required (1 to 100000).

Billing is metered per Firecrawl credit — 1 credit per discovered link. To then pull content, feed the URLs into [`post_firecrawl-scrape`](/docs/api-reference/search/post_firecrawl-scrape) or [`post_firecrawl-batch-scrape`](/docs/api-reference/search/post_firecrawl-batch-scrape).


## OpenAPI

````yaml openapi/firecrawl.json POST /firecrawl/map
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/map:
    post:
      tags:
        - https://docs.firecrawl.dev/api-reference/endpoint/map
      summary: Discover the URLs on a website.
      description: >-
        Synchronous. Given a starting URL, discover and return the links
        reachable on that site. The URL must be HTTPS and limit is required (1
        to 100000). Billed at 1 Firecrawl credit per discovered link/page.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                url:
                  type: string
                  format: uri
                  description: The HTTPS URL to map.
                  example: https://docs.firecrawl.dev
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100000
                  description: >-
                    Maximum number of links to discover. Required on the metered
                    profile.
                  example: 100
              required:
                - url
                - limit
      responses:
        '200':
          description: Map completed successfully.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    description: True when the map succeeded.
                  links:
                    type: array
                    description: Discovered links.
                    items:
                      type: object
                      properties:
                        url:
                          type: string
                          description: A discovered URL.
                        title:
                          type: string
                          description: Title of the discovered page, when available.
                  creditsUsed:
                    type: integer
                    description: Firecrawl credits consumed (1 per discovered link).
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````