Skip to main content
POST
Discover the URLs on a website.
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 or post_firecrawl-batch-scrape.

Authorizations

Authorization
string
header
required

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

Body

application/json
url
string<uri>
required

The HTTPS URL to map.

Example:

"https://docs.firecrawl.dev"

limit
integer
required

Maximum number of links to discover. Required on the metered profile.

Required range: 1 <= x <= 100000
Example:

100

Response

200 - application/json

Map completed successfully.

success
boolean

True when the map succeeded.

Discovered links.

creditsUsed
integer

Firecrawl credits consumed (1 per discovered link).