GoodData Python SDK

The gooddata-sdk package provides a clean and convenient Python API to interact with GoodData.

At the moment the SDK provides services to inspect and interact with the Semantic Model and consume analytics:

Catalog Workspaces Service
Catalog Workspace Content Service
Catalog Data Source Service
Catalog User Service
Catalog Permission Service
Catalog Organization Service
Catalog Appearance Service
Visualizations Service
Compute Service
Table Service

See DOCUMENTATION for more details.

Requirements

GoodData Cloud or GoodData.CN installation
Python 3.10 or newer

Installation

Run the following command to install the gooddata-sdk package on your system:

pip install gooddata-sdk

Example

Compute an visualization:

import gooddata_sdk

# GoodData host in the form of uri
host = "http://localhost:3000"
# GoodData user token
token = "some_user_token"
sdk = gooddata_sdk.GoodDataSdk.create(host, token)

workspace_id = "demo"
visualization_id = "customers_trend"
# reads visualization from workspace
visualization = sdk.visualizations.get_visualization(workspace_id, visualization_id)
# triggers computation for the visualization. the result will be returned in a tabular form
table = sdk.tables.for_visualization(workspace_id, visualization)

# and this is how you can read data row-by-row and do something with it
for row in table.read_all():
    print(row)

Bugs & Requests

Please use the GitHub issue tracker to submit bugs or request features.

Changelog

See Github releases for released versions and a list of changes.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gooddata_sdk-1.69.1.dev2.tar.gz (869.4 kB view details)

Uploaded Jul 13, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

gooddata_sdk-1.69.1.dev2-py3-none-any.whl (202.2 kB view details)

Uploaded Jul 13, 2026 Python 3

File details

Details for the file gooddata_sdk-1.69.1.dev2.tar.gz.

File metadata

Download URL: gooddata_sdk-1.69.1.dev2.tar.gz
Upload date: Jul 13, 2026
Size: 869.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for gooddata_sdk-1.69.1.dev2.tar.gz
Algorithm	Hash digest
SHA256	`fee5388a8a0c6866dbac5050b6ca7c2c77fc88a94b7688a970784609ca54b85a`
MD5	`ef730bbc34be2f32cca04c6fa66eea6b`
BLAKE2b-256	`50ae4c66931841432e329a830a19f84a529c13202b7ad1db55f0935ca6f81029`

See more details on using hashes here.

Provenance

The following attestation bundles were made for gooddata_sdk-1.69.1.dev2.tar.gz:

Publisher: dev-release.yaml on gooddata/gooddata-python-sdk

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: gooddata_sdk-1.69.1.dev2.tar.gz
- Subject digest: fee5388a8a0c6866dbac5050b6ca7c2c77fc88a94b7688a970784609ca54b85a
- Sigstore transparency entry: 2161112829
- Sigstore integration time: Jul 13, 2026
Source repository:
- Permalink: gooddata/gooddata-python-sdk@357532eaeba3a0d8870c2a4a5eb7a6ceea9712d6
- Branch / Tag: refs/heads/master
- Owner: https://github.com/gooddata
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: dev-release.yaml@357532eaeba3a0d8870c2a4a5eb7a6ceea9712d6
- Trigger Event: workflow_dispatch