clawpro 0.2.0

Official Python SDK for the ClawPro Instagram outbound API.

clawpro

Official Python SDK for the ClawPro Instagram outbound API — connect sending accounts, run competitor-audience campaigns, score leads, manage webhooks, and read usage.

pip install clawpro

Python 3.8+. Get an API key from the developer portal → API & Developers → API Keys.

Quick start

import os
from clawpro import ClawPro, ClawProError

clawpro = ClawPro(api_key=os.environ["CLAWPRO_API_KEY"])

account = clawpro.accounts.create(username="burner_account", country="gb")

campaign = clawpro.campaigns.create(
    account_id=account["id"],
    name="Founders engaging with X",
    targets=["@influencer1"],
    offer="We help B2B founders book demos via Instagram outbound.",
    daily_dm_target=20,
)
clawpro.campaigns.run(campaign["id"])

# Warm replies → mark a lead booked (fires the lead.booked webhook)
inbox = clawpro.campaigns.inbox(campaign["id"])
if inbox:
    clawpro.leads.update(inbox[0]["id"], status="booked")

print(clawpro.usage.summary())

# Auto-paginate the request log
for log in clawpro.usage.iterate_logs(page_size=100):
    ...

Resources

accounts, campaigns, leads, webhooks, keys, usage — mirroring the REST API. Requests authenticate with X-API-Key; transient failures (network, 429 honoring Retry-After, 5xx) are retried with exponential backoff for idempotent calls.

Errors

try:
    clawpro.accounts.create(username="taken_handle")
except ClawProError as err:
    print(err.status, err, err.request_id)  # 409 "@taken_handle is already connected"

Configuration

ClawPro(api_key="...", base_url="https://api.tryclawpro.com", max_retries=3, timeout=30.0)

It's also a context manager (with ClawPro(...) as clawpro: ...) and exposes .close().

License

MIT