Python
No Python SDK package. VoxBurst does not publish an official Python SDK. Use the REST API directly — it works with any HTTP library. The examples below use requests, but httpx, aiohttp, or the standard library urllib all work equally well.
There is no pip install voxburst package. Unlike the TypeScript SDK and Go SDK, Python integration is done by calling the REST API with your preferred HTTP client. The API is fully usable from Python without any VoxBurst-specific library.
Quickstart
pip install requestsimport os
import requests
BASE_URL = "https://api.voxburst.io/v1"
HEADERS = {
"Authorization": f"Bearer {os.environ['VOXBURST_API_KEY']}",
"Content-Type": "application/json",
}
# List connected accounts
r = requests.get(f"{BASE_URL}/accounts", headers=HEADERS, params={"status": "ACTIVE"})
r.raise_for_status()
accounts = r.json()["data"]
# Create a scheduled post
r = requests.post(f"{BASE_URL}/posts", headers=HEADERS, json={
"content": "Hello from Python!",
"accountIds": [accounts[0]["id"]],
"scheduledFor": "2026-07-01T15:00:00Z",
})
r.raise_for_status()
print(r.json()["id"])Full Python examples
The Python examples guide has complete, runnable code for every common operation:
- Authentication and health check
- List and filter connected accounts
- Media upload (presign → PUT → poll until READY)
- Create, schedule, and publish posts
- Webhook signature verification
- Retry logic and error handling
- Idempotency keys
Which SDK should I use?
| TypeScript / Node.js | Go | Python | |
|---|---|---|---|
| Official package | @voxburst/sdk | voxburst-go | None — use REST directly |
| Auto-retry | ✅ | ✅ | Manual |
| Cursor pagination helper | ✅ (listAll) | ✅ (ListAll) | Manual |
| Typed errors | ✅ | ✅ | HTTP status codes |
| Media upload helper | Partial | ✅ | Manual (3 steps) |
If your Python project needs a production-grade wrapper, implement one using the REST API reference and the Python examples guide as a starting point.
Last updated on