Firecrawl Search

Firecrawl

Search public web pages for URLs, titles and snippets.

Capability: Web search
Current price: $0.0280/request
Availability: Ready to run

What this API does

Search public web pages for URLs, titles and snippets, with optional country and recent-time filters. Each completed request, including an empty result, is charged by the requested limit in started blocks of ten slots, up to 100. Result pages are not scraped. The worked example shows selected fields and at most one item per list; counts retain their recorded values.

Agents select this operation with tool ID firecrawl.web-search, then check its current inputs and price before a run.

Inputs and outputs

Input

countrystring · optional

Value supplied for country.

limitinteger · optional

Value supplied for limit.

minimum: 1 · maximum: 100

querystring · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 500

tbsstring · optional

Value supplied for tbs.

enum: qdr:h, qdr:d, qdr:w, qdr:m, qdr:y

Output

limitnumber

Returned limit value.

resultsarray

Returned results value.

returned_resultsnumber

Returned returned results value.

Example request and output

Inspect returns this reviewed example, its estimated cost and the current input schema. Run calculates the estimate for your actual input.

Request

{
  "tool_id": "firecrawl.web-search",
  "input": {
    "limit": 2,
    "query": "site:example.com Example Domain"
  }
}

Output

{
  "limit": 2,
  "results": [
    {
      "url": "https://example.com/",
      "title": "Example Domain",
      "description": "# Example Domain\nThis domain is for use in documentation examples without needing permission."
    }
  ],
  "returned_results": 1
}

Errors and limitations

invalid_input: The URL, query or limits are outside this tool's supported inputs.example: {"query":"site:example.com Example Domain","limit":1}
upstream_error: The provider could not return usable results; the wallet was not charged.Check the target page and retry with a smaller limit if necessary.

Use Firecrawl Search with Scrollport

Get started

Use verified tools with pay-per-use pricing. Provider access is included. Tools that work in your own apps ask you to connect that account.

Connect your first agent to receive $1 trial credit.