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": "string"
    }
  ],
  "missingContent": [
    {
      "topic": "string",
      "description": "string"
    }
  ],
  "querySuggestions": "string",
  "origin": "api",
  "integration": "string"
}'

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

> 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. |

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

---
Need an API key? Get one at https://www.firecrawl.dev/signin/signup

POST

/search/{jobId}/feedback

Firecrawl API

Submit feedback for a search job

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

Actions

Agents: curl -H "Accept: text/markdown" this URL
→ 218 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": "string"    }  ],  "missingContent": [    {      "topic": "string",      "description": "string"    }  ],  "querySuggestions": "string",  "origin": "api",  "integration": "string"}'

Get a free Firecrawl API key → sponsored

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