Saltar al contenido principal
POST
/
map
Mapear varias URL en función de las opciones
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>"
    }
  ]
}

​
Novedades de la v2

​
Mejor control del sitemap

Tres formas de gestionar los sitemaps:
  • "include" - Usar el sitemap y encontrar otras páginas (predeterminado)
  • "skip" - Ignorar el sitemap por completo
  • "only" - Devolver solo las URL del sitemap
{
  "url": "https://example.com",
  "sitemap": "only"
}

​
Formato de respuesta modificado

Ahora devolvemos los enlaces en el array links de objetos, con metadatos mejorados. 
{
  "url": "https://example.com",
  "links": [
    {
      "url": "https://example.com/page1",
      "title": "Page 1",
      "description": "Page 1 description"
    }
  ]
}

Autorizaciones

​
Authorization
string
header
requerido

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

Cuerpo

application/json
​
url
string<uri>
requerido

La URL base desde la que comenzar el rastreo

​
search
string

Especifica una consulta de búsqueda para ordenar los resultados según su relevancia. Ejemplo: "blog" devolverá las URL que contengan la palabra "blog" en la URL, ordenadas por relevancia.

​
sitemap
enum<string>
predeterminado:include

Modo de uso del sitemap al mapear. Si lo configuras en skip, el sitemap no se usará para encontrar URL. Si lo configuras en only, solo se devolverán las URL que estén en el sitemap. De forma predeterminada (include), el sitemap y otros métodos se usarán conjuntamente para encontrar URL.

Opciones disponibles:
skip,
include,
only
​
includeSubdomains
boolean
predeterminado:true

Incluir subdominios del sitio web

​
ignoreQueryParameters
boolean
predeterminado:true

No devuelvas direcciones URL con parámetros de consulta

​
limit
integer
predeterminado:5000

Número máximo de enlaces que se devolverán

Rango requerido: x <= 100000
​
timeout
integer

Tiempo de espera en milisegundos. De forma predeterminada, no hay tiempo de espera.

​
location
object

Configuración de ubicación de la solicitud. Cuando se especifica, se utilizará un proxy adecuado si está disponible y se emularán la configuración de idioma y la zona horaria correspondientes. De manera predeterminada se usa 'US' si no se especifica.

Respuesta

Respuesta satisfactoria

​
success
boolean
​
links
object[]