Ask

Diagnostique problemas do Firecrawl usando um agente de suporte com IA

curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>",
  "jobId": "<string>",
  "context": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

POST

support

ask

Diagnostique problemas do Firecrawl usando um agente de suporte com IA

curl --request POST \
  --url https://api.firecrawl.dev/v2/support/ask \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>",
  "rationale": "<string>",
  "jobId": "<string>",
  "context": {}
}
'

import requests

url = "https://api.firecrawl.dev/v2/support/ask"

payload = {
    "question": "<string>",
    "rationale": "<string>",
    "jobId": "<string>",
    "context": {}
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({question: '<string>', rationale: '<string>', jobId: '<string>', context: {}})
};

fetch('https://api.firecrawl.dev/v2/support/ask', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.firecrawl.dev/v2/support/ask",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'question' => '<string>',
    'rationale' => '<string>',
    'jobId' => '<string>',
    'context' => [
        
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.firecrawl.dev/v2/support/ask"

	payload := strings.NewReader("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.firecrawl.dev/v2/support/ask")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.firecrawl.dev/v2/support/ask")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"question\": \"<string>\",\n  \"rationale\": \"<string>\",\n  \"jobId\": \"<string>\",\n  \"context\": {}\n}"

response = http.request(request)
puts response.read_body

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

{
  "requestId": "<string>",
  "answer": "<string>",
  "confidence": "high",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "result": "success",
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

O endpoint /support/ask é um agente de suporte com IA que diagnostica problemas nos seus jobs do Firecrawl, na sua conta e no uso da API. Envie uma pergunta e receba uma resposta verificada com parâmetros práticos para correção — normalmente em 15–30 segundos.

Desenvolvido para agentes de IA

/support/ask foi criado para comunicação de agente para agente. Se você estiver criando um agente de IA que usa o Firecrawl, conecte esse endpoint ao seu fluxo de tratamento de erros para que seu agente possa diagnosticar por conta própria falhas de scraping, problemas de rastreamento e problemas de configuração sem intervenção humana. Passe um campo rationale para dar contexto ao agente de suporte sobre o que seu usuário final está tentando fazer. Isso ajuda a priorizar a coleta de evidências.

Como funciona

Você descreve o problema — uma pergunta em linguagem natural que descreve o problema.
O agente investiga — ele inspeciona logs de job, o estado da conta, a documentação e o código-fonte.
O agente valida — quando possível, o agente testa uma correção na API Firecrawl em produção (por exemplo, repetindo um scraping com parâmetros ajustados).
Você recebe uma resposta verificada — a resposta inclui um answer em texto explicativo, fixParameters legíveis por máquina que você pode aplicar diretamente e resultados de validation mostrando se a correção foi testada.

Autenticação

Usa sua chave de API do Firecrawl como token Bearer. A solicitação é automaticamente restrita à sua equipe — você só pode consultar seus próprios jobs e os dados da sua conta.

curl -X POST https://api.firecrawl.dev/v2/support/ask \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "my crawl returned 3 pages but I expected 50",
    "rationale": "user is on their third failed crawl attempt today"
  }'

Campos da resposta

Campo	Tipo	Descrição
`answer`	string	Texto em prosa de 2 a 4 frases com o diagnóstico e a correção
`confidence`	string	`high`, `medium` ou `low`
`fixParameters`	object	null	Parâmetros da API para aplicar a correção (por exemplo, `{"waitFor": 5000}`)
`validation`	object	null	Indica se a correção foi testada: `tested`, `result` (success/failure/skipped), `evidence`
`feedback`	object	null	Presente quando o agente fica bloqueado; `{ blockedBy, attempted }`. Nulo em caso de sucesso.
`durationMs`	integer	Tempo total de execução em milissegundos

Códigos de status

Código	Significado
`200`	Respondido ou travado (o envelope é sempre retornado)
`400`	JSON inválido ou violação de esquema
`401`	Token Bearer ausente ou inválido
`504`	Atingiu o limite rígido de 60 s — envelope parcial retornado

Para ver o guia da funcionalidade com exemplos de integração, consulte a documentação da funcionalidade Ask.

Você é um agente de IA que precisa de uma chave de API do Firecrawl? Consulte firecrawl.dev/agent-onboarding/SKILL.md para instruções de onboarding automatizado.

Autorizações

Authorization

string

header

obrigatório

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

Corpo

application/json

question

string

obrigatório

O que diagnosticar. Descreva o problema que você está enfrentando.

Required string length: 1 - 8000

rationale

string

Recomendado para chamadores de IA. Escreva de 1 a 2 frases sobre o que o usuário final está tentando fazer.

Required string length: 1 - 2000

jobId

string

ID do job opcional do Firecrawl ao qual a chamada com falha estava associada. Ferramentas como debugJob, searchLogs e getJob usam esse valor automaticamente como padrão quando ele é definido, para que o agente não precise extraí-lo da pergunta.

context

object

Metadados em formato livre do agente chamador, convertidos em string no prompt de diagnóstico.

Resposta

Diagnóstico concluído. O envelope é retornado independentemente de o agente encontrar uma resposta ou ficar travado.

requestId

string

Identificador único desta solicitação.

answer

string

Texto corrido de 2 a 4 frases explicando o problema e a correção.

confidence

enum<string>

Nível de confiança do agente no diagnóstico.

Opções disponíveis:

high,

medium,

low

fixParameters

object | null

Parâmetros de API acionáveis por máquina para aplicar a correção recomendada. Null se nenhuma correção se aplicar.

validation

object | null

Indica se o agente testou a correção na API do Firecrawl em produção.

Show child attributes

feedback

object | null

Presente quando o agente fica travado e não consegue produzir uma resposta utilizável. Null em caso de sucesso.

Show child attributes

durationMs

integer

Tempo total de execução em milissegundos.

Usando a API

Endpoints de busca

Endpoints /scrape

Endpoints de interação

Endpoints de map

Endpoints de Parse

Endpoints de Rastreamento

Endpoints de depuração de agentes

Endpoints da conta

Payloads de webhook

Integração de parceiro

Desenvolvido para agentes de IA

Como funciona

Autenticação

Campos da resposta

Códigos de status

Autorizações

Corpo

Resposta

​Desenvolvido para agentes de IA

​Como funciona

​Autenticação

​Campos da resposta

​Códigos de status

Autorizações

Corpo

Resposta

Desenvolvido para agentes de IA

Como funciona

Autenticação

Campos da resposta

Códigos de status