prdb-sdk (Python)

Python client for the prdb Public API.

Install

pip install prdb-sdk

Requires Python 3.10 or newer. The client is async and uses httpx under the hood, by way of the Kiota bundle.

Usage

import asyncio
from uuid import UUID

from prdb_sdk import create_client


async def main() -> None:
    client = create_client(api_key="...")

    # GET /videos
    page = await client.videos.get()
    for video in page.items or []:
        print(video.title)

    # GET /videos/{id}
    video = await client.videos.by_id(UUID("...")).get()

    # Query parameters are typed, including the closed-set ones.
    from prdb_sdk.generated.videos.videos_request_builder import VideosRequestBuilder

    config = VideosRequestBuilder.VideosRequestBuilderGetRequestConfiguration(
        query_parameters=VideosRequestBuilder.VideosRequestBuilderGetQueryParameters(
            page=2,
            page_size=50,
            search="...",
        )
    )
    page_two = await client.videos.get(request_configuration=config)


asyncio.run(main())

The request builders mirror the API's URL structure, so GET /videos/{id}/filehashes is client.videos.by_id(video_id).filehashes.get().

Authentication

create_client sends the key in the X-Api-Key header, and keeps it on the API host: a redirect to a different origin raises CrossOriginRedirectError rather than handing your credential to whoever answers there. Redirects that stay on the same origin are followed normally.

base_url must use https, so the key is never sent in cleartext.

GET /health is the only endpoint that works without a key; use create_anonymous_client() for health probes. That one has no credential to protect, so it accepts a plain http base URL.

Options

client = create_client(
    api_key="...",
    base_url="https://api.prdb.net",   # override for a staging deployment
    http_client=my_httpx_async_client, # control timeouts, proxies, connection limits
)

The client you pass in is configured with the SDK's middleware in place, so it behaves like the one built for you — same redirect rule, same retry handling.

Generated code

Everything under prdb_sdk/generated/ is produced by Kiota from spec/openapi.json in the repository root and is overwritten on every regeneration. Do not edit it — see the root README.

Download files

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

Source Distribution

prdb_sdk-0.1.1.tar.gz (46.8 kB view details)

Uploaded Aug 7, 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.

prdb_sdk-0.1.1-py3-none-any.whl (217.1 kB view details)

Uploaded Aug 7, 2026 Python 3

File details

Details for the file prdb_sdk-0.1.1.tar.gz.

File metadata

Download URL: prdb_sdk-0.1.1.tar.gz
Upload date: Aug 7, 2026
Size: 46.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for prdb_sdk-0.1.1.tar.gz
Algorithm	Hash digest
SHA256	`0976b434b68b480b6575b3a2608160b74f362a109ac2195ab5ec8739431de57f`
MD5	`175ee6e89a4f92e90f58f1a8f88d3302`
BLAKE2b-256	`6ac496f1d42cdede16a58f856e793b8613752ebc08cade0dd92fa8885bb6a76a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for prdb_sdk-0.1.1.tar.gz:

Publisher: release.yml on prdb-net/prdb-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: prdb_sdk-0.1.1.tar.gz
- Subject digest: 0976b434b68b480b6575b3a2608160b74f362a109ac2195ab5ec8739431de57f
- Sigstore transparency entry: 2372634629
- Sigstore integration time: Aug 7, 2026
Source repository:
- Permalink: prdb-net/prdb-sdk@a41098678f1bf40828ef6788ab4144432ff7f53f
- Branch / Tag: refs/tags/v0.1.1
- Owner: https://github.com/prdb-net
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@a41098678f1bf40828ef6788ab4144432ff7f53f
- Trigger Event: push