curl -X POST 'https://api.firecrawl.dev/v1/search/example-jobid/feedback' \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
  "rating": "good",
  "valuableSources": [
    {
      "url": "https://example.com",
      "reason": "example-reason"
    }
  ],
  "valuableResults": [
    {
      "source": "web",
      "position": 0,
      "reason": "example-reason"
    }
  ],
  "missingContent": [
    {
      "topic": "example-topic",
      "description": "example-description"
    }
  ],
  "querySuggestions": "example-querysuggestions",
  "origin": "api",
  "integration": "example-integration"
}'

# POST /search/{jobId}/feedback (Firecrawl API)
Base URL: https://api.firecrawl.dev/v1
Auth: Authorization: Bearer <FIRECRAWL_API_KEY>
Last verified: 2026-10-20

> Submit feedback for a search job

## Critical Gotchas
* The `formats` field controls the output shape and defaults to `["markdown"]`. Omitting it does not return HTML — request `["markdown","html"]` explicitly.
* `/crawl` is asynchronous: it returns a job `id`, and results are collected by polling `/crawl/{id}` until `status` is `completed`.

## cURL
curl -X POST 'https://api.firecrawl.dev/v1/search/example-jobid/feedback' \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"rating":"good","valuableSources":[{}]}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| jobId | path | string | Yes | Search job id returned by /search. |
| rating | body | string | Yes | Request body field rating. |
| valuableSources | body | object[] | No | Request body field valuableSources. |
Other params: valuableResults, missingContent, querySuggestions, origin, integration

## Response (200 OK)
{"success":true,"feedbackId":"00000000-0000-4000-8000-000000000000"}

---
Need an API key? Get one at https://firecrawl.link/ligabazi

POST

POST /search/{jobId}/feedback — Firecrawl API

Firecrawl API

Submit feedback for a search job

Base URL: https://api.firecrawl.dev/v1
Auth: Authorization: Bearer <FIRECRAWL_API_KEY>
Last verified: 2026-10-20 · upstream hash matched

Actions Try in browser→

Agents: curl -H "Accept: text/markdown" this URL
→ 227 tokens · Vary: Accept

Critical gotchas

The formats field controls the output shape and defaults to ["markdown"]. Omitting it does not return HTML — request ["markdown","html"] explicitly.

/crawl is asynchronous: it returns a job id, and results are collected by polling /crawl/{id} until status is completed.

cURL

curl -X POST 'https://api.firecrawl.dev/v1/search/example-jobid/feedback' \  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \  -H 'Content-Type: application/json' \  -d '{  "rating": "good",  "valuableSources": [    {      "url": "https://example.com",      "reason": "example-reason"    }  ],  "valuableResults": [    {      "source": "web",      "position": 0,      "reason": "example-reason"    }  ],  "missingContent": [    {      "topic": "example-topic",      "description": "example-description"    }  ],  "querySuggestions": "example-querysuggestions",  "origin": "api",  "integration": "example-integration"}'

Parameters

Name	In	Type	Required	Description
jobId	path	string	Yes	Search job id returned by /search.
rating	body	string	Yes	Request body field rating.
valuableSources	body	object[]	No	Request body field valuableSources.
valuableResults	body	object[]	No	Results that were useful, each addressed by the `data` group it appears in and its 1-indexed position within that group. Results are returned grouped (`data.web`, `data.images`, `data.news`) and each group is numbered from 1 independently, so `source` is required. List every useful result — unlisted results are treated as not useful. Positions beyond what the group actually returned are ignored. The API stores these as stable search result document IDs for quantitative feedback.
missingContent	body	object[]	No	Request body field missingContent.
querySuggestions	body	string	No	Request body field querySuggestions.
origin	body	string	No	Request body field origin.
integration	body	string	No	Request body field integration.

Response 200 OK

{
  "success": true,
  "feedbackId": "00000000-0000-4000-8000-000000000000",
  "creditsRefunded": 0,
  "alreadySubmitted": true,
  "dailyCapReached": true,
  "creditsRefundedToday": 0,
  "dailyRefundCap": 0,
  "warning": "string"
}

Get a free Firecrawl API key → sponsored

Affiliate link - we may earn a commission, at no extra cost to you.