# Firecrawl Search

Firecrawl

Search public web pages for URLs, titles and snippets.

## Use this tool with your AI agent

1. Copy the prompt
2. Paste it into your agent
3. Tell it what you need

Read https://scrollport.com/start. Use my existing Scrollport connection, or help me connect if needed. Help me use Firecrawl Search (tool ID: firecrawl.web-search). Ask me for the details you need, then show me the result.

**Already connected:** Your agent can use that connection.

**New user:** Your agent will guide you through setup, sign-in and authorisation.

Provider access is included.

Connect your first agent to receive $1 trial credit.

**Job:** [Search the web](https://scrollport.com/tools/web-search-api)

**Current price:** $0.0280/request

**Availability:** Ready to run

## Tool details

**About this tool**

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.

**Inputs and outputs**

### Input

`country` string · optional

Value supplied for country.

`limit` integer · optional

Value supplied for limit.

minimum: 1 · maximum: 100

`query` string · required

Search terms used to find relevant records.

minLength: 1 · maxLength: 500

`tbs` string · optional

Value supplied for tbs.

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

### Output

`limit` number

Returned limit value.

`results` array

Returned results value.

`returned_results` number

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.

---

Canonical page: https://scrollport.com/tools/providers/firecrawl/web-search