Firecrawl Map

Firecrawl

Discover page URLs across a public website.

Capability: Website mapping
Current price: $0.0025/request
Availability: Ready to run

What this API does

Discover up to 1,000 page URLs on a public website, optionally ranked by relevance to a short search phrase. The phrase is a ranking hint, not a strict filter. Subdomains are excluded. Each completed request, including an empty result, has one flat price. Mapping does not guarantee a complete site inventory. The worked example shows selected fields and at most one item per list; counts retain their recorded values.

Agents select this operation with tool ID firecrawl.site-map, then check its current inputs and price before a run.

Inputs and outputs

Input

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

searchstring · optional

Value supplied for search.

minLength: 1 · maxLength: 200

urlstring · required

Public HTTPS web page. PDF files and X/Twitter URLs are excluded.

format: uri · maxLength: 2048

Output

limitnumber

Returned limit value.

linksarray

Returned links value.

returned_resultsnumber

Returned returned results value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "firecrawl.site-map",
  "input": {
    "url": "https://example.com/",
    "limit": 3
  }
}

Output

{
  "limit": 3,
  "links": [
    {
      "url": "https://example.com/",
      "title": "Example Domain"
    }
  ],
  "returned_results": 1
}

Errors and limitations

invalid_input: The URL, query or limits are outside this tool's supported inputs.example: {"url":"https://example.com/","limit":3}
upstream_error: The provider could not return usable results; the wallet was not charged.Check the target page and retry with a smaller limit if necessary.

Use Firecrawl Map with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.