POST
/
map
Map multiple URLs based on options
curl --request POST \
  --url https://api.firecrawl.dev/v1/map \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "url": "<string>",
  "search": "<string>",
  "ignoreSitemap": true,
  "sitemapOnly": false,
  "includeSubdomains": true,
  "limit": 5000,
  "timeout": 123,
  "location": {
    "country": "US",
    "languages": [
      "en-US"
    ]
  }
}'
{
  "success": true,
  "links": [
    "<string>"
  ]
}
Remarque : Une nouvelle version v2 de cette API est désormais disponible, avec des fonctionnalités et des performances améliorées.

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 base URL to start crawling from

​
search
string

Search query to use for mapping. During the Alpha phase, the 'smart' part of the search functionality is limited to 500 search results. However, if map finds more results, there is no limit applied.

​
ignoreSitemap
boolean
default:true

Ignore the website sitemap when crawling.

​
sitemapOnly
boolean
default:false

Only return links found in the website sitemap

​
includeSubdomains
boolean
default:true

Include subdomains of the website

​
limit
integer
default:5000

Maximum number of links to return

Required range: x <= 30000
​
timeout
integer

Timeout in milliseconds. There is no timeout by default.

​
location
object

Location settings for the request. When specified, this will use an appropriate proxy if available and emulate the corresponding language and timezone settings. Defaults to 'US' if not specified.

Response

Successful response

​
success
boolean
​
links
string[]