Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.linkup.so/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

Linkup is powered by a proprietary, AI-native web index, which provides swift and relevant retrieval of web results. This is a fundamentally different approach than SerpAPI’s, which scrapes Google’s results page.

​
Quick start

​
Get your API key

Get your API key

Create a Linkup account for free to get your API key.

​
Install the SDK

pip install linkup-sdk

​
Replace your API calls

SerpAPI 
curl "https://serpapi.com/search?engine=google&q=latest%20AI%20news&num=10&api_key=YOUR_SERPAPI_KEY"
Linkup 
curl "https://api.linkup.so/v1/search" \
  -G \
  -H "Authorization: Bearer YOUR_LINKUP_KEY" \
  --data-urlencode "q=latest AI news" \
  --data-urlencode "depth=standard" \
  --data-urlencode "outputType=searchResults" \
  --data-urlencode "maxResults=10"

​
Parameter mapping

SerpAPI parameterLinkup parameterNotes
qqueryRequired parameter
engineN/ALinkup uses its own AI-native search engine
nummaxResultsTotal number of results returned. Default: 10
tbs (time-based)fromDate, toDateUse ISO 8601 date format (YYYY-MM-DD)
as_dt, as_eqincludeDomains, excludeDomainsUse arrays of domain strings
N/AdepthChoose "fast" (beta), "standard", or "deep"
N/AoutputTypeChoose "searchResults", "sourcedAnswer", or "structured"
N/AstructuredOutputSchemaDefine custom JSON schema for structured data extraction

​
Response format differences

SerpAPI response structure 
{
  "organic_results": [
    {
      "position": 1,
      "title": "Page Title",
      "link": "https://example.com",
      "snippet": "Description...",
      "date": "2 days ago"
    }
  ],
  "search_metadata": {
    "status": "Success",
    "total_time_taken": 1.23
  }
}
Linkup response structure ("searchResults") 
{
  "results": [
    {
      "name": "Page Title",
      "url": "https://example.com",
      "content": "Full content text...",
      "type": "html"
    }
  ]
}
Linkup response structure ("sourcedAnswer") 
{
  "answer": "Generated answer with citations...",
  "sources": [
    {
      "name": "Page Title",
      "url": "https://example.com",
      "snippet": "Relevant excerpt..."
    }
  ]
}
Linkup response structure ("structured") 
{
  "output": {
    "customField1": "Extracted data following your schema...",
    "customField2": ["Array", "of", "values"]
  }
}

​
Examples

​
Fresh content search

SerpAPI 
curl "https://serpapi.com/search?engine=google&q=AI+news&tbs=qdr:w&api_key=YOUR_KEY"
Linkup 
curl "https://api.linkup.so/v1/search" \
  -G \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=AI news" \
  --data-urlencode "depth=standard" \
  --data-urlencode "outputType=sourcedAnswer" \
  --data-urlencode "fromDate=2026-03-05"
SerpAPI 
curl "https://serpapi.com/search?engine=google&q=transformers&as_dt=arxiv.org&api_key=YOUR_KEY"
Linkup 
curl "https://api.linkup.so/v1/search" \
  -G \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=transformers" \
  --data-urlencode "depth=standard" \
  --data-urlencode "outputType=searchResults" \
  --data-urlencode "includeDomains=arxiv.org"

​
Excluding domains

SerpAPI 
curl "https://serpapi.com/search?engine=google&q=python+tutorial&as_eq=w3schools.com&api_key=YOUR_KEY"
Linkup 
curl "https://api.linkup.so/v1/search" \
  -G \
  -H "Authorization: Bearer YOUR_KEY" \
  --data-urlencode "q=python tutorial" \
  --data-urlencode "depth=standard" \
  --data-urlencode "outputType=searchResults" \
  --data-urlencode "excludeDomains=w3schools.com"

​
Need help?

Your Linkup account starts with $5 of free credit. You can monitor usage and add more credit in the Billing section.