# クロールのステータスを取得 (/ja/api-reference/endpoint/crawl-get)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 2301 · 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)を参照してください。

`GET /crawl/{id}`

クロールジョブの状態を取得する

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "クロールジョブのID",
      "in": "path",
      "name": "id",
      "required": true,
      "schema": {
        "format": "uuid",
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "completed": {
                "description": "クロールに成功したページ数。",
                "type": "integer"
              },
              "completedAt": {
                "description": "クロールの終了日時。クロールが終了状態（`completed`、`failed`、`cancelled`）の場合にのみ設定されます。",
                "format": "date-time",
                "type": "string"
              },
              "createdAt": {
                "description": "クロールの開始日時。",
                "format": "date-time",
                "type": "string"
              },
              "creditsUsed": {
                "description": "このクロールで消費されたクレジット数。",
                "type": "integer"
              },
              "data": {
                "description": "クロールデータ。",
                "items": {
                  "properties": {
                    "html": {
                      "description": "`includeHtml` が true の場合のページコンテンツの HTML 版",
                      "nullable": true,
                      "type": "string"
                    },
                    "links": {
                      "description": "`includeLinks` が true の場合のページ上のリンクの一覧",
                      "items": {
                        "type": "string"
                      },
                      "type": "array"
                    },
                    "markdown": {
                      "type": "string"
                    },
                    "metadata": {
                      "properties": {
                        "<any other metadata> ": {
                          "type": "string"
                        },
                        "concurrencyLimited": {
                          "description": "このスクレイピングがTeamの同時実行数制限によりスロットルされたかどうか",
                          "type": "boolean"
                        },
                        "concurrencyQueueDurationMs": {
                          "description": "リクエストが同時実行キューで待機した時間（ミリ秒）。concurrencyLimited が true の場合にのみ含まれます。",
                          "type": "number"
                        },
                        "description": {
                          "description": "ページから抽出された説明。文字列または文字列の配列です",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          ]
                        },
                        "error": {
                          "description": "ページのエラーメッセージ",
                          "nullable": true,
                          "type": "string"
                        },
                        "keywords": {
                          "description": "ページから抽出されたキーワード。文字列または文字列の配列です",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          ]
                        },
                        "language": {
                          "description": "ページから抽出された言語。文字列または文字列配列である場合があります",
                          "nullable": true,
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          ]
                        },
                        "numPages": {
                          "description": "PDF入力の場合、解析されたページ数（パーサーの maxPages オプションで上限が設定されます）。",
                          "type": "integer"
                        },
                        "ogLocaleAlternate": {
                          "description": "このページの別ロケール",
                          "items": {
                            "type": "string"
                          },
                          "type": "array"
                        },
                        "sourceURL": {
                          "description": "リクエストされた元のURL。リダイレクトが発生した場合、ページの最終URLと異なる場合があります。",
                          "format": "uri",
                          "type": "string"
                        },
                        "statusCode": {
                          "description": "ページのステータスコード",
                          "type": "integer"
                        },
                        "title": {
                          "description": "ページから抽出されたタイトル。文字列または文字列の配列です",
                          "oneOf": [
                            {
                              "type": "string"
                            },
                            {
                              "items": {
                                "type": "string"
                              },
                              "type": "array"
                            }
                          ]
                        },
                        "totalPages": {
                          "description": "PDF入力の場合、maxPages の上限が適用される前の実際の総ページ数。判別できない場合は省略されます。totalPages が numPages を上回る場合、結果は途中で切り詰められています。",
                          "type": "integer"
                        },
                        "url": {
                          "description": "すべてのリダイレクトをたどった後に到達するページの最終的なURL。",
                          "format": "uri",
                          "type": "string"
                        }
                      },
                      "type": "object"
                    },
                    "rawHtml": {
                      "description": "`includeRawHtml` が true の場合に含まれるページの生の HTML コンテンツ",
                      "nullable": true,
                      "type": "string"
                    },
                    "screenshot": {
                      "description": "`includeScreenshot` が true の場合のページのスクリーンショット",
                      "nullable": true,
                      "type": "string"
                    }
                  },
                  "type": "object"
                },
                "type": "array"
              },
              "duration": {
                "description": "クロールの所要時間（秒）。終了済みのクロールでは `createdAt` から `completedAt` までの経過時間、進行中のクロールでは `createdAt` から現在までの経過時間を示します。",
                "type": "number"
              },
              "expiresAt": {
                "description": "クロールの有効期限となる日時。",
                "format": "date-time",
                "type": "string"
              },
              "next": {
                "description": "次の 10MB 分のデータを取得するための URL。クロールが完了していない場合、またはレスポンスが 10MB を超える場合に返されます。",
                "nullable": true,
                "type": "string"
              },
              "status": {
                "description": "クロールの現在の状態です。`scraping`、`completed`、`failed` のいずれかです。",
                "type": "string"
              },
              "total": {
                "description": "クロールを試行したページ数の合計。",
                "type": "integer"
              }
            },
            "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": "サーバーエラー"
    }
  }
}
```