Migrating from Tavily

Overview

Switch from Tavily’s Search and Extract to Linkup’s Search and Fetch in a line of code.

Tavily	Linkup	Role
`POST /search`	`POST /v1/search`	Web search for AI agents
`POST /extract`	`POST /v1/fetch`	Extract clean content from a URL

Search is Linkup’s synchronous web search endpoint, optimized for AI consumption. Given a natural-language query, the /search route returns ranked sources, optionally bundled with a cited natural-language answer or with structured output matching a JSON schema. Fetch is Linkup’s real-time page content extractor. Given a URL, the /fetch route returns a clean markdown rendering of the page, optimized for LLM consumption.

Quick start

Get your API key

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

Install the SDK

pip install linkup-sdk

npm install linkup-sdk

Migrate your search calls

Replace your API calls

Tavily

curl -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "query": "latest AI news",
    "search_depth": "basic",
    "max_results": 10
  }'

from tavily import TavilyClient

client = TavilyClient(api_key="tvly-YOUR_API_KEY")

response = client.search(
    query="latest AI news",
    search_depth="basic",
    max_results=10
)
print(response)

const { tavily } = require("@tavily/core");

const client = tavily({ apiKey: "tvly-YOUR_API_KEY" });

const response = await client.search("latest AI news", {
  searchDepth: "basic",
  maxResults: 10
});
console.log(response);

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"

from linkup import LinkupClient

client = LinkupClient(api_key="YOUR_LINKUP_KEY")

response = client.search(
    query="latest AI news",
    depth="standard",
    output_type="searchResults",
    max_results=10
)
print(response)

import { LinkupClient } from 'linkup-sdk';

const client = new LinkupClient({ apiKey: 'YOUR_LINKUP_KEY' });

client.search({
  query: 'latest AI news',
  depth: 'standard',
  outputType: 'searchResults',
  maxResults: 10
}).then(console.log);

Parameter mapping

Tavily parameter	Linkup parameter	Notes
`query`	`query`	Required parameter
`max_results`	`maxResults`	Total number of results returned. Linkup default: `10`
`search_depth`	`depth`	Map `"ultra-fast"` / `"fast"` → `"fast"`, `"basic"` → `"standard"`, `"advanced"` → `"deep"`
`include_answer`	`outputType`	Use `"sourcedAnswer"` instead of `true` / `"basic"` / `"advanced"`
`include_raw_content`	N/A (or Fetch)	Linkup `"searchResults"` already returns content snippets. For full page content, call Fetch on the result URLs
`include_domains`	`includeDomains`	Array of domain strings
`exclude_domains`	`excludeDomains`	Array of domain strings
`start_date`	`fromDate`	ISO 8601 date (`YYYY-MM-DD`)
`end_date`	`toDate`	ISO 8601 date (`YYYY-MM-DD`)
`time_range`	`fromDate`	Approximate with an explicit date (e.g. `"week"` → seven days ago)
`include_images`	`includeImages`	Returns image results when supported
N/A	`outputType`	Choose `"searchResults"`, `"sourcedAnswer"`, or `"structured"`
N/A	`structuredOutputSchema`	Define a custom JSON schema when `outputType` is `"structured"`

Response format differences

Tavily response structure

{
  "query": "latest AI news",
  "results": [
    {
      "title": "Page Title",
      "url": "https://example.com",
      "content": "Snippet or summary...",
      "score": 0.95
    }
  ],
  "answer": "Optional LLM answer when include_answer is set..."
}

Linkup response structure ("searchResults")

{
  "results": [
    {
      "name": "Page Title",
      "url": "https://example.com",
      "content": "Full content text...",
      "type": "html"
    }
  ]
}

Linkup response structure ("sourcedAnswer") — replaces Tavily include_answer

{
  "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

Tavily

curl -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "query": "AI news",
    "time_range": "week",
    "include_answer": true
  }'

response = client.search(
    query="AI news",
    time_range="week",
    include_answer=True
)

const response = await client.search("AI news", {
  timeRange: "week",
  includeAnswer: true
});

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"

from datetime import date

response = client.search(
    query="AI news",
    depth="standard",
    output_type="sourcedAnswer",
    from_date=date(2026, 3, 5)
)
print(response)

client.search({
  query: 'AI news',
  depth: 'standard',
  outputType: 'sourcedAnswer',
  fromDate: new Date('2026-03-05')
}).then(console.log);

Domain-specific search

Tavily

curl -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "query": "transformers",
    "include_domains": ["arxiv.org"]
  }'

response = client.search(
    query="transformers",
    include_domains=["arxiv.org"]
)

const response = await client.search("transformers", {
  includeDomains: ["arxiv.org"]
});

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"

response = client.search(
    query="transformers",
    depth="standard",
    output_type="searchResults",
    include_domains=["arxiv.org"]
)
print(response)

client.search({
  query: 'transformers',
  depth: 'standard',
  outputType: 'searchResults',
  includeDomains: ['arxiv.org']
}).then(console.log);

Excluding domains

Tavily

curl -X POST "https://api.tavily.com/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "query": "python tutorial",
    "exclude_domains": ["w3schools.com"]
  }'

response = client.search(
    query="python tutorial",
    exclude_domains=["w3schools.com"]
)

const response = await client.search("python tutorial", {
  excludeDomains: ["w3schools.com"]
});

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"

response = client.search(
    query="python tutorial",
    depth="standard",
    output_type="searchResults",
    exclude_domains=["w3schools.com"]
)
print(response)

client.search({
  query: 'python tutorial',
  depth: 'standard',
  outputType: 'searchResults',
  excludeDomains: ['w3schools.com']
}).then(console.log);

Migrate your extraction calls

Tavily Extract pulls content from one or more URLs. Linkup Fetch extracts clean markdown from a single public URL (HTML or PDF), with optional JavaScript rendering.

Fetch accepts one url per request. If you currently pass an array of URLs to Tavily Extract, call Linkup Fetch once per URL (or in parallel). For batch workloads, submit your Fetch calls through Tasks — up to 100 per submission, with exactly the same parameters and pricing as direct /fetch calls.

Replace your API calls

Tavily

curl -X POST "https://api.tavily.com/extract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "urls": ["https://docs.linkup.so"]
  }'

from tavily import TavilyClient

client = TavilyClient(api_key="tvly-YOUR_API_KEY")

response = client.extract(
    urls=["https://docs.linkup.so"]
)
print(response)

const { tavily } = require("@tavily/core");

const client = tavily({ apiKey: "tvly-YOUR_API_KEY" });

const response = await client.extract(["https://docs.linkup.so"]);
console.log(response);

Linkup

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

from linkup import LinkupClient

client = LinkupClient(api_key="YOUR_LINKUP_KEY")

response = client.fetch(
    url="https://docs.linkup.so",
    render_js=True,
)
print(response)

import { LinkupClient } from 'linkup-sdk';

const client = new LinkupClient({ apiKey: 'YOUR_LINKUP_KEY' });

const response = await client.fetch({
  url: 'https://docs.linkup.so',
  renderJs: true,
});
console.log(response);

Response format differences

Tavily response structure

{
  "results": [
    {
      "url": "https://docs.linkup.so",
      "raw_content": "# Page title\n\nExtracted content..."
    }
  ],
  "failed_results": []
}

Linkup response structure

{
  "markdown": "# Page title\n\nExtracted content...",
  "rawHtml": "<!doctype html><html>...</html>",
  "images": [
    { "alt": "Logo", "url": "https://example.com/logo.svg" }
  ]
}

rawHtml is present only when includeRawHtml is true. images is present only when extractImages is true. markdown is always returned.

Examples

JavaScript-rendered pages

Tavily

curl -X POST "https://api.tavily.com/extract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "urls": ["https://example.com/dashboard"],
    "extract_depth": "advanced"
  }'

response = client.extract(
    urls=["https://example.com/dashboard"],
    extract_depth="advanced"
)

const response = await client.extract(["https://example.com/dashboard"], {
  extractDepth: "advanced"
});

Linkup

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

response = client.fetch(
    url="https://example.com/dashboard",
    render_js=True,
)
print(response)

const response = await client.fetch({
  url: 'https://example.com/dashboard',
  renderJs: true,
});
console.log(response);

Extract images with content

Tavily

curl -X POST "https://api.tavily.com/extract" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer tvly-YOUR_API_KEY" \
  -d '{
    "urls": ["https://docs.linkup.so"],
    "include_images": true
  }'

response = client.extract(
    urls=["https://docs.linkup.so"],
    include_images=True
)

const response = await client.extract(["https://docs.linkup.so"], {
  includeImages: true
});

Linkup

curl -X POST "https://api.linkup.so/v1/fetch" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://docs.linkup.so",
    "extractImages": true
  }'

response = client.fetch(
    url="https://docs.linkup.so",
    extract_images=True
)
print(response)

const response = await client.fetch({
  url: 'https://docs.linkup.so',
  extractImages: true
});
console.log(response);

Need help?

Check our Quickstart Guide
Read Search best practices and Fetch best practices
Join our Discord Community
Explore the Search and Fetch API references

Your Linkup account starts with $20 of free credit when you sign up with a professional email address. You can monitor usage and add more credit in the Billing section.

Get Started

Endpoints

Platform

Guides

Tutorials

FAQ

Overview

Quick start

Get your API key

Get your API key

Install the SDK

Migrate your search calls

Replace your API calls

Parameter mapping

Response format differences

Examples

Fresh content search

Domain-specific search

Excluding domains

Migrate your extraction calls

Replace your API calls

Response format differences

Examples

JavaScript-rendered pages

Extract images with content

Need help?

​Overview

​Quick start

​Get your API key

Get your API key

​Install the SDK

​Migrate your search calls

​Replace your API calls

​Parameter mapping

​Response format differences

​Examples

​Fresh content search

​Domain-specific search

​Excluding domains

​Migrate your extraction calls

​Replace your API calls

​Response format differences

​Examples

​JavaScript-rendered pages

​Extract images with content

​Need help?

Overview

Quick start

Get your API key

Install the SDK

Migrate your search calls

Replace your API calls

Parameter mapping

Response format differences

Examples

Fresh content search

Domain-specific search

Excluding domains

Migrate your extraction calls

Replace your API calls

Response format differences

Examples

JavaScript-rendered pages

Extract images with content

Need help?