Skip to main content
POST
Reference example
List the URLs reachable from a starting page, without fetching any content. url and limit are both required (limit 1 to 100000). Returns success, a request id, and links[] with url and title — note these are objects with a title, unlike post_tavily_map which returns bare strings. Measured at about 9 seconds. Billed 1 credit per discovered link, so limit is a cost control, not just a page control. Use it to size a site before paying to crawl it, then fetch only what matters with post_firecrawl_scrape. When you want content and structure in one pass, post_firecrawl_crawl.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

  • Method and path: POST /apis/v1/firecrawl/map
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/firecrawl/map
  • Runtime facts: 82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Usage-based billing; Default request estimate: $0.001071 USD (not a fixed price). Declared unit rate: $0.001071 USD per firecrawl_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.001071
  • Declared unit rate (USD): 0.001071
  • Billing unit: firecrawl_credit
  • Cost contract: response_count
  • Published reference multiplier: 1.0
  • Declared maximum count/units: 100000
  • Settlement evidence source: response_body

Reservation units (not settled usage)

  • Units: (limit) × 1
  • Public request parameter: limit

Authorizations

Authorization
string
header
required

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

Body

application/json
limit
integer
required
Required range: 1 <= x <= 100000
url
string<https_url>
required

Response

Map completed successfully.

creditsUsed
integer

Firecrawl credits consumed (1 per discovered link).

Discovered links.

success
boolean

True when the map succeeded.