---
title: "Python SDK"
slug: "python-sdk"
updated: 2026-05-26T10:53:58Z
published: 2026-05-26T10:53:58Z
canonical: "docs.supermetrics.com/python-sdk"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.supermetrics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Python SDK

The Supermetrics Python SDK is an official Python client for the Supermetrics API. It lets you query marketing data, manage OAuth login links, trigger Data Warehouse backfills, and more — directly from Python scripts, notebooks, or applications.

The SDK supports both synchronous and asynchronous usage, includes type-safe Pydantic models, and is available on PyPI.

> **Beta release** — The SDK is under active development. Features and interfaces may change without notice.

## What you can do with the SDK

- Query data from hundreds of marketing and analytics sources
- Manage OAuth login links for data source authentication
- List available accounts for any connected data source
- Trigger and monitor Data Warehouse backfills
- Use either a synchronous or async client depending on your application

## Installation

bash

```bash
pip install supermetrics
```

Requires Python 3.11 or higher.

## Getting started

See the [**SDK README**](https://github.com/supermetrics-public/supermetrics-python-sdk/blob/main/README.md) for full installation instructions, authentication setup, API reference, and error handling details.

## Examples

See the [**Examples Guide**](https://github.com/supermetrics-public/supermetrics-python-sdk/blob/main/examples/README.md) for complete working examples, including:

- `complete_flow.py` — full synchronous workflow from authentication to query execution
- `async_flow.py` — the same workflow using async/await

## Issues and feedback

The SDK is open source. To report a bug or request a feature, open an issue on the [GitHub repository](https://github.com/supermetrics-public/supermetrics-python-sdk/issues).