linq-python

What it is and what it does

linq-python is an officially maintained Python SDK for the Linq API V3, a REST API for messaging and chat operations. It wraps the Linq API with type-safe request and response models built on Pydantic, offering both synchronous (LinqAPIV3) and asynchronous (AsyncLinqAPIV3) clients powered by httpx. The library handles pagination automatically, includes built-in retry logic for transient failures, and provides detailed error types for different HTTP status codes.

The SDK is designed for Python 3.9+ applications that need to send messages, create chats, or interact with Linq's messaging infrastructure. It supports nested typed parameters, serialization helpers (to_json, to_dict), and optional aiohttp backend for async workloads. All types are exposed for IDE autocomplete and type checking.

Use it for:

• Build a messaging application that sends SMS or chat messages via the Linq API with full type safety and IDE support.
• Integrate Linq chat functionality into an async web service or background job runner using AsyncLinqAPIV3.
• Fetch and iterate through paginated lists of chats without manually handling pagination logic.
• Handle API errors gracefully by catching specific exception types (RateLimitError, AuthenticationError, etc.).
• Use the optional aiohttp backend for high-concurrency scenarios requiring many simultaneous API calls.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python SDK for the Linq API V3 REST API, providing type-safe synchronous and asynchronous clients with automatic pagination and built-in error handling.

Yes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and offers a clean, type-safe interface to the Linq API. It is suitable for production use if you need to integrate Linq messaging into a Python application. The Apache-2.0 license is permissive and the SDK supports current Python versions (3.9+).

Install

linq-python on PyPI

pip install linq-python

uv add linq-python

poetry add linq-python

Installing linq-python

Before you install

Low friction install with a pure-Python wheel and six standard dependencies. Active maintenance with a recent release and no known vulnerabilities.

License in practice

Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install linq-python

import os
from linq import LinqAPIV3

client = LinqAPIV3(
    api_key=os.environ.get("LINQ_API_V3_API_KEY"),
)

chat = client.chats.create(
    from_="+12052535597",
    message={},
    to=["+12052532136"],
)
print(chat.chat)

Requires LINQ_API_V3_API_KEY environment variable or explicit api_key parameter to authenticate with the Linq API.

Verify before relying

• Whether the optional aiohttp backend provides measurable concurrency improvements over the default httpx for typical workloads.
• Rate limit and timeout defaults and whether they suit typical messaging or chat API patterns.

Package facts

Evidence: linq_python-0.24.1-py3-none-any.whl

Tags

More Python Modules packages