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.

• 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