Skip to content
telipot
telipot
Join the waitlistSign in

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

Search and optionally scrape search results

Job web.search

Your AI asks

checks the price first
telipot run firecrawl.web.search \
  --input-json '{"query":"openrouter","limit":1}' \
  --quote

Price

$0.00076 / result
Priced· before it runs

firecrawl.web.search

$0.00076 / resultYour plan

Whose account it uses

1The person asking
not needed
2Your company’s Firecrawl plan
Selected identity for this example
3Our account
not used

What it sends

{
  "query": "openrouter",
  "limit": 1
}

Your Firecrawl login is added for you. Your AI never sees it.

What it costs

$0.00076

per result · billed per result

rate2 credits per 10 results, billed per result
sourcedocs · docs.firecrawl.dev/billing · checked 2026-10-05
confidencedocumented
settles onThe charge Firecrawl reports in creditsUsed
note2 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.

Preview the price first. --quote runs nothing.

For developers · run it

Shell · runs the task on the named account

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

query

string · required · at most 500

The search query

limit

integer · 1 to 100 · default 10

Maximum number of results to return, per source when sources lists several

sources

array · default ["web"]

Any of web, news and images, as plain strings. The response holds one array per source.

tbs

string

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

string

Where to search from; set the country field too for best results

country

string · default "US"

ISO country code to geo-target results

includeDomains

array

Hostnames only, without protocol or path. Cannot be combined with excludeDomains

excludeDomains

array

Hostnames only, without protocol or path. Cannot be combined with includeDomains

success

boolean

id

string

The ID of the search job

creditsUsed

integer

Credits the search cost

warning

string | null

data

object

Full output schema · JSONNested fields and constraints

Output JSON Schema

{
  "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"
              }
            }
          }
        }
      }
    }
  }
}

A real answer

No example captured yet: one is recorded when telipot catalog verify passes.