{
  "url": "https://telipot.com/catalog/tasks/firecrawl.web.search",
  "id": "firecrawl.web.search",
  "name": "Web, news or image results by query, with URL and snippet",
  "provider": {
    "slug": "firecrawl",
    "name": "Firecrawl"
  },
  "capability": "web.search",
  "platform": "web",
  "kind": "data",
  "tier": "core",
  "identity": "key",
  "identityLabel": "Your plan",
  "price": {
    "type": "per_result",
    "confidence": "documented",
    "source": "docs",
    "sourceUrl": "https://docs.firecrawl.dev/billing",
    "checked": "2026-10-05",
    "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.",
    "settles": "The charge Firecrawl reports in creditsUsed",
    "state": "paid",
    "label": "$0.00076 / result",
    "amount": "$0.00076",
    "unit": "result",
    "usdPerUnit": {
      "floor": 0.00076,
      "ceiling": 0.00076
    },
    "native": {
      "text": "2 credits per 10 results",
      "figure": "2 credits",
      "per": "10 results",
      "currency": "credits"
    },
    "detail": "2 credits / 10 results · docs"
  },
  "providers": 2,
  "retention": "standard",
  "runsOn": "byoc",
  "live": true,
  "summary": "Search and optionally scrape search results",
  "method": "POST",
  "path": "/search",
  "host": "https://api.firecrawl.dev/v2",
  "docsUrl": "https://docs.firecrawl.dev/api-reference/endpoint/search",
  "auth": {
    "scheme": "bearer",
    "label": "bearer · Authorization: Bearer",
    "short": "bearer · Authorization"
  },
  "scope": "any_account",
  "principal": "organization",
  "requiredScopes": [],
  "verification": {
    "state": "none",
    "label": "Not verified yet",
    "detail": "Not checked yet. We test with a real request before we mark it."
  },
  "input": [
    {
      "name": "query",
      "location": "body",
      "type": "string",
      "required": true,
      "constraints": [
        "at most 500"
      ],
      "note": "The search query"
    },
    {
      "name": "limit",
      "location": "body",
      "type": "integer",
      "required": false,
      "constraints": [
        "1 to 100",
        "default 10"
      ],
      "note": "Maximum number of results to return, per source when sources lists several"
    },
    {
      "name": "sources",
      "location": "body",
      "type": "array",
      "required": false,
      "constraints": [
        "default [\"web\"]"
      ],
      "note": "Any of web, news and images, as plain strings. The response holds one array per source."
    },
    {
      "name": "tbs",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "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"
    },
    {
      "name": "location",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [],
      "note": "Where to search from; set the country field too for best results"
    },
    {
      "name": "country",
      "location": "body",
      "type": "string",
      "required": false,
      "constraints": [
        "default \"US\""
      ],
      "note": "ISO country code to geo-target results"
    },
    {
      "name": "includeDomains",
      "location": "body",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Hostnames only, without protocol or path. Cannot be combined with excludeDomains"
    },
    {
      "name": "excludeDomains",
      "location": "body",
      "type": "array",
      "required": false,
      "constraints": [],
      "note": "Hostnames only, without protocol or path. Cannot be combined with includeDomains"
    }
  ],
  "sampleInput": {
    "query": "openrouter",
    "limit": 1
  },
  "inputSchema": {
    "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": [
    {
      "name": "success",
      "type": "boolean"
    },
    {
      "name": "id",
      "type": "string",
      "description": "The ID of the search job"
    },
    {
      "name": "creditsUsed",
      "type": "integer",
      "description": "Credits the search cost"
    },
    {
      "name": "warning",
      "type": "string | null"
    },
    {
      "name": "data",
      "type": "object"
    }
  ],
  "outputSchema": {
    "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"
                }
              }
            }
          }
        }
      }
    }
  },
  "commands": {
    "mode": "run",
    "cli": "telipot run firecrawl.web.search \\\n  --input-json '{\"query\":\"openrouter\",\"limit\":1}'",
    "http": "curl https://api.telipot.com/v1/tasks/firecrawl.web.search/run \\\n  -H \"Authorization: Bearer $TELIPOT_TOKEN\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"query\":\"openrouter\",\"limit\":1}'",
    "quote": "telipot run firecrawl.web.search \\\n  --input-json '{\"query\":\"openrouter\",\"limit\":1}' \\\n  --quote"
  },
  "siblings": [
    {
      "id": "exa.web.search",
      "name": "Web pages by query, ranked, with titles, URLs and dates",
      "provider": {
        "slug": "exa",
        "name": "Exa"
      },
      "capability": "web.search",
      "platform": "web",
      "kind": "data",
      "tier": "core",
      "identity": "key",
      "identityLabel": "Your plan",
      "price": {
        "type": "per_call",
        "confidence": "documented",
        "source": "docs",
        "sourceUrl": "https://exa.ai/docs/admin/pricing",
        "checked": "2026-10-05",
        "note": "Base price per request for up to 10 results. Each result above 10 adds $1 per 1,000 results and each AI page summary adds $1 per 1,000 pages, which no row here can carry, so the charge the response reports in costDollars.total is the one to settle on.",
        "settles": "The charge Exa reports in costDollars.total",
        "state": "paid",
        "label": "$0.004–$0.015 / request",
        "amount": "$0.004–$0.015",
        "unit": "request",
        "usdPerUnit": {
          "floor": 0.004,
          "ceiling": 0.015
        },
        "native": {
          "text": "$4 to $15 per 1,000 requests",
          "figure": "$4 to $15",
          "per": "1,000 requests",
          "currency": "USDs"
        },
        "detail": "Exa docs · 2026-10-05"
      },
      "providers": 2,
      "retention": "standard",
      "runsOn": "byoc",
      "live": true
    }
  ]
}