# エンドポイント フィードバック (/ja/api-reference/endpoint/feedback) 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 に伝えられます。これは、`scrape`、`parse`、`map`、`search` などのジョブにおける、エンドポイント単位の出力品質を評価するためのものです。 汎用的なフィードバック スキーマには search 向けのフィールドも含められますが、[Search Feedback](/ja/api-reference/endpoint/search-feedback) は search 専用の推奨エントリーポイントです。これは search ジョブ ID に紐づいており、価値のあるソース、不足しているコンテンツ、query の提案、返金の扱いを示します。
### リクエスト例 [#リクエスト例]
```bash curl -X POST "https://api.firecrawl.dev/v2/feedback" \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "endpoint": "scrape", "jobId": "550e8400-e29b-41d4-a716-446655440000", "rating": "partial", "issues": ["missing_markdown"], "note": "The pricing table was missing from the markdown output.", "url": "https://example.com/pricing" }' ``` `POST /feedback` v2 ジョブのフィードバックを送信 ## OpenAPI ```json { "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "allOf": [ { "description": "'good' の場合は valuableSources を含めてください。'partial' の場合は valuableSources または missingContent を含めてください。'bad' の場合は missingContent または querySuggestions を含めてください。", "properties": { "integration": { "nullable": true, "type": "string" }, "missingContent": { "items": { "properties": { "description": { "maxLength": 2000, "type": "string" }, "topic": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "topic" ], "type": "object" }, "maxItems": 20, "type": "array" }, "origin": { "default": "api", "type": "string" }, "querySuggestions": { "maxLength": 2000, "type": "string" }, "rating": { "enum": [ "good", "partial", "bad" ], "type": "string" }, "valuableSources": { "items": { "properties": { "reason": { "maxLength": 1000, "type": "string" }, "url": { "format": "uri", "type": "string" } }, "required": [ "url" ], "type": "object" }, "maxItems": 50, "type": "array" } }, "required": [ "rating" ], "type": "object" }, { "description": "v2 ジョブのフィードバックを送信します。issues、note、valuableSources、missingContent、querySuggestions、url、pageNumbers などの実質的なシグナルを少なくとも 1 つ含めてください。", "properties": { "endpoint": { "enum": [ "search", "scrape", "parse", "map" ], "type": "string" }, "issues": { "items": { "maxLength": 80, "pattern": "^[a-z0-9][a-z0-9_-]*$", "type": "string" }, "maxItems": 20, "type": "array" }, "jobId": { "format": "uuid", "type": "string" }, "metadata": { "additionalProperties": true, "description": "小さなエンドポイント固有のメタデータオブジェクトです。8KB 以下にする必要があります。エンドポイントの完全な結果は含めないでください。", "type": "object" }, "missingContent": { "items": { "properties": { "description": { "maxLength": 2000, "type": "string" }, "topic": { "maxLength": 200, "minLength": 1, "type": "string" } }, "required": [ "topic" ], "type": "object" }, "maxItems": 50, "type": "array" }, "note": { "maxLength": 4000, "type": "string" }, "pageNumbers": { "items": { "minimum": 1, "type": "integer" }, "maxItems": 100, "type": "array" }, "tags": { "items": { "maxLength": 80, "pattern": "^[a-z0-9][a-z0-9_-]*$", "type": "string" }, "maxItems": 20, "type": "array" }, "url": { "format": "uri", "type": "string" } }, "required": [ "endpoint", "jobId" ], "type": "object" } ] } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "alreadySubmitted": { "type": "boolean" }, "creditsRefunded": { "type": "number" }, "creditsRefundedToday": { "type": "number" }, "dailyCapReached": { "type": "boolean" }, "dailyRefundCap": { "type": "number" }, "feedbackId": { "format": "uuid", "type": "string" }, "success": { "example": true, "type": "boolean" }, "warning": { "type": "string" } }, "required": [ "success", "feedbackId", "creditsRefunded" ], "type": "object" } } }, "description": "フィードバックを記録しました" }, "400": { "content": { "application/json": { "schema": { "properties": { "details": { "items": { "type": "object" }, "type": "array" }, "error": { "type": "string" }, "feedbackErrorCode": { "type": "string" }, "success": { "example": false, "type": "boolean" } }, "required": [ "success", "error" ], "type": "object" } } }, "description": "無効なリクエストボディ" }, "403": { "content": { "application/json": { "schema": { "properties": { "details": { "items": { "type": "object" }, "type": "array" }, "error": { "type": "string" }, "feedbackErrorCode": { "type": "string" }, "success": { "example": false, "type": "boolean" } }, "required": [ "success", "error" ], "type": "object" } } }, "description": "このチームではフィードバックを利用できません" }, "404": { "content": { "application/json": { "schema": { "properties": { "details": { "items": { "type": "object" }, "type": "array" }, "error": { "type": "string" }, "feedbackErrorCode": { "type": "string" }, "success": { "example": false, "type": "boolean" } }, "required": [ "success", "error" ], "type": "object" } } }, "description": "このチームのジョブが見つかりません" }, "409": { "content": { "application/json": { "schema": { "properties": { "details": { "items": { "type": "object" }, "type": "array" }, "error": { "type": "string" }, "feedbackErrorCode": { "type": "string" }, "success": { "example": false, "type": "boolean" } }, "required": [ "success", "error" ], "type": "object" } } }, "description": "このジョブにはフィードバックを記録できません" }, "500": { "content": { "application/json": { "schema": { "properties": { "details": { "items": { "type": "object" }, "type": "array" }, "error": { "type": "string" }, "feedbackErrorCode": { "type": "string" }, "success": { "example": false, "type": "boolean" } }, "required": [ "success", "error" ], "type": "object" } } }, "description": "サーバーエラー" } } } ```