The search endpoint combines web search with Firecrawl's scraping capabilities to return full page content for any query.
Include scrapeOptions with formats: [{"type": "markdown"}] to get complete markdown content for each search result otherwise you will default to getting the results (url, title, description). You can also use other formats like {"type": "summary"} for condensed content.
Supported query operators#
We support a variety of query operators that allow you to filter your searches better.
| Operator | Functionality | Examples |
|---|---|---|
"" | Non-fuzzy matches a string of text | "Firecrawl" |
- | Excludes certain keywords or negates other operators | -bad, -site:firecrawl.dev |
site: | Only returns results from a specified website | site:firecrawl.dev |
filetype: | Only returns results with a specific file extension | filetype:pdf, -filetype:pdf |
inurl: | Only returns results that include a word in the URL | inurl:firecrawl |
allinurl: | Only returns results that include multiple words in the URL | allinurl:git firecrawl |
intitle: | Only returns results that include a word in the title of the page | intitle:Firecrawl |
allintitle: | Only returns results that include multiple words in the title of the page | allintitle:firecrawl playground |
related: | Only returns results that are related to a specific domain | related:firecrawl.dev |
imagesize: | Only returns images with exact dimensions | imagesize:1920x1080 |
larger: | Only returns images larger than specified dimensions | larger:1920x1080 |
Location Parameter#
Use the location parameter to get geo-targeted search results. Format: "string". Examples: "Germany", "San Francisco,California,United States".
See the complete list of supported locations for all available countries and languages.
Country Parameter#
Use the country parameter to specify the country for search results using ISO country codes. Default: "US".
Examples: "US", "DE", "FR", "JP", "UK", "CA".
Categories Parameter#
Filter search results by specific categories using the categories parameter:
research: Restrict web search to academic and research websites (arxiv.org, nature.com, ieee.org, pubmed.ncbi.nlm.nih.gov, biorxiv.org, medrxiv.org, and similar). Returns ordinary web page results with snippets — not paper recordspdf: Search for PDFsdeveloper: Search the Developer Index — issues, merged pull requests, and READMEs from public code repositories, alongside curated documentation sites
research is a website filter, not the paper index. It narrows this endpoint's web results to a fixed list of academic domains.
To search scientific literature directly — paper abstracts across PubMed, bioRxiv, medRxiv, and arXiv, plus in-paper passage reads and citation-graph expansion — use the Research Index at GET /search/research/papers.
Example Usage#
Domain Filters#
Use includeDomains to restrict results to specific domains, or excludeDomains to remove specific domains from the search. Domains should be hostnames only, without protocol or path.
includeDomains and excludeDomains are mutually exclusive.
Include Domains Example#
Exclude Domains Example#
Category Response#
Each result includes a category field indicating its source:
Time-Based Search#
Use the tbs parameter to filter results by time periods, including custom date ranges. See the Search Feature documentation for detailed examples and supported formats.
Are you an AI agent that needs a Firecrawl API key? See firecrawl.dev/agent-onboarding/SKILL.md for automated onboarding instructions.

