n8n
n8n is a workflow automation platform that lets you connect APIs, build agents, and automate tasks with a visual editor or code. The You.com n8n node brings six operations—web search, content extraction, answer synthesis, research, finance research, and background task management—directly into your n8n workflows, so you can ground AI agents in fresh web data or pipe results into any downstream step.
The @youdotcom-oss/n8n-nodes-youdotcom package provides a single node with six operations: Search, Get Contents, Answer, Research, Finance Research, and Get Research Task. It also works as an AI agent tool, so n8n’s built-in AI agents can call You.com search on demand.
Getting Started
Add the Node
In an n8n workflow, hit + to add a step and search for You.com. Drag the You.com node onto the canvas to start a workflow.
Set Up Credentials
- In n8n, go to Credentials > New Credential and select You.com API
- Paste your API key from you.com/platform
- Click Test to verify the key works
Operations
Search
Get Contents
Answer
Research
Finance Research
Get Research Task
Search the web with the You.com Web Search API. Sends a POST request with a JSON body and returns structured results with titles, URLs, descriptions, and snippets.
Required: query (the search query)
Optional parameters:
Domain filters: Include Domains cannot combine with Exclude Domains or Boost Domains—either pairing returns a 422 at execution time. Exclude Domains and Boost Domains may be combined freely.
Extraction collection: Set extraction_mode to highlights (inline snippets) or full_page (full page content). When full_page is selected, a sub-collection exposes extraction_formats (markdown or html) and extraction_source, which selects where page content comes from. blend (the server default) serves cached content when available and crawls the page live otherwise, cache returns cached content only (pages without cached content are omitted from the results), and fetch always crawls the page live. When Extraction Mode is Highlights, crawl_timeout is omitted from the request body.
Removed parameters: the Livecrawl and Livecrawl Format parameters were removed in v0.7.0. Workflows that still set them must switch to the extraction collection (Full Page mode) to keep receiving full-page content.
Use as an AI Agent Tool
The You.com node has usableAsTool enabled, which means n8n’s built-in AI agents can call it directly. Add the You.com node as a tool in any AI Agent workflow, and the agent will be able to search the web or extract page content on its own.