---
id: linkup-sdk
version: "0.20.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# linkup-sdk — A Python Client SDK for the Linkup API

License: permissive · Maintenance: active · Downloads: 314.2K/mo

## What it is and what it does

Linkup SDK is a Python client that wraps the Linkup API, a web search and content retrieval service. It lets you perform web searches at different complexity levels (fast, standard, deep), fetch and parse web page content into markdown, create long-running research tasks, and batch multiple operations together. The library supports both blocking and async/await patterns, making it suitable for both simple scripts and production applications that need to avoid blocking I/O.

The SDK handles authentication via API key (passed directly, read from environment, or set via dotenv), manages HTTP requests through httpx, and validates responses using pydantic. It also includes optional support for the x402 payment protocol to pay for requests on-chain via EVM-compatible networks instead of API keys. All main functions have async counterparts prefixed with `async_`, enabling concurrent API calls without blocking.

Use it for:

- Build a web research agent that performs multi-depth searches and fetches relevant pages to synthesize answers with sources.
- Batch-process a list of URLs to extract and clean their content in markdown format for downstream NLP or indexing.
- Create a long-running research task that investigates a complex query asynchronously and retrieve results later.
- Integrate web search capabilities into a chatbot or knowledge system that needs current information from the web.
- Perform concurrent searches across multiple queries without blocking, using async_search in a production service.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for the Linkup API that provides web search, page fetching, research task management, and batch job submission with support for both synchronous and asynchronous calls.

Yes. The package is actively maintained, has low install friction (two lightweight dependencies), carries no known vulnerabilities, and offers a clean async-first API for a useful service. MIT licensing poses no restrictions. Install it if you need programmatic web search, content fetching, or research task automation; skip it if you don't need external web data.

## Install

pip install linkup-sdk
uv add linkup-sdk
poetry add linkup-sdk

## Installing linkup-sdk

Before you install: Low friction: pure Python wheel with only httpx and pydantic as runtime dependencies. Active maintenance with a release 9 days old and recent commits.

License in practice: MIT license permits unrestricted use, modification, and distribution in both open and closed projects with minimal restrictions.

Quickstart:

pip install linkup-sdk

import linkup

client = linkup.Client(api_key="your-key")
response = await client.async_search(
    query="example query",
    depth="standard",
    output_type="sourcedAnswer"
)
print(response.model_dump())

Requires Python 3.10 or later. API key from Linkup required for authentication.

Verify before relying:

- Whether the x402 payment protocol extras require additional system dependencies beyond what pip installs
- Rate limiting or quota behavior when making concurrent async calls
- Whether the 'fast' search depth mode is production-ready or remains experimental

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 314.2K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

web search api client, linkup python sdk, async http client library, api wrapper python, web scraping and fetch, research task automation, batch api requests, web-search-api, async-http-client, content-extraction

[View on SkillFed](https://skillfed.io/packages/linkup-sdk) · [View on PyPI](https://pypi.org/project/linkup-sdk/)