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

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).