Passer au contenu principal
POST
/
map
Mapper plusieurs URL en fonction des options
curl --request POST \
  --url https://api.firecrawl.dev/v2/map \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "url": "<string>",
  "search": "<string>",
  "sitemap": "include",
  "includeSubdomains": true,
  "ignoreQueryParameters": true,
  "limit": 5000,
  "location": {
    "country": "US",
    "languages": [
      "en-US"
    ]
  },
  "timeout": 60000
}
'
{
  "success": true,
  "links": [
    {
      "url": "<string>",
      "title": "<string>",
      "description": "<string>"
    }
  ]
}

​
Nouveautés de la v2

​
Meilleur contrôle des sitemaps

Trois façons de gérer les sitemaps :
  • "include" - Utiliser le sitemap et trouver d’autres pages (par défaut)
  • "skip" - Ignorer complètement le sitemap
  • "only" - Renvoyer uniquement les URL du sitemap
{
  "url": "https://example.com",
  "sitemap": "only"
}

​
Format de réponse modifié

Nous renvoyons maintenant les liens dans le tableau d’objets links, accompagnés de métadonnées enrichies. 
{
  "url": "https://example.com",
  "links": [
    {
      "url": "https://example.com/page1",
      "title": "Page 1",
      "description": "Page 1 description"
    }
  ]
}

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 le crawl

​
search
string

Spécifiez une requête de recherche pour classer les résultats par pertinence. Exemple : « blog » renverra les URL qui contiennent le mot « blog » dans leur adresse, classées par pertinence.

​
sitemap
enum<string>
défaut:include

Mode sitemap lors du mapping. Si vous le réglez sur skip, le sitemap ne sera pas utilisé pour trouver des URL. Si vous le réglez sur only, seules les URL présentes dans le sitemap seront renvoyées. Par défaut (include), le sitemap et d’autres méthodes sont utilisés conjointement pour trouver des URL.

Options disponibles:
skip,
include,
only
​
includeSubdomains
boolean
défaut:true

Inclure les sous-domaines du site

​
ignoreQueryParameters
boolean
défaut:true

Ne renvoyez pas d’URL contenant des paramètres de requête

​
limit
integer
défaut:5000

Nombre maximal de liens à retourner

Plage requise: x <= 100000
​
timeout
integer

Délai d’attente en millisecondes. Aucun délai d’attente n’est appliqué par défaut.

​
location
object

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

Réponse

Réponse réussie

​
success
boolean
​
links
object[]