Map

Firecrawl

Find relevant page URLs across a public website.

Capability: Website mapping
Current price: $0.0070/call
Availability: Ready to run

What this API does

Discover up to 1,000 page URLs on a public website, optionally ranked by a search phrase. Returns URLs and available titles and descriptions, without scraping page content. Costs one call regardless of the number of URLs returned. Subdomains are excluded; mapping does not guarantee a complete site inventory.

Agents select this operation with tool ID firecrawl.map, then inspect its current executable contract before a run.

Public input and output shape

Input

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 1000

searchstring · optional

Value supplied for search.

minLength: 1 · maxLength: 500

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

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

Output

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

Teaching 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 Map with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.