Passer au contenu principal
POST
/
feedback
Envoyer un retour pour une tâche 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>"
}
Utilisez le retour sur le point de terminaison pour indiquer à Firecrawl si le résultat d’une tâche terminée était utile, partiel ou médiocre. Cela concerne la qualité de la sortie au niveau du point de terminaison pour des tâches comme scrape, parse, map et search. Le schéma de retour générique peut aussi inclure des champs propres à la recherche, mais Retour sur la recherche est le point d’entrée spécifique à la recherche à privilégier, car il est associé à un ID de tâche de recherche et met en avant les sources utiles, le contenu manquant, les suggestions de requête et la politique de remboursement.

​
Exemple de requête

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

Autorisations

​
Authorization
string
header
requis

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

Corps

application/json

Envoyer un retour pour une tâche v2. Incluez au moins un signal significatif, comme issues, note, valuableSources, missingContent, querySuggestions, url ou pageNumbers.

​
rating
enum<string>
requis
Options disponibles:
good,
partial,
bad
​
endpoint
enum<string>
requis
Options disponibles:
search,
scrape,
parse,
map
​
jobId
string<uuid>
requis
​
integration
string | null
​
missingContent
object[]
Maximum array length: 20
​
origin
string
défaut: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

Petit objet de métadonnées spécifique au point de terminaison. Il doit faire 8KB maximum ; n’incluez pas les résultats complets du point de terminaison.

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

Réponse

Retour enregistré

​
creditsRefunded
number
requis
​
feedbackId
string<uuid>
requis
​
success
boolean
requis
Exemple:

true

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