# firecrawl.web.search

Web, news or image results by query, with URL and snippet

> Search and optionally scrape search results

Page: https://telipot.com/catalog/tasks/firecrawl.web.search · Markdown: https://telipot.com/catalog/tasks/firecrawl.web.search/md · JSON: https://telipot.com/catalog/tasks/firecrawl.web.search/json

| Field | Value |
| --- | --- |
| provider | [Firecrawl](https://telipot.com/catalog/providers/firecrawl) `firecrawl` |
| capability | [`web.search`](https://telipot.com/catalog/capabilities/web.search) |
| kind | data |
| tier | core |
| price | $0.00076 / result (2 credits / 10 results · docs) |
| settles on | The charge Firecrawl reports in creditsUsed |
| price note | 2 credits per 10 results, rounded up per 10 (1 to 10 results cost 2, 11 to 20 cost 4). Scraping the results costs more and is not offered by this task. |
| identity | Your plan |
| auth | `bearer · Authorization: Bearer` |
| scope | any_account |
| principal | organization |
| required_scopes | none |
| retention | standard |
| route | `POST https://api.firecrawl.dev/v2/search` |
| verification | Not verified yet. Not checked yet. We test with a real request before we mark it. |
| status | live |
| docs | https://docs.firecrawl.dev/api-reference/endpoint/search |

## Preview the price · nothing runs

```bash
telipot run firecrawl.web.search \
  --input-json '{"query":"openrouter","limit":1}' \
  --quote
```

## Run it

```bash
telipot run firecrawl.web.search \
  --input-json '{"query":"openrouter","limit":1}'
```

```bash
curl https://api.telipot.com/v1/tasks/firecrawl.web.search/run \
  -H "Authorization: Bearer $TELIPOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"openrouter","limit":1}'
```

## Input

| Field | In | Type | Required | Constraints | Note |
| --- | --- | --- | --- | --- | --- |
| `query` | body | string | yes | at most 500 | The search query |
| `limit` | body | integer | no | 1 to 100; default 10 | Maximum number of results to return, per source when sources lists several |
| `sources` | body | array | no | default ["web"] | Any of web, news and images, as plain strings. The response holds one array per source. |
| `tbs` | body | string | no |  | Time filter: qdr:h, qdr:d, qdr:w, qdr:m or qdr:y for the past hour, day, week, month or year; cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY for a date range; sbd:1 to sort by date; values combine as sbd:1,qdr:w |
| `location` | body | string | no |  | Where to search from; set the country field too for best results |
| `country` | body | string | no | default "US" | ISO country code to geo-target results |
| `includeDomains` | body | array | no |  | Hostnames only, without protocol or path. Cannot be combined with excludeDomains |
| `excludeDomains` | body | array | no |  | Hostnames only, without protocol or path. Cannot be combined with includeDomains |

## Input schema

```json
{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query",
      "examples": [
        "openrouter"
      ],
      "maxLength": 500
    },
    "limit": {
      "type": "integer",
      "description": "Maximum number of results to return, per source when sources lists several",
      "default": 10,
      "minimum": 1,
      "maximum": 100
    },
    "sources": {
      "type": "array",
      "description": "Any of web, news and images, as plain strings. The response holds one array per source.",
      "default": [
        "web"
      ],
      "examples": [
        [
          "web",
          "news"
        ]
      ]
    },
    "tbs": {
      "type": "string",
      "description": "Time filter: qdr:h, qdr:d, qdr:w, qdr:m or qdr:y for the past hour, day, week, month or year; cdr:1,cd_min:MM/DD/YYYY,cd_max:MM/DD/YYYY for a date range; sbd:1 to sort by date; values combine as sbd:1,qdr:w",
      "examples": [
        "qdr:w"
      ]
    },
    "location": {
      "type": "string",
      "description": "Where to search from; set the country field too for best results",
      "examples": [
        "San Francisco,California,United States"
      ]
    },
    "country": {
      "type": "string",
      "description": "ISO country code to geo-target results",
      "default": "US"
    },
    "includeDomains": {
      "type": "array",
      "description": "Hostnames only, without protocol or path. Cannot be combined with excludeDomains",
      "examples": [
        [
          "docs.firecrawl.dev"
        ]
      ]
    },
    "excludeDomains": {
      "type": "array",
      "description": "Hostnames only, without protocol or path. Cannot be combined with includeDomains",
      "examples": [
        [
          "example.com"
        ]
      ]
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "success",
    "data"
  ],
  "properties": {
    "success": {
      "type": "boolean"
    },
    "id": {
      "type": "string",
      "description": "The ID of the search job"
    },
    "creditsUsed": {
      "type": "integer",
      "description": "Credits the search cost"
    },
    "warning": {
      "type": [
        "string",
        "null"
      ]
    },
    "data": {
      "type": "object",
      "properties": {
        "web": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string",
                "description": "The passages of the page that match the query, or the site's own description when highlights are unavailable"
              },
              "url": {
                "type": "string"
              },
              "position": {
                "type": "integer"
              }
            }
          }
        },
        "news": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "snippet": {
                "type": "string"
              },
              "url": {
                "type": "string"
              },
              "date": {
                "type": "string"
              },
              "imageUrl": {
                "type": "string"
              },
              "position": {
                "type": "integer"
              }
            }
          }
        },
        "images": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "title": {
                "type": "string"
              },
              "imageUrl": {
                "type": "string"
              },
              "imageWidth": {
                "type": "integer"
              },
              "imageHeight": {
                "type": "integer"
              },
              "url": {
                "type": "string"
              },
              "position": {
                "type": "integer"
              }
            }
          }
        }
      }
    }
  }
}
```

## Other tools for this job

- [`exa.web.search`](https://telipot.com/catalog/tasks/exa.web.search) · $0.004–$0.015 / request