# Web Search

The **Web Search Node** allows you to search the web for information and retrieve a list of relevant results. It is highly configurable, letting you tailor the search to specific countries, languages, devices, and more.

#### Web Search

* **Purpose:** Search the web for any query and return a list of results, including URLs, titles, and content snippets, you may also include or exclude domains when specified.
* **Provider:** websearch

**Input Parameters**

* **query** (required): The search terms you want to look up on the web.
* **num** (optional, default 5): How many search results to retrieve.
* **location** (optional, default "US"): The geographic location to use for location-based search results (e.g., "US", "GB", "IN", etc.).
* **device** (optional, default "desktop"): Simulate search results as seen on "desktop" or "mobile" devices.
* **gl** (optional, default "US"): Which country’s search engine to use for results.
* **hl** (optional, default "en"): The language for search results and interface (e.g., "en" for English, "fr" for French, etc.).

**Output**

* **search\_results**: An array of results, each containing:
  * **url**: The web address of the result.
  * **title**: The title of the webpage (may be null if unavailable).
  * **text**: The content snippet or extracted content from the page.
  * **favicon**: The favicon of the website (may be null if unavailable).

***

### Other Actions Available in the Web Search Provider

Besides the standard web search, the websearch provider also offers these actions:

1. **Job Search**: Search for job listings on the web.
2. **Get Markdown**: Retrieve web content and convert it to markdown format.
3. **News Search**: Search for news articles.
4. **Deep Research**: Perform a more in-depth research query, often returning more comprehensive or summarized results.

Each of these actions has its own specific input and output parameters, but all are designed to help you retrieve and process information from the web in different formats or for different use cases.

***

#### Summary Table

| Action Name   | Description                         | Typical Use Case                        |
| ------------- | ----------------------------------- | --------------------------------------- |
| Web Search    | General web search for any query    | Find websites, articles, or info        |
| Job Search    | Search for job listings             | Find open positions on the web          |
| Get Markdown  | Convert web content to markdown     | Extract readable content for processing |
| News Search   | Search for news articles            | Track news on a topic or company        |
| Deep Research | In-depth research and summarization | Get comprehensive answers or summaries  |