Data API / Firecrawl / Map
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. 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.
Parameters
No path, query, or header parameters.
Request body
urlstringRequiredThe HTTPS URL to map.
limitintegerRequiredMaximum number of links to discover. Required on the metered profile.
Example request
curl -X POST "https://openapi.felo.ai/v1/beta/firecrawl/map" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "<string>",
"limit": 0
}'Response
Response fields
successbooleanOptionalTrue when the map succeeded.
linksobject[]OptionalDiscovered links.
urlstringOptionalA discovered URL.
titlestringOptionalTitle of the discovered page, when available.
creditsUsedintegerOptionalFirecrawl credits consumed (1 per discovered link).