跳转到主要内容
POST
/
feedback
提交 v2 任务反馈
curl --request POST \
  --url https://api.firecrawl.dev/v2/feedback \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "integration": "<string>",
  "missingContent": [
    {
      "topic": "<string>",
      "description": "<string>"
    }
  ],
  "origin": "api",
  "querySuggestions": "<string>",
  "valuableSources": [
    {
      "url": "<string>",
      "reason": "<string>"
    }
  ],
  "issues": [
    "<string>"
  ],
  "metadata": {},
  "note": "<string>",
  "pageNumbers": [
    2
  ],
  "tags": [
    "<string>"
  ],
  "url": "<string>"
}
'
{
  "creditsRefunded": 123,
  "feedbackId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "success": true,
  "alreadySubmitted": true,
  "creditsRefundedToday": 123,
  "dailyCapReached": true,
  "dailyRefundCap": 123,
  "warning": "<string>"
}
使用端点反馈来告知 Firecrawl，某个已完成任务的结果是有用、部分有用，还是较差。这用于评估 scrape、parse、map 和 search 等任务在端点级别的输出质量。 通用反馈 schema 也可以包含搜索相关字段，但 搜索反馈 是更推荐的搜索专用入口，因为它绑定到特定的搜索任务 ID，并可标注有价值的来源、缺失的内容、query 建议以及退款处理。

​
请求示例

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"
  }'

授权

​
Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json

提交 v2 任务反馈。请至少包含一项有效信号，例如 issues、note、valuableSources、missingContent、querySuggestions、url 或 pageNumbers。

​
rating
enum<string>
必填
可用选项:
good,
partial,
bad
​
endpoint
enum<string>
必填
可用选项:
search,
scrape,
parse,
map
​
jobId
string<uuid>
必填
​
integration
string | null
​
missingContent
object[]
Maximum array length: 20
​
origin
string
默认值:api
​
querySuggestions
string
Maximum string length: 2000
​
valuableSources
object[]
Maximum array length: 50
​
issues
string[]
Maximum array length: 20
Maximum string length: 80
Pattern: ^[a-z0-9][a-z0-9_-]*$
​
metadata
object

较小的端点专用元数据对象。大小必须不超过 8KB；请勿包含完整的端点结果。

​
note
string
Maximum string length: 4000
​
pageNumbers
integer[]
Maximum array length: 100
必填范围: x >= 1
​
tags
string[]
Maximum array length: 20
Maximum string length: 80
Pattern: ^[a-z0-9][a-z0-9_-]*$
​
url
string<uri>

响应

反馈已记录

​
creditsRefunded
number
必填
​
feedbackId
string<uuid>
必填
​
success
boolean
必填
示例:

true

​
alreadySubmitted
boolean
​
creditsRefundedToday
number
​
dailyCapReached
boolean
​
dailyRefundCap
number
​
warning
string