firecrawl map#

Discover URLs on a site. Use --search to find a specific page within a large site.

When to use#

• You need to find a specific subpage on a large site
• You want a list of all URLs on a site before scraping or crawling
• Step 3 in the workflow escalation pattern: search → scrape → map → crawl → interact

Quick start#

bash

# Find a specific page on a large site
firecrawl map "<url>" --search "authentication" -o .firecrawl/filtered.txt

# Get all URLs
firecrawl map "<url>" --limit 500 --json -o .firecrawl/urls.json

Options#

OptionDescription--limit <n>Max number of URLs to return--search <query>Filter URLs by search query--sitemap <include|skip|only>Sitemap handling strategy--include-subdomainsInclude subdomain URLs--jsonOutput as JSON-o, --output <path>Output file path

Tips#

• Map + scrape is a common pattern: use map --search to find the right URL, then scrape it.
• Example: map https://docs.example.com --search "auth" → found /docs/api/authentication → scrape that URL.

See also#

• firecrawl-scrape — scrape the URLs you discover
• firecrawl-crawl — bulk extract instead of map + scrape
• firecrawl-download — download entire site (uses map internally)