Back to integrations
Python SDK4 min read

Kooperativa SDK for Python

For Python projects, notebooks, and data pipelines calling the Kooperativa API directly from code.

kooperativaView package

The SDK mirrors the Node and PHP SDKs one for one: a single `Kooperativa` client with `.person`, `.company`, and `.monitors` attributes, each a resource object with a method per operation. Keyword arguments match the API's own field names (converted to snake_case), so anyone who has read the API docs already knows the method signatures.

Every call returns the parsed JSON response as a plain dict. Errors raise `KooperativaApiError`, with `.status` and `.code` attributes matching the API's documented error codes, rather than a generic HTTP exception that hides which specific check failed.

Installing it

Not on PyPI yet, install directly from the GitHub repository with pip.

Install and enrich a personpython
# pip install git+https://github.com/kooperativa-team/kooperativa-python.git

from kooperativa import Kooperativa

kooperativa = Kooperativa(api_key="kk_live_...")
profile = kooperativa.person.enrich(username="satyanadella")
print(profile["data"]["full_name"])

Get started

Try Kooperativa

One API key. Every endpoint behind this integration, and every other one, included on the same flat license with unlimited requests.

More integrations