n8n-nodes-linkup-so

This is an n8n community node that integrates the Linkup API into your n8n workflows. Linkup is a web search engine designed specifically for AI applications, providing reliable and factual grounding data for LLMs.

n8n is a fair-code licensed workflow automation platform.

Table of Contents:

• Installation
• Operations
• Credentials
• Compatibility
• Resources

Installation

Follow the installation guide in the n8n community nodes documentation.

Community nodes are installed from npm. The package name is: n8n-nodes-linkup-so

Operations

This node provides four main resources for interacting with the Linkup API:

Search

Perform web searches and retrieve context for AI grounding. The search operation returns relevant web content that can be used to ground your AI responses with factual information.

Configuration Options:

• Query (required): Your natural language search question
• Depth (required): Choose search precision level
  • Fast: Sub-second search optimized for simple, focused queries (beta)
  • Standard: Fast search for straightforward queries
  • Deep: Comprehensive search for complex queries requiring detailed analysis
• Output Type (required): Select the response format
  • Sourced Answer: Returns a concise answer with source citations
  • Search Results: Returns a list of relevant documents
  • Structured: Returns data according to a custom JSON schema you define

Optional Filters:

• Date range filtering (from/to dates)
• Domain inclusion/exclusion lists
• Include images in results
• Inline citations (for sourced answers)
• Include sources (for structured output)

Fetch

Fetch and convert any webpage to markdown format. This operation retrieves webpage content and converts it to clean, structured markdown.

Configuration Options:

• URL (required): The webpage URL you want to fetch
• Render JavaScript (optional): Enable JavaScript rendering for dynamic content
• Extract Images (optional): Extract and include image references from the page
• Include Raw HTML (optional): Include the original HTML alongside the markdown

Research

Run an asynchronous, deep research task. Unlike Search, the Research API kicks off a long-running job that performs comprehensive web research and is retrieved separately once it completes. Three operations are exposed so you (or an AI agent) can manage the task lifecycle:

Start

Kicks off a new research task. Returns a task id and an initial status (pending).

Configuration Options:

• Query (required): Your natural language research question
• Output Type (required):
  • Sourced Answer: Returns a concise answer with source citations
  • Structured: Returns data according to a custom JSON schema you define
• Mode (optional, default Auto):
  • Answer: Direct answer for simple questions
  • Auto: Agent auto-classifies per request
  • Investigate: Investigative mode for deeper analysis
  • Research: Full research mode for comprehensive results
• Reasoning Depth (optional, default L):
  • S: Fastest, least thorough
  • M: Balanced speed and depth
  • L: Default depth, thorough
  • XL: Most thorough, highest latency
• Structured Output Schema (required when Output Type is Structured): JSON schema defining the response shape

Optional Filters:

• Date range filtering (from/to dates)
• Domain inclusion (up to 100) / exclusion lists
• Include images in results

Get

Retrieves a research task by its id. Use this to poll until status is completed (or failed) and read the final output.

Configuration Options:

• Task ID (required): The identifier returned by the Start operation

Get Many

Lists research tasks for your organization, with pagination and sorting.

Configuration Options:

• Limit: Max number of results per page (default 50, max 100)
• Page: Page number (1-indexed)
• Sort By: createdAt or updatedAt
• Sort Direction: asc or desc

Polling pattern. Because Research is asynchronous, the typical workflow is Start → Wait → Get → IF status == completed. Loop the Wait/Get until the task completes, then continue with the output. AI agents can do the same by calling the Get tool again later instead of blocking.

Task

Create and manage asynchronous batch tasks via the unified /v1/tasks endpoint. A task wraps any of the three operation types (search, fetch, research) in an async job that you can poll for results. This is useful when you want to fire-and-forget, or when working with long-running operations.

Create

Creates an asynchronous task. You select the task type (search, fetch, or research) and configure the same parameters as the corresponding resource. Returns a task id and initial status (pending).

Configuration Options:

• Task Type (required): Choose Search, Fetch, or Research
• All parameters from the selected type are available (query, depth, output type, URL, mode, reasoning depth, etc.)
• The same optional filters apply depending on the task type

Get

Retrieves a task by its id. Use this to poll until status is completed (or failed) and read the final output.

Configuration Options:

• Task ID (required): The identifier returned by the Create operation

Get Many

Lists tasks for your organization, with pagination, sorting, and filtering.

Configuration Options:

• Limit: Max number of results per page (default 50, max 100)
• Page: Page number (1-indexed)
• Sort By: createdAt or updatedAt
• Sort Direction: asc or desc
• Status: Filter by pending, processing, completed, or failed
• Type: Filter by search, fetch, or research

Polling pattern. The typical workflow is Create → Wait → Get → IF status == completed. Loop the Wait/Get until the task completes, then continue with the output.

Credentials

This node uses API key authentication to connect to the Linkup API.

Getting Your API Key

1. Create a free account at https://app.linkup.so
2. Navigate to your account settings or API section
3. Generate or copy your API key
4. In n8n, create a new Linkup API credential
5. Paste your API key into the credential field

Note: When you test your credentials in n8n, the node verifies your API key by checking your account balance. This validation does not consume any credits.

API Key Security

• Your API key is stored securely by n8n
• The key is transmitted using Bearer token authentication
• Never share your API key or commit it to version control

For more information on obtaining and managing your API key, refer to the Linkup quickstart guide.

Compatibility

• Minimum n8n version: 1.60.0 or later
• n8n API version: 1 (declarative routing)

Usage Tips

Choosing a Depth

• Use fast for simple, focused queries when latency matters
• Use standard for most everyday queries
• Reserve deep searches for complex questions requiring comprehensive analysis

Search Output Types

• Sourced Answer: Best for getting quick, factual answers with citations
• Search Results: Best for gathering multiple sources for further processing
• Structured: Best when you need data in a specific format for downstream integrations

Search vs. Research

• Use Search when you need a synchronous answer in seconds (one node, one response).
• Use Research for in-depth investigations where it's acceptable to wait minutes for a more thorough result. Research returns a task you poll asynchronously.

Combining Operations

You can combine Search, Fetch, Research, and Task operations in your workflows:

1. Use Search to find relevant URLs
2. Use Fetch to retrieve full content from those URLs
3. Use Research for deep, multi-source investigations on a topic
4. Use Task to run any of the above asynchronously and poll for results
5. Process the markdown / structured content with other n8n nodes

Resources

• n8n community nodes documentation
• Linkup official website
• Linkup API documentation
• Linkup quickstart guide
• Linkup API reference

License

MIT

Support

For issues with this n8n node, please open an issue on GitHub.

For Linkup API support, contact: [email protected]