Search

Firecrawl

Search the web for relevant pages, titles and snippets.

Capability: Web search
Current price: $0.0140/10 results
Availability: Ready to run

What this API does

Search public web pages with a query, optional country and recent-time filter. Returns up to 100 URLs with available titles and snippets. Search is billed in blocks of up to ten results: two Firecrawl credits per block. The selected limit bounds the reservation; final billing uses the reported search credits. Result pages are not automatically scraped. Use Scrape for page content.

Agents select this operation with tool ID firecrawl.search, then inspect its current executable contract before a run.

Public input and output shape

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

This reviewed worked example is shared with inspect. Inspect also returns the current executable schema and price estimate before a paid run.

Request

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

Output

{
  "limit": 1,
  "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
}

Teaching 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 Search with Scrollport

Use Scrollport

Scrollport identifies and validates the best-in-class API tools and provides them on a pay-as-you-go basis so you don't need to maintain a separate provider account, subscription or credits.

Give your agent the setup prompt to receive $1 in trial credit and start using the tools right away.