🚀 Linkup Python SDK

A Python SDK for the Linkup API, allowing easy integration with Linkup's services. 🐍

🌟 Features

• ✅ Simple and intuitive API client.
• 🔍 Supports both standard and deep search queries.
• ⚡ Supports synchronous and asynchronous requests.
• 🔒 Handles authentication and request management.

📦 Installation

Simply install the Linkup Python SDK using pip:

pip install linkup-sdk

🛠️ Usage

Setting Up Your Environment

1. 🔑 Obtain an API Key:

   Sign up on Linkup to get your API key.

2. ⚙️ Set-up the API Key:

   Option 1: Export the LINKUP_API_KEY environment variable in your shell before using the Python SDK.

   export LINKUP_API_KEY='YOUR_LINKUP_API_KEY'

   Option 2: Set the LINKUP_API_KEY environment variable directly within Python, using for instance os.environ or python-dotenv with a .env file (python-dotenv needs to be installed separately in this case), before creating the Linkup Client.

   import os
   from linkup import LinkupClient
   
   os.environ["LINKUP_API_KEY"] = "YOUR_LINKUP_API_KEY"
   # or dotenv.load_dotenv()
   client = LinkupClient()
   ...

   Option 3: Pass the Linkup API key to the Linkup Client when creating it.

   from linkup import LinkupClient
   
   client = LinkupClient(api_key="YOUR_LINKUP_API_KEY")
   ...

📋 Examples

All search queries can be used with two very different modes:

• with depth="standard", the search will be straightforward and fast, suited for relatively simple queries (e.g. "What's the weather in Paris today?")
• with depth="deep", the search will use an agentic workflow, which makes it in general slower, but it will be able to solve more complex queries (e.g. "What is the company profile of LangChain accross the last few years, and how does it compare to its concurrents?")

📝 Standard Search Query

from linkup import LinkupClient

# Initialize the client (API key can be read from the environment variable or passed as an argument)
client = LinkupClient()

# Perform a search query
search_response = client.search(
    query="What are the 3 major events in the life of Abraham Lincoln?",
    depth="deep",  # "standard" or "deep"
    output_type="sourcedAnswer",  # "searchResults" or "sourcedAnswer" or "structured"
    structured_output_schema=None,  # must be filled if output_type is "structured"
)
print(search_response)

📚 More Examples

See the examples/ directory for more examples and documentation, for instance on how to use Linkup entrypoints using asynchronous functions.