sdks

SDKs

Updated May 12, 2026

Siftfy is a single REST endpoint, so any HTTP client works. Where we ship an official SDK, it adds typed responses, transparent retries, and sensible defaults.

Python — official

Source on GitHub, published to PyPI as siftfy. Built on httpx, MIT-licensed, type-checked under mypy --strict.

bash
pip install siftfy
python
from siftfy import Siftfy

client = Siftfy(api_key="sk_live_...")
result = client.predict("Win a free iPhone! Click here NOW")
print(result.spam_probability)  # 0.987
print(result.likelihood)        # "high"

Async

python
import asyncio
from siftfy import AsyncSiftfy

async def main() -> None:
    async with AsyncSiftfy(api_key="sk_live_...") as client:
        result = await client.predict("hello, world")
        print(result.spam_probability)

asyncio.run(main())

The client retries idempotent failures (408 / 429 / 5xx, network errors) with exponential backoff and jitter, honouring Retry-After when present. Tune with max_retries=N (default 2; set 0 to disable).

Other languages

We don't ship official clients for other languages yet. The endpoint is a single POST with a JSON body, so any HTTP client works — see the curl, Python, and JavaScript examples on the predict page. If you'd like an official client for a language we don't yet cover, tell us — we prioritise based on demand.

Where to next