Ask

Diagnose Firecrawl issues using an AI support agent

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>",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

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

POST

support

ask

Diagnose Firecrawl issues using an AI support agent

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>",
  "fixParameters": {},
  "validation": {
    "tested": true,
    "evidence": "<string>"
  },
  "feedback": {
    "blockedBy": "<string>",
    "attempted": [
      "<string>"
    ]
  },
  "durationMs": 123
}

{
  "error": "<string>"
}

{
  "error": "<string>"
}

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

The /support/ask endpoint is an AI support agent that diagnoses issues with your Firecrawl jobs, account, and API usage. Send a question and receive a verified answer with actionable fix parameters — typically in 15–30 seconds.

Designed for AI agents

/support/ask is built for agent-to-agent communication. If you’re building an AI agent that uses Firecrawl, wire this endpoint into your error-handling flow so your agent can self-diagnose scraping failures, crawl issues, and configuration problems without human intervention. Pass a rationale field to give the support agent context about what your end user is trying to accomplish. This helps prioritize the evidence gathering.

How it works

You describe the problem — a natural-language question describing the issue.
The agent investigates — it inspects job logs, account state, documentation, and source code.
The agent validates — when possible, the agent tests a fix against the live Firecrawl API (e.g., retrying a scrape with adjusted parameters).
You get a verified answer — the response includes a prose answer, machine-readable fixParameters you can apply directly, and validation results showing whether the fix was tested.

Authentication

Uses your Firecrawl API key as the bearer token. The request is automatically scoped to your team — you can only query your own jobs and account data.

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

Response fields

Field	Type	Description
`answer`	string	2-4 sentence prose covering the diagnosis and fix
`confidence`	string	`high`, `medium`, or `low`
`fixParameters`	object \| null	API parameters to apply the fix (e.g., `{"waitFor": 5000}`)
`validation`	object \| null	Whether the fix was tested: `tested`, `result` (success/failure/skipped), `evidence`
`feedback`	object \| null	Present when the agent gets stuck; `{ blockedBy, attempted }`. Null on success.
`durationMs`	integer	Total execution time in milliseconds

Status codes

Code	Meaning
`200`	Answered or stuck (envelope always returned)
`400`	Invalid JSON or schema violation
`401`	Missing or invalid bearer token
`504`	Hit 60s hard budget — partial envelope returned

For the feature guide with integration examples, see the Ask feature documentation.

Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

Authorizations

Authorization

string

header

required

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

Body

application/json

question

string

required

What to diagnose. Describe the issue you're experiencing.

Required string length: 1 - 8000

rationale

string

Recommended for AI callers. 1-2 sentences on what the end user is trying to accomplish.

Required string length: 1 - 2000

jobId

string

Optional Firecrawl job ID the failing call was associated with. Tools like debugJob, searchLogs, and getJob auto-default to this when set, so the agent doesn't need to pull it from the question.

context

object

Free-form metadata from the calling agent, stringified into the diagnostic prompt.

Response

Diagnosis complete. The envelope is returned whether the agent found an answer or got stuck.

requestId

string

Unique identifier for this request.

answer

string

2-4 sentence prose covering what's wrong and the fix.

confidence

enum<string>

Agent's confidence in the diagnosis.

Available options:

high,

medium,

low

fixParameters

object | null

Machine-actionable API parameters to apply the recommended fix. Null if no fix applies.

validation

object | null

Whether the agent tested the fix against the live Firecrawl API.

Show child attributes

feedback

object | null

Present when the agent gets stuck and could not produce a usable answer. Null on success.

Show child attributes

durationMs

integer

Total execution time in milliseconds.

Get Active Crawls

Docs Search

Using the API

Search Endpoints

Scrape Endpoints

Interact Endpoints

Map Endpoints

Parse Endpoints

Crawl Endpoints

Agentic Debugging Endpoints

Account Endpoints

Webhook Payloads

Partner Integration

Designed for AI agents

How it works

Authentication

Response fields

Status codes

Authorizations

Body

Response

​Designed for AI agents

​How it works

​Authentication

​Response fields

​Status codes

Authorizations

Body

Response

Designed for AI agents

How it works

Authentication

Response fields

Status codes