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

  • Published on May 26, 2026
Prev Next

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

pip install supermetrics

Requires Python 3.11 or higher.

Getting started

See the SDK README for full installation instructions, authentication setup, API reference, and error handling details.

Examples

See the Examples Guide 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.

© Supermetrics 2025