Access data marketplace reports and guides

All Data Provider Segment Reports and Insight Guides are stored in The Trade Desk Amazon S3 bucket and organized into partner-specific folders.

To access your reports, you must create an AWS access ID and secret key by following the Amazon S3 Access guide.

Download the report

After generating your AWS keys, use the following Python script to download the report. Replace all placeholder values shown in ALL CAPS.

TIP: To access a report, make sure the full file path ends with a forward slash (/). For example, thetradedesk-useast-partner-datafeed/au-dataproviders/dataproviders/narrative/.

import boto3

# Replace placeholders with your actual credentials or use environment variables. Only us-east-1 is available as the AWS region.
AWS_ACCESS_KEY_ID = "AWS_ACCESS_KEY_ID_PLACEHOLDER"
AWS_SECRET_ACCESS_KEY = "AWS_SECRET_ACCESS_KEY_PLACEHOLDER"
AWS_REGION = "us-east-1"

# Create a session using explicit credentials, or fall back to environment variables, AWS profiles, or roles.
session = boto3.Session(
    aws_access_key_id=AWS_ACCESS_KEY_ID,
    aws_secret_access_key=AWS_SECRET_ACCESS_KEY,
    region_name=AWS_REGION
)

# Initialize S3 client and resource.
client = session.client('s3')
resource = session.resource('s3')

bucket_name = 'thetradedesk-useast-partner-datafeed'
prefix = 'au-dataproviders/dataproviders/PROVIDER_NAME_PLACEHOLDER/'

# List objects using resource.
my_bucket = resource.Bucket(bucket_name)
files = list(my_bucket.objects.filter(Prefix=prefix))

# List objects using client.
all_objects = client.list_objects(Bucket=bucket_name, Prefix=prefix)

# Print results.
if files:
    print("Files from resource filter:")
    for obj in files:
        # Extract only the filename from each S3 key by taking the last path segment.
        file_name = obj.key.split("/")[-1]
        if file_name:  # Skip empty folder markers.
            print(file_name)

if 'Contents' in all_objects:
    print("\nFiles from client list:")
    for obj in all_objects['Contents']:
        file_name = obj['Key'].split("/")[-1]
        if file_name:
            print(file_name)
else:
    print("No objects found with client list.")

FAQs

The following is a list of commonly asked questions about the data marketplace reports.

I’ve never used Amazon S3 before. How do I access it after generating my tokens?

Several third-party applications can connect to Amazon S3. The Trade Desk recommends AWS Toolkit for Visual Studio Code. For help, contact your Data Partnerships Manager.