Skip to main content
POST
/
support
/
docs-search
Search Firecrawl documentation using AI
curl --request POST \
  --url https://api.firecrawl.dev/v2/support/docs-search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "question": "<string>"
}
'
{
  "requestId": "<string>",
  "answer": "<string>",
  "evidence": [
    {
      "pathOrUrl": "<string>",
      "reason": "<string>"
    }
  ],
  "usage": {
    "inputTokens": 123,
    "outputTokens": 123,
    "totalTokens": 123
  },
  "durationMs": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt

Use this file to discover all available pages before exploring further.

The /support/docs-search endpoint answers questions using Firecrawl’s public documentation. Requires your Firecrawl API key. Returns a concise, docs-grounded answer with citations to the relevant documentation pages.

​
Use cases

  • AI agents that need to look up Firecrawl API usage, parameters, or best practices
  • Support bots that answer customer questions from the docs
  • Developer tools that surface relevant documentation inline

​
Example

curl -X POST https://api.firecrawl.dev/v2/support/docs-search \
  -H "Authorization: Bearer fc-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "what header carries the webhook signature, and how do I verify it?"
  }'

​
Response

{
  "requestId": "req_...",
  "answer": "The signature is sent in the X-Firecrawl-Signature header...",
  "evidence": [
    {
      "pathOrUrl": "webhooks/security.mdx#L1-L52",
      "reason": "Documents webhook signature verification"
    }
  ],
  "usage": { "inputTokens": 4356, "outputTokens": 688, "totalTokens": 5044 },
  "durationMs": 11252
}

​
Response fields

FieldTypeDescription
answerstringConcise answer grounded in Firecrawl documentation
evidencearrayDocumentation pages referenced, with pathOrUrl and reason
usageobjectToken consumption (inputTokens, outputTokens, totalTokens)
durationMsintegerTotal execution time in milliseconds
For the full feature guide, 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

The question to answer from Firecrawl's public documentation.

Required string length: 1 - 8000

Response

Docs-grounded answer returned successfully.

​
requestId
string

Unique identifier for this request.

​
answer
string

Concise answer grounded in Firecrawl's public documentation.

​
evidence
object[]

Documentation pages referenced in the answer.

​
usage
object
​
durationMs
integer

Total execution time in milliseconds.