adi-DATEX-472-publish-data-apis-sdk by adithyasamavedhi-ttd · Pull Request #1 · thetradedesk/ttd-data-python

adithyasamavedhi-ttd · 2026-02-05T23:21:57Z

What does this MR do?

Generates first version of Data APIs SDK
Sets up a pipeline to raise a PR if any changes to swagger occur
Merging PR will publish to Pypi as 0.0.1

Local Tests:

ezra-ttd · 2026-02-06T23:55:08Z

+
+
+with Ttddata(
+    server_url="https://api.example.com",


if appropriate, i recommend setting up a default server (if there is a default server—I don't really know what the data API does). See workflows SDK: https://github.com/thetradedesk/ttd-workflows-python/blob/main/README.md#server-selection

Thanks, I'll look to add a more comprehensive readme. Default Server is appropriate here, I'll be looking into what fits appropriately here.

The default here points to an example endpoint though. The default should be something that actually works.

The USAGE.md file is generated by speakeasy. In the next iteration, I'll look into editing the speakeasy configs to ensure any changes to this file is not overwritten by speakeasy. That will help ensure once we set a default server, it isnt overwritten.

I have added a default URL in the file.

ezra-ttd · 2026-02-11T19:43:42Z

+from ttd_data import TTDData
+
+sdk = TTDData(
+  # SDK arguments


I think you still need to set up auth? I'd think this would take an auth token

legrigonis · 2026-02-11T23:21:41Z

+  devContainers:
+    enabled: true
+    schemaPath: .speakeasy/out.openapi.yaml
+  sdkClassName: TTDData


I am not too sold on TTDData, perhaps DataClient might be a better fit since TTD comes up in the package name already so it's clear that the client is from TTD.

Same here, open to renaming it to TTDDataClient, for reason being that once its imported as
from ttd_data import DataClient, its not clear reading DataClient.DoSomething() to understand where its coming from.

Having TTD part of the client name makes it clear when reading code.

legrigonis · 2026-02-11T23:25:48Z

+  asyncMode: both
+  authors:
+    - Speakeasy
+  baseErrorName: TTDDataError


In spirit of the above how about DataError and ApiError?

I feel DataError and ApiError are too generic. TTDDataError is clear by name, where the error came from. I am in favor of editing ApiError to be TTDApiError to match. But generic names like DataError, ApiError may conflict with other libraries which may have generic error names.

legrigonis · 2026-02-11T23:30:31Z

+| Variable | Description |
+|---|---|
+| `TTD_AUTH_TOKEN` | **(Required)** Your TTD authentication token |
+| `TTD_DATA_SERVER_URL` | API server URL (defaults to `https://api.example.com`) |


does this needs to be regenerated? Does not seem to be accurate anymore

legrigonis · 2026-02-11T23:34:23Z

+source .venv/bin/activate
+pip install -e .
+export TTD_AUTH_TOKEN="your-ttd-auth-token-here"
+export TTD_DATA_SERVER_URL="https://usw-data.adsrvr.org"


Why did we pick usw-data.adsrvr.org as a default?

https://partner.thetradedesk.com/v3/portal/data/doc/DataEnvironments#first-pd-servers
Referred to this while setting it up, all first-party dataservers are region specific. I can change it to https://bulk-data.adsrvr.org that seems like the only generic name but is confusing since our documentation does not state it as first party dataserver.

legrigonis · 2026-02-11T23:37:26Z

+| `ttd_auth`                                                                    | *Optional[str]*                                                               | :heavy_minus_sign:                                                            | Data API token for authentication. If not provided, TtdSignature is required. |
+| `ttd_signature`                                                               | *Optional[str]*                                                               | :heavy_minus_sign:                                                            | Legacy signature-based authentication. Required if TTD-Auth is not provided.  |
+| `data_provider_id`                                                            | *OptionalNullable[str]*                                                       | :heavy_minus_sign:                                                            | N/A                                                                           |
+| `items`                                                                       | List[[models.AdvertiserDataItem](../../models/advertiserdataitem.md)]         | :heavy_minus_sign:                                                            | N/A                                                                           |


Tangential but I feel like I should look into why this is coming as optional from swagger

legrigonis · 2026-02-11T23:39:00Z

+import pydantic
+from ttd_data.errors import TTDDataError
+from ttd_data.models import (
+    advertiserdataserverresponseline as models_advertiserdataserverresponseline,


this is a very ugly name, is there some policy we can tweak so that this gets generated with some _ in between or smth.

This has to do with how its named in swagger. We can override it and change some setting in speakeasy to ensure that it is not overwritten everytime speakeasy generates a new version.

yep, i agree this would be a good improvement, we do this in workflows if you need a model or the speakeasy docs should have guidance

legrigonis · 2026-02-11T23:47:27Z

+
+
+with TTDData(
+    server_url="https://api.example.com",


still see a lot of these and no default alias'ed URL 🤔

discussed this in the slack thread, there should be a follow-up to set a default / alias

ezra-ttd reviewed Feb 6, 2026

View reviewed changes

adithyasamavedhi-ttd force-pushed the adi-DATEX-472-publish-data-apis-sdk branch 2 times, most recently from 29a840d to 5102a1b Compare February 11, 2026 01:41

adi-DATEX-472-publish-data-apis-sdk

507a37c

adithyasamavedhi-ttd force-pushed the adi-DATEX-472-publish-data-apis-sdk branch from 5102a1b to 507a37c Compare February 11, 2026 18:51

adithyasamavedhi-ttd self-assigned this Feb 11, 2026

adithyasamavedhi-ttd changed the title ~~Draft: adi-DATEX-472-publish-data-apis-sdk~~ adi-DATEX-472-publish-data-apis-sdk Feb 11, 2026

adi-DATEX-472-add-testing-readme

021e82e

ezra-ttd reviewed Feb 11, 2026

View reviewed changes

adi-DATEX-472-add-uswest-dataserver-url-in-usage.md

de27f01

legrigonis reviewed Feb 11, 2026

View reviewed changes

adithyasamavedhi-ttd added 3 commits February 11, 2026 16:14

adi-DATEX-472-rename-all-example-urls-to-usw-dataserver

1e740b5

adi-DATEX-472-regenerate-sdk-after-renaming-error-classes-and-sdkname

bbc5bea

adi-DATEX-472-rename-all-example-domains-to-usw-dataserver

3515943

adithyasamavedhi-ttd force-pushed the adi-DATEX-472-publish-data-apis-sdk branch from feec7aa to 3515943 Compare February 12, 2026 01:35

legrigonis approved these changes Feb 12, 2026

View reviewed changes

adithyasamavedhi-ttd merged commit 8317523 into main Feb 12, 2026

ezra-ttd deleted the adi-DATEX-472-publish-data-apis-sdk branch February 12, 2026 18:20

Conversation

adithyasamavedhi-ttd commented Feb 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

adithyasamavedhi-ttd commented Feb 5, 2026 •

edited

Loading