Use this when you need current or specific information from the web: recent events, latest releases and versions, prices, people and companies, statistics, or any fact that may have changed since your training data or that you are not sure of. Returns ranked results with query-relevant highlights; each web result is a title, URL, and description. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. `includeDomains` and `excludeDomains` are mutually exclusive hostname filters; categories limit result types to `research`, `pdf`, `developer`, or `gov`.
For a programming question, add `categories: ["developer"]`. It searches an index of public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation, and returns the results in `data.web` with `category: "developer"`.
For a legal or regulatory question, `categories: ["gov"]` returns results in `data.web` with `category: "gov"` and cannot be combined with other categories; authenticated sessions also have `firecrawl_gov_search` as the dedicated tool. Verify gov results' issuer, jurisdiction, status, and version before citing current law.
Authenticated search combines web results, semantic tool summaries and domain matches. Use sources: ["alexandria"] for semantic tools only. Authenticated searches always add alexandria to the sources, so sources: ["web"] also returns providers; domainTools: false turns off website-matched tools only. On an authenticated session, tool matches describe available structured-data capabilities, not executed data. toolDetail: "compact" (default) returns only provider, capability and description; "summary" adds metadata; "full" includes their input and output contracts. alexandria_library_read runs a selected capability; alexandria_library_search explores the whole library and reads full contracts.
Returns result groups in `data` and an operation `id`.
View input schema
{
"type": "object",
"properties": {
"toolDetail": {
"description": "Compact by default. Compact returns only provider, capability and description; full includes contracts. Read a selected tool's contract with alexandria_library_search.",
"type": "string",
"enum": [
"compact",
"summary",
"full"
]
},
"query": {
"description": "Query for web and semantic tool discovery. Operators include quoted phrases, `-term`, `site:host`, `inurl:term`, `intitle:term`, and `related:host`; the set is non-exhaustive. Browse the whole library with alexandria_library_search.",
"type": "string",
"minLength": 1
},
"domainTools": {
"description": "Include domain-matched tools for result URLs. Defaults to true when Alexandria is combined with web, news or images; semantic-only search leaves domain matching off.",
"type": "boolean"
},
"highlights": {
"description": "Return query-relevant page excerpts for web and news results when available (default). Highlights appear in web `description` and news `snippet`; otherwise, original snippets are returned. Set to false to keep the original search snippets.",
"type": "boolean"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"tbs": {
"type": "string"
},
"filter": {
"type": "string"
},
"location": {
"type": "string"
},
"includeDomains": {
"description": "Hostnames to restrict results to. Mutually exclusive with excludeDomains.",
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 253,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$"
}
},
"excludeDomains": {
"description": "Hostnames to leave out of results. Mutually exclusive with includeDomains.",
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 253,
"pattern": "^(?:[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\\.)+[a-z0-9][a-z0-9-]{0,61}[a-z0-9]$"
}
},
"sources": {
"description": "Search sources; authenticated sessions default to web + alexandria, keyless sessions to web only. Authenticated searches always add alexandria to the sources, so sources: [\"web\"] also returns providers; domainTools: false turns off website-matched tools only. enterprise zdr or anon searches do not add it. Use [\"alexandria\"] alone for provider discovery without web results.",
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
]
},
{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"web",
"images",
"news",
"alexandria",
"exchange"
]
}
},
"required": [
"type"
],
"additionalProperties": false
}
]
}
},
"categories": {
"description": "Limit results to specific source types. `research` restricts ordinary web results to research-affiliated websites and returns page snippets, which is separate from the `firecrawl_research_*` tools that search paper abstracts and full text across biomedical (PubMed, bioRxiv, medRxiv) and arXiv literature; `pdf` searches PDF results; `developer` searches an index built for coding agents over public repositories, GitHub issues, merged pull requests, repository READMEs, and code documentation; `gov` searches the Government Index of US federal, state, and local legal and regulatory sources, the index behind firecrawl_gov_search, and cannot be combined with other categories; gov hits can include historical versions, bill text, agency guidance, and third-party reproductions, so verify the issuer, jurisdiction, enacted/effective status, and version before citing current governing law, clarify a missing jurisdiction or ambiguous as-of date, and use general search for non-US questions or missing coverage (no hits does not establish that no applicable law exists). `developer` and `gov` return hits in `data.web` with `category` set to their name; the other categories also filter `data.web`.",
"type": "array",
"items": {
"type": "string",
"enum": [
"research",
"pdf",
"developer",
"gov"
]
}
},
"enterprise": {
"type": "array",
"items": {
"type": "string",
"enum": [
"default",
"anon",
"zdr"
]
}
},
"scrapeOptions": {
"description": "Fetches the full page of every web result in the same call, and each fetched result is billed as a scrape. Leave it unset unless the task needs the full text of a few results: highlights usually answer, and firecrawl_scrape can fetch only the URLs you need. These fetches ignore maxAge, so use firecrawl_scrape for a live fetch. scrapeOptions fetches web pages, never Alexandria provider tools.",
"type": "object",
"properties": {
"formats": {
"type": "array",
"items": {
"type": "string",
"enum": [
"markdown",
"html",
"rawHtml",
"screenshot",
"links",
"images",
"summary",
"changeTracking",
"branding",
"json",
"query",
"audio"
]
}
},
"jsonOptions": {
"type": "object",
"properties": {
"prompt": {
"type": "string"
},
"schema": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": true
}
},
"additionalProperties": false
},
"queryOptions": {
"type": "object",
"properties": {
"prompt": {
"type": "string",
"maxLength": 10000
},
"mode": {
"default": "freeform",
"type": "string",
"enum": [
"directQuote",
"freeform"
]
}
},
"required": [
"prompt"
],
"additionalProperties": false
},
"screenshotOptions": {
"type": "object",
"properties": {
"fullPage": {
"type": "boolean"
},
"quality": {
"type": "number"
},
"viewport": {
"type": "object",
"properties": {
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"required": [
"width",
"height"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"parsers": {
"type": "array",
"items": {
"type": "string",
"enum": [
"pdf"
]
}
},
"pdfOptions": {
"type": "object",
"properties": {
"maxPages": {
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"additionalProperties": false
},
"onlyMainContent": {
"type": "boolean"
},
"redactPII": {
"type": "boolean"
},
"includeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"excludeTags": {
"type": "array",
"items": {
"type": "string"
}
},
"waitFor": {
"type": "number"
},
"mobile": {
"type": "boolean"
},
"skipTlsVerification": {
"type": "boolean"
},
"removeBase64Images": {
"type": "boolean"
},
"location": {
"type": "object",
"properties": {
"country": {
"type": "string"
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"storeInCache": {
"type": "boolean"
},
"maxAge": {
"type": "number"
},
"lockdown": {
"type": "boolean"
},
"proxy": {
"type": "string",
"enum": [
"basic",
"stealth",
"enhanced",
"auto"
]
},
"profile": {
"description": "Loads a saved browser profile without saving changes to it.",
"type": "object",
"properties": {
"name": {
"type": "string"
}
},
"required": [
"name"
],
"additionalProperties": false
}
},
"additionalProperties": false
},
"objective": {
"description": "The user's underlying goal for this call, in one sentence: what they are ultimately trying to accomplish, not a restatement of the URL or query. Reuse it across related calls. Avoid sensitive information.",
"type": "string",
"minLength": 1,
"maxLength": 5000
},
"conversationId": {
"description": "conversationId from any earlier Firecrawl tool result in this conversation; after parallel calls, any one of theirs. Omit only on the first call of a conversation; the result returns one to pass on every later call.",
"type": "string",
"pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}$"
}
},
"required": [
"query",
"objective"
],
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false
}