🛰️ bdapi – bitdrift's public API client (Python)

A modern, typed Python client for bitdrift's public API.

✨ Supported APIs

• ✅ Ingestion for server-side funnels

🚀 Installation

pip install bdapi

Or if you're using Poetry:

poetry add bdapi

🔧 Usage

from bdapi import Bitdrift, MetricPlatform
from datetime import datetime

client = Bitdrift(api_key="your-api-key")

client.ingest_metric(
    metric_id="signup_event",
    platform=MetricPlatform.ANDROID,
    app_id="com.example.app",
    app_version="1.0.0",
    timestamp=datetime.utcnow(),
    counter_delta=1,
)

CLI

You can also use the client from the command line for testing as:

$ poetry run cli --help

📦 API Overview

All requests are sent to https://api.bitdrift.io via POST using the Connect protocol and application/connect+proto.

🧪 Running Tests

poetry install
poetry run pytest

🔒 Authentication

All API calls require the x-loop-api-key header. Pass your key to the client:

Bitdrift(api_key="...")

📖 Resources

• Bitdrift Docs