Firecrawl Mapping API
The Mapping API from Firecrawl — 1 operation(s) for mapping.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/firecrawl-mapping-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Firecrawl Account Mapping API
version: v2
description: API for interacting with Firecrawl services to perform web scraping and crawling tasks.
contact:
name: Firecrawl Support
url: https://firecrawl.dev/support
email: support@firecrawl.dev
servers:
- url: https://api.firecrawl.dev/v2
security:
- bearerAuth: []
tags:
- name: Mapping
paths:
/map:
post:
summary: Map multiple URLs based on options
operationId: mapUrls
tags:
- Mapping
security:
- bearerAuth: []
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
url:
type: string
format: uri
description: The base URL to start crawling from
search:
type: string
description: 'Specify a search query to order the results by relevance. Example: ''blog'' will return URLs that contain the word ''blog'' in the URL ordered by relevance.'
sitemap:
type: string
enum:
- skip
- include
- only
description: Sitemap mode when mapping. If you set it to `skip`, the sitemap won't be used to find URLs. If you set it to `only`, only URLs that are in the sitemap will be returned. By default (`include`), the sitemap and other methods will be used together to find URLs.
default: include
includeSubdomains:
type: boolean
description: Include subdomains of the website
default: true
ignoreQueryParameters:
type: boolean
description: Do not return URLs with query parameters
default: true
ignoreCache:
type: boolean
description: Bypass the sitemap cache to retrieve fresh URLs. Sitemap data is cached for up to 7 days; use this parameter when your sitemap has been recently updated.
default: false
limit:
type: integer
description: Maximum number of links to return
default: 5000
maximum: 100000
timeout:
type: integer
description: Timeout in milliseconds. There is no timeout by default.
location:
type: object
description: 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.
properties:
country:
type: string
description: ISO 3166-1 alpha-2 country code (e.g., 'US', 'AU', 'DE', 'JP')
pattern: ^[A-Z]{2}$
default: US
languages:
type: array
description: Preferred languages and locales for the request in order of priority. Defaults to the language of the specified location. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
items:
type: string
example: en-US
required:
- url
examples:
example1:
summary: Example 1
value:
url: <string>
search: <string>
sitemap: include
includeSubdomains: true
ignoreQueryParameters: true
ignoreCache: false
limit: 5000
location:
country: US
languages:
- en-US
timeout: 60000
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/MapResponse'
'402':
description: Payment required
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Payment required to access this resource.
'429':
description: Too many requests
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: Request rate limit exceeded. Please wait and try again later.
'500':
description: Server error
content:
application/json:
schema:
type: object
properties:
error:
type: string
example: An unexpected error occurred on the server.
components:
schemas:
MapResponse:
type: object
properties:
success:
type: boolean
links:
type: array
items:
type: object
properties:
url:
type: string
format: uri
title:
type: string
description: The title of the page, if available.
description:
type: string
description: A description of the page, if available.
required:
- url
securitySchemes:
bearerAuth:
type: http
scheme: bearer