curl -X POST 'https://api.firecrawl.dev/v1/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",
  "endpoint": "search",
  "jobId": "00000000-0000-4000-8000-000000000000",
  "issues": [
    "string"
  ],
  "tags": [
    "string"
  ],
  "note": "string",
  "url": "https://example.com",
  "pageNumbers": [
    0
  ],
  "metadata": {}
}'

# POST /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 v2 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/feedback' \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"rating":"good","valuableSources":[{}]}'

## Parameters
| Name | In | Type | Required | Description |
| :--- | :--- | :--- | :--- | :--- |
| rating | body | string | Yes | Request body field rating. |
| endpoint | body | string | Yes | Request body field endpoint. |
| jobId | body | string | Yes | Request body field jobId. |
| 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

/feedback

Firecrawl API

Submit feedback for a v2 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
→ 233 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/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",  "endpoint": "search",  "jobId": "00000000-0000-4000-8000-000000000000",  "issues": [    "string"  ],  "tags": [    "string"  ],  "note": "string",  "url": "https://example.com",  "pageNumbers": [    0  ],  "metadata": {}}'

Get a free Firecrawl API key → sponsored

Parameters

Name	In	Type	Required	Description
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.
endpoint	body	string	Yes	Request body field endpoint.
jobId	body	string	Yes	Request body field jobId.
issues	body	string[]	No	Request body field issues.
tags	body	string[]	No	Request body field tags.
note	body	string	No	Request body field note.
url	body	string	No	Request body field url.
pageNumbers	body	integer[]	No	Request body field pageNumbers.
metadata	body	object	No	Small endpoint-specific metadata object. Must be 8KB or smaller; do not include full endpoint results.

Response 200 OK

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