Package Information
Documentation
@youdotcom-oss/n8n-nodes-youdotcom
Add real time web search, page content extraction, and AI powered deep research to your n8n workflows with the You.com API.
n8n is a fair-code licensed workflow automation platform.
Installation | Operations | Credentials | Usage | Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
Search
Search the web and news with up to date results. Supports advanced query operators (site:, filetype:, +, -, AND, OR, NOT) and geographic/language filtering.
Great for monitoring mentions, pulling recent news, or feeding live data into AI agent workflows.
| Parameter | Description |
|---|---|
| Query | The search query (required) |
| Count | Max results per section, 1-100 (default: 10) |
| Country | Two-letter country code to focus results geographically |
| Freshness | Filter by recency: day, week, month, or year |
| Language | BCP 47 language code for results (default: EN) |
| Livecrawl | Fetch full page content for web, news, or all results |
| Livecrawl Format | Format for livecrawled content: markdown or HTML |
| Offset | Pagination offset, 0-9 |
| Safe Search | Content filter: off, moderate, or strict |
Get Contents
Extract clean, structured content from one or more web pages. Returns page text as markdown or HTML, plus metadata like JSON-LD, OpenGraph, and Twitter Cards.
Useful for scraping product pages, pulling article text, or extracting structured data from any URL.
| Parameter | Description |
|---|---|
| URLs | Comma-separated list of URLs to extract (required) |
| Formats | Output formats: markdown, HTML, and/or metadata (JSON-LD, OpenGraph, Twitter Cards) |
| Crawl Timeout | Timeout in seconds for page crawling, 1-60 (default: 30) |
Research
Get a comprehensive, cited answer to a complex question. The Research API searches the web, reads multiple sources, and synthesizes a detailed markdown response with inline numbered citations.
Perfect for competitive analysis, market research, technical due diligence, or any question that needs more than a simple search result.
| Parameter | Description |
|---|---|
| Input | The research question (required) |
| Research Effort | Controls depth and speed (see below, default: standard) |
Research Effort levels:
| Level | Description |
|---|---|
| Lite | Quick answers for straightforward questions |
| Standard | Balanced speed and depth (default) |
| Deep | More time researching and cross-referencing sources |
| Exhaustive | Most thorough option for complex research tasks |
Credentials
- Go to you.com/platform/api-keys to get an API key
- In n8n, go to Credentials and create a new "You.com API" credential
- Paste your API key and save
Usage
- Add the "You.com" node to your workflow
- Select an operation (Search, Get Contents, or Research)
- Configure the parameters for your chosen operation
- Run the workflow
This node also works as a tool for AI agents in n8n. Connect it to an agent node and let the agent decide when to search the web, extract page content, or run deep research.
Resources
- You.com API docs
- Search API reference
- Contents API reference
- Research API reference
- n8n community nodes documentation