Passer au contenu principal
POST
/
map
Cartographier plusieurs URL selon les 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.

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json
​
url
string<uri>
requis

L’URL de base à partir de laquelle démarrer l’exploration

​
search
string

Requête de recherche à utiliser pour la cartographie. Pendant la phase Alpha, la partie « intelligente » de la fonction de recherche est limitée à 500 résultats. En revanche, si « map » renvoie davantage de résultats, aucune limite n’est appliquée.

​
ignoreSitemap
boolean
défaut:true

Ignorer le sitemap du site lors de l’exploration.

​
sitemapOnly
boolean
défaut:false

Ne renvoyer que les liens présents dans le sitemap du site web

​
includeSubdomains
boolean
défaut:true

Inclure les sous-domaines du site

​
limit
integer
défaut:5000

Nombre maximal de liens renvoyés

Plage requise: x <= 30000
​
timeout
integer

Délai d’expiration en millisecondes. Aucun délai d’expiration n’est défini par défaut.

​
location
object

Paramètres de localisation pour la requête. Lorsqu’ils sont spécifiés, un proxy approprié sera utilisé si disponible et les paramètres de langue et de fuseau horaire correspondants seront émulés. La valeur par défaut est « US » si aucun paramètre n’est indiqué.

Réponse

Réponse en cas de succès

​
success
boolean
​
links
string[]