# マップ (/ja/api-reference/endpoint/map)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 2169 · updated: 2026-07-30 -->
Related: [検索](/ja/api-reference/endpoint/search.md), [検索フィードバック](/ja/api-reference/endpoint/search-feedback.md), [スクレイプ](/ja/api-reference/endpoint/scrape.md), [バッチスクレープ](/ja/api-reference/endpoint/batch-scrape.md), [バッチスクレイプのステータス取得](/ja/api-reference/endpoint/batch-scrape-get.md), [バッチスクレイプのキャンセル](/ja/api-reference/endpoint/batch-scrape-delete.md)

> Firecrawl APIキーを必要とするAIエージェントですか？自動オンボーディングの手順については、[firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md)を参照してください。

`POST /map`

オプションを指定して複数のURLをマップする

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "content": {
      "application/json": {
        "examples": {
          "example1": {
            "summary": "例 1",
            "value": {
              "ignoreCache": false,
              "ignoreQueryParameters": true,
              "includeSubdomains": true,
              "limit": 5000,
              "location": {
                "country": "US",
                "languages": [
                  "en-US"
                ]
              },
              "search": "<string>",
              "sitemap": "include",
              "timeout": 60000,
              "url": "<string>"
            }
          }
        },
        "schema": {
          "properties": {
            "auditMetadata": {
              "additionalProperties": false,
              "description": "組織でSIEM Loggingが有効になっている場合、SIEMロギングイベントに含まれるユーザーの属性情報。",
              "properties": {
                "username": {
                  "description": "リクエストに関連付けられたユーザー名。",
                  "maxLength": 1024,
                  "type": "string"
                }
              },
              "required": [
                "username"
              ],
              "type": "object"
            },
            "ignoreCache": {
              "default": false,
              "description": "サイトマップキャッシュを無視して最新のURLを取得します。サイトマップデータは最大7日間キャッシュされるため、サイトマップを最近更新した場合はこのパラメータを指定してください。",
              "type": "boolean"
            },
            "ignoreQueryParameters": {
              "default": true,
              "description": "クエリパラメータ付きのURLを返さない",
              "type": "boolean"
            },
            "includeSubdomains": {
              "default": true,
              "description": "このサイトのサブドメインを含める",
              "type": "boolean"
            },
            "limit": {
              "default": 5000,
              "description": "返すリンクの最大数",
              "maximum": 100000,
              "type": "integer"
            },
            "location": {
              "description": "リクエストのロケーション設定です。指定すると、利用可能な場合は適切なプロキシを使用し、対応する言語およびタイムゾーン設定をエミュレートします。指定しない場合は、デフォルトで「US」が使用されます。",
              "properties": {
                "country": {
                  "default": "US",
                  "description": "ISO 3166-1 の alpha-2 国コード（例: 「US」「AU」「DE」「JP」）",
                  "pattern": "^[A-Z]{2}$",
                  "type": "string"
                },
                "languages": {
                  "description": "リクエストに対して優先度順に指定する言語およびロケール。指定された location の言語がデフォルトになります。詳細は https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language を参照してください。",
                  "items": {
                    "example": "en-US",
                    "type": "string"
                  },
                  "type": "array"
                }
              },
              "type": "object"
            },
            "search": {
              "description": "検索クエリを指定すると、結果が関連度の高い順に並べ替えられます。例: 「blog」を指定すると、URL 内に「blog」を含むものが関連度順に返されます。",
              "type": "string"
            },
            "sitemap": {
              "default": "include",
              "description": "マッピング時のサイトマップモードです。`skip` に設定すると、URL の検出にサイトマップは使用されません。`only` に設定すると、サイトマップ内にある URL だけが返されます。デフォルトの `include` では、サイトマップとその他の手法を併用して URL を検出します。",
              "enum": [
                "skip",
                "include",
                "only"
              ],
              "type": "string"
            },
            "threatProtection": {
              "description": "このリクエスト単位の [脅威保護](https://docs.firecrawl.dev/features/threat-protection) オーバーライドです。指定したフィールドは、このリクエストに限り、組織のポリシー内の対応するフィールドを置き換えます。省略したフィールドには組織レベルの値がそのまま適用されます。利用するには、チームで脅威保護が有効になっている必要があります（エンタープライズ機能）。有効でない場合、リクエストは 403 で拒否されます。組織でリクエストごとのオーバーライドが無効になっている場合、このオブジェクトを含むリクエストはすべて 403 で拒否されます。チームに対して脅威保護が強制適用されている場合、`mode` に `off` は設定できません。",
              "properties": {
                "blacklist": {
                  "description": "常にブロックするドメインです。通常のドメイン（`example.com`）またはワイルドカードグロブ（`*.example.com`）で指定します。プロトコル、パス、ポートは含めないでください。",
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 1000,
                  "type": "array"
                },
                "blockedTlds": {
                  "description": "無条件でブロックするトップレベルドメインです。先頭のドットを付けない小文字で指定します（例: `zip`）。",
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 1000,
                  "type": "array"
                },
                "failurePolicy": {
                  "description": "分類器に到達できない場合の動作です。`closed` はリクエストをブロックし、`open` は許可します。",
                  "enum": [
                    "open",
                    "closed"
                  ],
                  "type": "string"
                },
                "mode": {
                  "description": "このリクエストの URL スキャンモード。`normal` は URL を Google Web Risk でチェックします（スキャンした URL 1 件あたり +2 クレジット）。",
                  "enum": [
                    "off",
                    "normal"
                  ],
                  "type": "string"
                },
                "riskScoreThreshold": {
                  "description": "分類器の判定で URL をブロックする正規化リスクスコアのしきい値（0〜100）。値を低くするほど厳格になります。",
                  "example": 75,
                  "maximum": 100,
                  "minimum": 0,
                  "type": "integer"
                },
                "whitelist": {
                  "description": "常に許可するドメインです。通常のドメインまたはワイルドカードグロブで指定します。ほかのすべてのルールより優先されます。",
                  "items": {
                    "type": "string"
                  },
                  "maxItems": 1000,
                  "type": "array"
                }
              },
              "title": "Threat Protection Override",
              "type": "object"
            },
            "timeout": {
              "description": "タイムアウト（ミリ秒単位）。既定ではタイムアウトはありません。",
              "type": "integer"
            },
            "url": {
              "description": "クロールの開始地点となるベースURL",
              "format": "uri",
              "type": "string"
            }
          },
          "required": [
            "url"
          ],
          "type": "object"
        }
      }
    },
    "required": true
  },
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "links": {
                "items": {
                  "properties": {
                    "description": {
                      "description": "ページの説明（あれば）",
                      "type": "string"
                    },
                    "title": {
                      "description": "（存在する場合の）ページのタイトル。",
                      "type": "string"
                    },
                    "url": {
                      "format": "uri",
                      "type": "string"
                    }
                  },
                  "required": [
                    "url"
                  ],
                  "type": "object"
                },
                "type": "array"
              },
              "success": {
                "type": "boolean"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "成功したレスポンス"
    },
    "402": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Payment required to access this resource.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "お支払いが必要です"
    },
    "429": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "Request rate limit exceeded. Please wait and try again later.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "リクエストが多すぎます"
    },
    "500": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "error": {
                "example": "An unexpected error occurred on the server.",
                "type": "string"
              }
            },
            "type": "object"
          }
        }
      },
      "description": "サーバーエラー"
    }
  }
}
```