{k} Kadoa Icon

Python SDK

Adrian Krebs,Co-Founder & CEO of Kadoa
12 November 2025
Back to changelog

We've shipped our Python SDK. If you've been working with our API directly, this should make your life easier. It's written in Python and provides a clean, type-safe interface for interacting with Kadoa.

The SDK handles all the API complexity for you: authentication, error handling, pagination. So you can focus on extracting the data you need.

pip install kadoa-sdk

Here's the simplest way to extract data:

from kadoa_sdk import KadoaClient, KadoaClientConfig
from kadoa_sdk.extraction.types import ExtractionOptions

client = KadoaClient(config=KadoaClientConfig(api_key="your-api-key"))

options = ExtractionOptions(
    urls=["https://example.com/products"],
    name="Product Catalog"
)
result = client.extraction.run(options)

print(result.data)

When you need more control, you can define exactly what to extract:

from kadoa_sdk import KadoaClient, KadoaClientConfig
from kadoa_sdk.extraction.types import ExtractOptions
from kadoa_sdk.schemas.schema_builder import FieldOptions

client = KadoaClient(config=KadoaClientConfig(api_key="your-api-key"))

extract_options = ExtractOptions(
    urls=["https://example.com"],
    name="Product Catalog",
    extraction=lambda builder: builder
        .entity("Product")
        .field("name", "Product name", "STRING", FieldOptions(example="MacBook Pro"))
        .field("price", "Product price", "MONEY")
        .field("inStock", "Availability", "BOOLEAN")
)

extraction = client.extract(extract_options).create()
result = extraction.run()
data = result.fetch_data()
print(data)

The SDK also includes built-in support for real-time updates via WebSockets, data validation rules, and notification management. The SDK should become the default way of interacting with Kadoa from Python applications.

SDK documentation →