---
id: gooddata-sdk
version: "1.72.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# gooddata-sdk — GoodData Cloud Python SDK

License: permissive · Maintenance: active · Downloads: 162.8K/mo

## What it is and what it does

The gooddata-sdk package is a Python client library for the GoodData analytics platform. It abstracts the underlying HTTP API into a clean, object-oriented interface for querying workspaces, managing data sources, retrieving visualizations, and computing analytics results. The SDK handles authentication, request serialization, and response parsing, allowing developers to focus on analytics logic rather than API mechanics.

Typical usage involves creating an SDK instance with a host URL and authentication token, then using service objects (visualizations, tables, compute, catalog) to inspect metadata and retrieve data. The package depends on requests for HTTP communication, cattrs and attrs for data serialization, and gooddata-api-client for lower-level API bindings. It targets modern Python versions (3.10+) and is actively maintained with recent releases.

Use it for:

- Embed GoodData analytics into Python applications by fetching visualization data and rendering it in custom dashboards.
- Automate data extraction from GoodData workspaces for downstream processing, reporting, or data warehouse loading.
- Inspect and manage workspace metadata, data sources, users, and permissions programmatically.
- Build scheduled analytics jobs that compute visualizations and export results to files or external systems.
- Integrate GoodData as a semantic layer in Python data pipelines for governed metric and dimension access.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Provides a Python API to interact with GoodData Cloud or GoodData.CN installations, enabling inspection and consumption of semantic models, workspaces, data sources, visualizations, and computed analytics.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and provides a well-structured API for GoodData integration. It is suitable for production use if you have a GoodData Cloud or GoodData.CN instance. No known vulnerabilities as of the fact sheet date.

## Install

pip install gooddata-sdk
uv add gooddata-sdk
poetry add gooddata-sdk

## Installing gooddata-sdk

Before you install: Low friction install with nine runtime dependencies. Active maintenance: released 7 days ago with last commit on 2026-08-14. Supports Python 3.10 through 3.14.

License in practice: MIT license permits unrestricted use, modification, and distribution with minimal restrictions—suitable for both open and proprietary projects.

Quickstart:

pip install gooddata-sdk

import gooddata_sdk
sdk = gooddata_sdk.GoodDataSdk.create("http://localhost:3000", "token")
visualization = sdk.visualizations.get_visualization("workspace_id", "viz_id")
table = sdk.tables.for_visualization("workspace_id", visualization)
for row in table.read_all():
    print(row)

Requires Python 3.10 or newer and a running GoodData Cloud or GoodData.CN instance with valid credentials.

Verify before relying:

- Whether the SDK supports all GoodData.CN versions or only specific releases.
- Performance characteristics when working with large datasets or complex visualizations.
- Availability of async/concurrent request support for batch operations.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 162.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gooddata python api client, semantic model inspection sdk, analytics computation library, workspace management python, visualization data retrieval, gooddata cloud integration, headless bi sdk, analytics-sdk, gooddata-integration, semantic-layer

[View on SkillFed](https://skillfed.io/packages/gooddata-sdk) · [View on PyPI](https://pypi.org/project/gooddata-sdk/)