Ask

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.

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

​Designed for AI agents

​How it works

​Authentication

​Response fields

​Status codes

Designed for AI agents

How it works

Authentication

Response fields

Status codes