Linkup Block

The Linkup block searches and retrieves up-to-date information from the web with source attribution. Reach for it when a workflow needs fresh, citable facts from across the internet rather than relying on a model's training data.

Overview

When to Use

• Answer questions that depend on current events or recently published information.
• Ground an agent's response in real web sources with attribution.
• Retrieve a list of relevant search results for downstream processing.
• Get a synthesized, sourced answer to a natural-language query in one step.
• Run deeper research passes when a standard search is not thorough enough.
• Validate or supplement LLM-generated content with live web citations.

Configuration

Search Query (q)

The natural-language query to send to the Linkup API. Supports {{blockName.field}} references to pass dynamic values from upstream blocks. Required.

Output Type (outputType)

Controls the shape of the response. Options:

Search Depth (depth)

Controls how thorough the search is. Options:

API Key (apiKey)

Your Linkup API key. Store it as a workspace secret and reference it as {{LINKUP_API_KEY}}. Required.

Inputs & Outputs

• Inputs:

  • q (string) — The search query sent to Linkup.
  • apiKey (string) — Linkup API key used to authenticate the request.
  • depth (string) — Search depth level; either "standard" or "deep".
  • outputType (string) — Output format; either "sourcedAnswer" or "searchResults".

• Outputs:

  • answer (string) — The generated, sourced answer to the search query (populated when outputType is sourcedAnswer).
  • sources (json) — Array of source references used to compile the answer; each source contains name, url, and snippet.

Tools

• Linkup Search (linkup_search) — Posts the query to https://api.linkup.so/v1/search with the configured depth and output type. Authenticates via a Bearer token (your API key). Returns an answer string and a sources array. Images are excluded from results.

YAML Example

linkup_1:
  type: linkup
  name: "Linkup"
  inputs:
    q: "{{start.input}}"
    outputType: "sourcedAnswer"
    depth: "standard"
    apiKey: "{{LINKUP_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id