Integrations

n8n

View as MarkdownOpen in Claude

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

1

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.

2

Set Up Credentials

  1. In n8n, go to Credentials > New Credential and select You.com API
  2. Paste your API key from you.com/platform
  3. Click Test to verify the key works

Operations

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:

ParameterDescriptionValues
countMax results per section1–100 (default: 10)
countryGeographical focus36 country codes (US, GB, DE, FR, etc.)
freshnessRecency filterday, week, month, year, or YYYY-MM-DDtoYYYY-MM-DD (via Expression)
safesearchContent moderationoff, moderate, or strict (default: moderate)
languageResult languageBCP 47 codes (default: EN)
offsetPagination offset0–9 (default: 0)
crawl_timeoutCrawl timeout in seconds1–60 (default: 10); omitted when Extraction Mode is Highlights
include_domainsRestrict results to these domainsMulti-string input, up to 500 domains
exclude_domainsExclude results from these domainsMulti-string input, up to 500 domains
boost_domainsPrioritize results from these domainsMulti-string input, up to 500 domains
extractionExtract content inline with search resultsCollection: see below

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). When Extraction Mode is Highlights, crawl_timeout is omitted from the request body.

Deprecated parameters: livecrawl and livecrawl_formats are accepted but deprecated in favor of the extraction collection and will not receive further development.

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.

Resources

GitHub Repository

Source code for the You.com n8n node

npm Package

Package on npm

Web Search API Reference

Full Web Search API parameters and response schema

Contents API Reference

Full Contents API parameters and response schema

Answer API Reference

Full Answer API parameters and response schema

Research API Reference

Full Research API parameters and response schema

Finance Research API Reference

Full Finance Research API parameters and response schema