Blockquote Python SDK

Official client for Blockquote. Requires Python 3.10 or later. No runtime dependencies.

pip install blockquote-agents

import os
import uuid
from blockquote_agents import Blockquote, BlockquoteError

client = Blockquote(api_key=os.getenv("BLOCKQUOTE_API_KEY"))
started = client.start_scan("https://example.com", idempotency_key=str(uuid.uuid4()))
print(started.data, started.headers.get("Retry-After"))
# Wait for Retry-After, then read the returned id.
report = client.get_scan(started.data["id"])
comparison = client.compare_scans(from_id="BASELINE_ID", to_id="NEW_ID")

Each call returns a Response with data, status, and HTTP headers. BlockquoteError retains data, status, headers, and retry_after. Network errors pass through. Requests time out after 30 seconds. Set timeout in the constructor to change this. The client does not retry or poll automatically. Scans can return a cached result or pending status. Reuse an idempotency key only when you repeat the same scan request.

Public report reads need no key. Account access uses an optional bearer key from your account. Keys require Pro or Agency. Unattended scan creation can require a paid key with the scan scope. Human verification still applies where required. Pass turnstile_token when available; the SDK does not obtain or bypass verification. Pass refresh=True to request a fresh scan with account authentication. Scan quotas still apply. Read access and comparison output follow your account plan.

See the API reference and OpenAPI document.

Run tests from this package directory:

python3 -m unittest discover -s tests