Search Web
Search the web and get results with optional full content scraping. Supports web, news, and image search with query operators (site:, filetype:, exact phrases). Returns titles, descriptions, and URLs, with optional markdown content. Ideal for: web research, content discovery, competitive analysis, finding documentation, building RAG datasets.
Catalog action Integrations
Search the web and get results with optional full content scraping. Supports web, news, and image search with query operators (site:, filetype:, exact phrases). Returns titles, descriptions, and URLs, with optional markdown content. Ideal for: web research, content discovery, competitive analysis, finding documentation, building RAG datasets.
At a Glance
| Field | Value |
|---|---|
| Action ID | firecrawl-search-web |
| Category | Integrations |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | firecrawl, search, web, research, discovery, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query. Supports operators: "exact phrase", -exclude, site:domain.com, filetype:pdf, inurl:, intitle: |
limit | number | No | Maximum number of results to return. Range: 1-100. Default: 5 |
sources | array | No | Search sources to use. Options: 'web', 'images', 'news'. Default: ['web'] |
categories | array | No | Filter results by category. Options: 'github', 'research', 'pdf'. Default: no filter |
country | string | No | ISO country code for geographic targeting (e.g., 'US', 'GB', 'DE'). Default: 'US' |
timeFilter | string | No | Filter results by recency. Options: 'day'/'24h', 'week'/'7d', 'month'/'30d', 'year'/'365d'. No default (all time). |
scrapeContent | boolean | No | Whether to scrape and return full markdown content from search results. Adds +1 credit per page scraped. Default: false |
timeout | number | No | Request timeout in milliseconds. Default: 60000 (60 seconds). |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Yes | Whether the search request was successful |
id | string | No | Job identifier for the search request |
data | object | Yes | - |
warning | string | No | Warning message if any issues occurred |
creditsUsed | number | No | Number of API credits consumed |
Examples
json{ "type": "firecrawl-search-web", "payload": { "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/firecrawl-search-web/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "query": "status:open" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.