Firecrawl Map

1.2 credits/call
ae_firecrawl_map

Discover URLs on a website before choosing pages to scrape, or locate pages about a particular topic. This tool returns URL-discovery results, not page bodies. Parameters: - url (required URI string): website to map. - search (optional string): filter discovered URLs using a content or topic query. - limit (optional number): result limit; the confirmed schema specifies no default or numeric bounds. - sitemap (optional string): "include", "skip", or "only" to include, skip, or exclusively use the sitemap. - includeSubdomains (optional boolean): include URLs from subdomains. - ignoreQueryParameters (optional boolean): ignore query parameters when identifying and returning mapped URLs. No additional arguments are accepted. Defaults for optional inputs are not specified in the confirmed schema. Returns an object that may include links (discovered URLs), success (boolean or null), error (message or object), warning (string or null), id (string or null, map-run identifier for optional feedback), agent_hints (string array), and conversationId (string). None of these fields is required by the result schema, and the structure of individual links is not specified. conversationId is response metadata, not an accepted input here. Execution: a direct SimpleMapping request returns the result; this tool has no configured asynchronous submission, status polling, or separate result-retrieval workflow. The returned id is not a documented polling handle. Limitations: URL discovery does not extract page content or guarantee a complete inventory of a website. If you already know the target URL and need its contents, use a scraping tool. If a scrape gives empty or irrelevant content, mapping with search can help locate a better page. Example: ae_firecrawl_map({"url":"https://docs.example.com","search":"webhook events"}).

Productivity
1.2 credits/call

Pricing

1.2 credits/call
ConditionCharge
Each call1.2 credits/call

Each website URL discovery call has a fixed charge of 1.2 credits. Billing is based solely on the number of calls.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
urlstringYesNo parameter description.—
limitnumberNoNo parameter description.—
searchstringNoFilter discovered URLs by a search query to find pages containing specific content or topics.—
sitemapenum (include | skip | only)NoNo parameter description.—
includeSubdomainsbooleanNoInclude URLs from the website's subdomains in the mapping results.—
ignoreQueryParametersbooleanNoIgnore URL query parameters when identifying and returning mapped URLs.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_firecrawl_map' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "ignoreQueryParameters": true,
    "limit": 400,
    "sitemap": "include",
    "url": "https://www.phoenixpeptide.com"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "conversationId": "a45bec0e-766b-4008-8eb9-80f63d086c2e",
  "id": "01a1a5d7-1eae-75e0-91fa-be51f913fd6b",
  "links": [
    {
      "description": "Blocking Buffer and Antibody Diluent for Dot Blot and Western Blot Kits (Cat. No. WB-B003) from Phoenix Pharmaceuticals, made in the USA with a Certificate o...",
      "title": "Blocking Buffer and Antibody Diluent for Dot Blot and Wes...",
      "url": "https://phoenixpeptide.com/products/blocking-buffer-and-antibody-diluent-for-dot-blot-and-western-blot-kits"
    }
  ]
}

This example shows part of the response. Copied content is valid JSON.