Skip to main content
getclean’s SDKs for Python, TypeScript, Java, Go and C# are generated from the API’s OpenAPI contract. That gives you the same thing in every language: each of the 22 operations is a method with the operation’s own name, its fields are the fields the API reference lists, and its answer is a typed object whose members are the record’s members. Every docstring is the operation’s description from the contract, word for word, so your editor shows you the same text as the reference. On top of the generated code, each SDK carries a small hand-written layer for the things a research agent would otherwise write itself. The release starts with Python and TypeScript. Java, Go and C# are generated from the same contract and follow.

Install

Each SDK lives in its own repository under github.com/deterministic-labs, under the MIT licence.

What every SDK does for you

There’s no streaming and there are no webhooks, because the API is designed so you don’t need them: get_job waits for a job on the server side for as long as you ask, and the SDK’s wait does the rest.

The client in each language

The two guides that follow go through everything a research agent needs from the SDK, in the order it needs it: the credential, the first fetch and how to read it, the research loop in code, reading a record again for free, uploads and jobs, errors, retries and budgets.

Python

Keyword arguments, pagers you loop over, typed errors per status, a sync and an async client.

TypeScript

One request object per call, optional members the compiler makes you check, pagers you read with for await.