curl -s -X POST \
  -H "Authorization: Bearer $LINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "QUERY",
    "depth": "standard",
    "outputType": "sourcedAnswer"
  }' \
  "https://api.linkup.so/v1/search"

Parameters:

q (required): Natural language search query.
depth (optional): Search depth (standard or deep).
outputType (optional): Response format (e.g., sourcedAnswer for an answer + sources, or searchResults for raw results).
includeDomains (optional): Array of domains/URLs to include.
excludeDomains (optional): Array of domains/URLs to exclude.
includeImages (optional): Include image results when set to true.
maxResults (optional): Limit the number of returned results.

Step 2: Fetch Page Content (Optional)

curl -s -X POST \
  -H "Authorization: Bearer $LINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/article",
    "renderJs": false
  }' \
  "https://api.linkup.so/v1/fetch"

Parameters:

url (required): The webpage to fetch and extract content from.
renderJs (optional): Whether to render JavaScript content (default false).

Examples

Source-backed answer with citations

curl -s -X POST \
  -H "Authorization: Bearer $LINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "What changed in the latest Node.js release?",
    "depth": "standard",
    "outputType": "sourcedAnswer",
    "maxResults": 5
  }' \
  "https://api.linkup.so/v1/search"

Raw search results for deeper research

curl -s -X POST \
  -H "Authorization: Bearer $LINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "q": "EU AI Act compliance checklist",
    "depth": "deep",
    "outputType": "searchResults",
    "includeDomains": ["ec.europa.eu", "eur-lex.europa.eu"]
  }' \
  "https://api.linkup.so/v1/search"

Fetch the content of a specific URL

curl -s -X POST \
  -H "Authorization: Bearer $LINKUP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/docs",
    "renderJs": true
  }' \
  "https://api.linkup.so/v1/fetch"

Tips

Use outputType: sourcedAnswer for concise answers with citations.
Use outputType: searchResults for full result lists or manual synthesis.
Prefer depth: standard for quick lookups and depth: deep for multi-source research.
Use includeDomains / excludeDomains to control where sources come from.

linkup

Linkup

Overview

Workflow

Step 1: Run a Web Search