> ## 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. # Search > Note: A new [v2 version of this API](/api-reference/endpoint/search) is now available with improved features and performance. The search endpoint combines web search with Firecrawl's scraping capabilities to return full page content for any query. Include `scrapeOptions` with `formats: ["markdown"]` to get complete markdown content for each search result otherwise you will default to getting the results (url, title, description). ## 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` | | `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` | ## 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](https://firecrawl.dev/search_locations.json) for all available countries and languages. ## Time-Based Search Use the `tbs` parameter to filter results by time periods, including custom date ranges. See the [Search Feature documentation](https://docs.firecrawl.dev/features/search#time-based-search) for detailed examples and supported formats. ## OpenAPI ````yaml api-reference/v1-openapi.json POST /search openapi: 3.0.0 info: title: Firecrawl API version: v1 description: >- API for interacting with Firecrawl services to perform web scraping and crawling tasks. contact: name: Firecrawl Support url: https://firecrawl.dev/support email: support@firecrawl.dev servers: - url: https://api.firecrawl.dev/v1 security: - bearerAuth: [] paths: /search: post: tags: - Search summary: Search and optionally scrape search results operationId: searchAndScrape requestBody: required: true content: application/json: schema: type: object properties: query: type: string description: The search query limit: type: integer description: Maximum number of results to return default: 5 maximum: 100 minimum: 1 tbs: type: string description: >- Time-based search parameter. Supports predefined time ranges (`qdr:h`, `qdr:d`, `qdr:w`, `qdr:m`, `qdr:y`) and custom date ranges (`cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY`) location: type: string description: Location parameter for search results timeout: type: integer description: Timeout in milliseconds default: 60000 ignoreInvalidURLs: type: boolean description: >- Excludes URLs from the search results that are invalid for other Firecrawl endpoints. This helps reduce errors if you are piping data from search into other Firecrawl API endpoints. default: false scrapeOptions: allOf: - $ref: '#/components/schemas/BaseScrapeOptions' - type: object properties: formats: type: array items: type: string enum: - markdown - html - rawHtml - links - screenshot - screenshot@fullPage - json - extract default: [] description: Options for scraping search results default: {} threatProtection: $ref: '#/components/schemas/ThreatProtectionOverride' required: - query responses: '200': description: Successful response content: application/json: schema: type: object properties: success: type: boolean data: type: array items: type: object properties: title: type: string description: Title from search result description: type: string description: Description from search result url: type: string description: URL of the search result markdown: type: string nullable: true description: Markdown content if scraping was requested html: type: string nullable: true description: HTML content if requested in formats rawHtml: type: string nullable: true description: Raw HTML content if requested in formats links: type: array items: type: string description: Links found if requested in formats screenshot: type: string nullable: true description: >- Screenshot URL if requested in formats. Screenshots expire after 24 hours and can no longer be downloaded. metadata: type: object properties: title: oneOf: - type: string - type: array items: type: string description: >- Title extracted from the page, can be a string or array of strings description: oneOf: - type: string - type: array items: type: string description: >- Description extracted from the page, can be a string or array of strings sourceURL: type: string statusCode: type: integer numPages: type: integer description: >- For PDF inputs, the number of pages parsed (capped by the parsers maxPages option). totalPages: type: integer description: >- For PDF inputs, the document's true page count before any maxPages capping. Omitted when it cannot be determined; a totalPages greater than numPages indicates the result was truncated. error: type: string nullable: true warning: type: string nullable: true description: Warning message if any issues occurred id: type: string description: The ID of the search job '408': description: Request timeout content: application/json: schema: type: object properties: success: type: boolean example: false error: type: string example: Request timed out '500': description: Server error content: application/json: schema: type: object properties: success: type: boolean example: false error: type: string example: An unexpected error occurred on the server. security: - bearerAuth: [] components: schemas: BaseScrapeOptions: type: object properties: onlyMainContent: type: boolean description: >- Only return the main content of the page excluding headers, navs, footers, etc. default: true includeTags: type: array items: type: string description: Tags to include in the output. excludeTags: type: array items: type: string description: Tags to exclude from the output. maxAge: type: integer description: >- Returns a cached version of the page if it is younger than this age in milliseconds. If a cached version of the page is older than this value, the page will be scraped. If you do not need extremely fresh data, enabling this can speed up your scrapes by 500%. Defaults to 0, which disables caching. default: 0 headers: type: object description: >- Headers to send with the request. Can be used to send cookies, user-agent, etc. waitFor: type: integer description: >- Specify a delay in milliseconds before fetching the content, allowing the page sufficient time to load. default: 0 mobile: type: boolean description: >- Set to true if you want to emulate scraping from a mobile device. Useful for testing responsive pages and taking mobile screenshots. default: false skipTlsVerification: type: boolean description: Skip TLS certificate verification when making requests default: false timeout: type: integer description: Timeout in milliseconds for the request default: 30000 parsePDF: type: boolean description: >- Controls how PDF files are processed during scraping. When true, the PDF content is extracted and converted to markdown format, with billing based on the number of pages (1 credit per page). When false, the PDF file is returned in base64 encoding with a flat rate of 1 credit total. default: true jsonOptions: type: object description: JSON options object properties: schema: type: object description: >- The schema to use for the extraction (Optional). Must conform to [JSON Schema](https://json-schema.org/). systemPrompt: type: string description: The system prompt to use for the extraction (Optional) prompt: type: string description: The prompt to use for the extraction without a schema (Optional) actions: type: array description: Actions to perform on the page before grabbing the content items: oneOf: - type: object title: Wait properties: type: type: string enum: - wait description: Wait for a specified amount of milliseconds milliseconds: type: integer minimum: 1 description: Number of milliseconds to wait selector: type: string description: Query selector to find the element by example: '#my-element' required: - type - type: object title: Screenshot properties: type: type: string enum: - screenshot description: >- Take a screenshot. The links will be in the response's `actions.screenshots` array. fullPage: type: boolean description: >- Whether to capture a full-page screenshot or limit to the current viewport. default: false quality: type: integer description: >- The quality of the screenshot, from 1 to 100. 100 is the highest quality. required: - type - type: object title: Click properties: type: type: string enum: - click description: Click on an element selector: type: string description: Query selector to find the element by example: '#load-more-button' all: type: boolean description: >- Clicks all elements matched by the selector, not just the first one. Does not throw an error if no elements match the selector. default: false required: - type - selector - type: object title: Write text properties: type: type: string enum: - write description: >- Write text into an input field, text area, or contenteditable element. Note: You must first focus the element using a 'click' action before writing. The text will be typed character by character to simulate keyboard input. text: type: string description: Text to type example: Hello, world! required: - type - text - type: object title: Press a key description: >- Press a key on the page. See https://asawicki.info/nosense/doc/devices/keyboard/key_codes.html for key codes. properties: type: type: string enum: - press description: Press a key on the page key: type: string description: Key to press example: Enter required: - type - key - type: object title: Scroll properties: type: type: string enum: - scroll description: Scroll the page or a specific element direction: type: string enum: - up - down description: Direction to scroll default: down selector: type: string description: Query selector for the element to scroll example: '#my-element' required: - type - type: object title: Scrape properties: type: type: string enum: - scrape description: >- Scrape the current page content, returns the url and the html. required: - type - type: object title: Execute JavaScript properties: type: type: string enum: - executeJavascript description: Execute JavaScript code on the page script: type: string description: JavaScript code to execute example: document.querySelector('.button').click(); required: - type - script - type: object title: Generate PDF properties: type: type: string enum: - pdf description: >- Generate a PDF of the current page. The PDF will be returned in the `actions.pdfs` array of the response. format: type: string enum: - A0 - A1 - A2 - A3 - A4 - A5 - A6 - Letter - Legal - Tabloid - Ledger description: The page size of the resulting PDF default: Letter landscape: type: boolean description: Whether to generate the PDF in landscape orientation default: false scale: type: number description: The scale multiplier of the resulting PDF default: 1 required: - type location: type: object description: >- Location settings for the request. When specified, this will use an appropriate proxy if available and emulate the corresponding language and timezone settings. Defaults to 'US' if not specified. properties: country: type: string description: ISO 3166-1 alpha-2 country code (e.g., 'US', 'AU', 'DE', 'JP') pattern: ^[A-Z]{2}$ default: US languages: type: array description: >- Preferred languages and locales for the request in order of priority. Defaults to the language of the specified location. See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language items: type: string example: en-US removeBase64Images: type: boolean description: >- Removes all base 64 images from the output, which may be overwhelmingly long. The image's alt text remains in the output, but the URL is replaced with a placeholder. default: true blockAds: type: boolean description: Enables ad-blocking and cookie popup blocking. default: true proxy: type: string enum: - basic - enhanced - auto description: |- Specifies the type of proxy to use. - **basic**: Proxies for scraping sites with none to basic anti-bot solutions. Fast and usually works. - **enhanced**: Enhanced proxies for scraping sites with advanced anti-bot solutions. Slower, but more reliable on certain sites. Costs up to 5 credits per request. - **auto**: Firecrawl will automatically retry scraping with enhanced proxies if the basic proxy fails. If the retry with enhanced is successful, 5 credits will be billed for the scrape. If the first attempt with basic is successful, only the regular cost will be billed. If you do not specify a proxy, Firecrawl will default to basic. storeInCache: type: boolean description: >- If true, the page will be stored in the Firecrawl index and cache. Setting this to false is useful if your scraping activity may have data protection concerns. Using some parameters associated with sensitive scraping (actions, headers) will force this parameter to be false. default: true threatProtection: $ref: '#/components/schemas/ThreatProtectionOverride' ThreatProtectionOverride: type: object title: Threat Protection Override description: >- Per-request [Threat Protection](https://docs.firecrawl.dev/features/threat-protection) override. Fields you provide replace the corresponding fields of your organization's policy for this request only; omitted fields keep their organization-level values. Requires Threat Protection to be enabled for your team (enterprise feature) — otherwise the request is rejected with a 403. If your organization has disabled request overrides, any request that includes this object is rejected with a 403. If Threat Protection is enforced for your team, `mode` may not be set to `off`. properties: mode: type: string enum: - 'off' - normal description: >- Domain scanning mode for this request. `normal` checks domains against Google Web Risk (+2 credits per domain scanned). riskScoreThreshold: type: integer minimum: 0 maximum: 100 description: >- Normalized risk score (0–100) at or above which a classifier verdict blocks the domain. Lower is stricter. example: 75 blacklist: type: array maxItems: 1000 items: type: string description: >- Domains to always block, as plain domains (`example.com`) or wildcard globs (`*.example.com`). No protocol, path, or port. whitelist: type: array maxItems: 1000 items: type: string description: >- Domains to always allow, as plain domains or wildcard globs. Wins over every other rule. blockedTlds: type: array maxItems: 1000 items: type: string description: >- Top-level domains to block outright, lowercase without the leading dot (e.g. `zip`). failurePolicy: type: string enum: - open - closed description: >- What to do when the classifier can't be reached: `closed` blocks the request, `open` allows it. securitySchemes: bearerAuth: type: http scheme: bearer ````