The advertiserReport query endpoint provides deal performance reporting for all deals associated with your TripleLift Account (aka Member), matching the capabilities of Reports for Advertisers in TripleLift Direct.

• Scope: Covers all deals created in your Account
• Capabilities: Filter and group using custom dimensions, metrics, and filter values.
• Required Parameters: buyerMemberId, startDate, endDate

Endpoint Summary

Depending on your needs and workflow, use the query endpoints below to request data:

Authentication

advertiserReport

Refer to the GraphQL schema for the most up-to-date information on available options.

advertiserReport Synchronous endpoints

These endpoints are designed to handle queries for low volumes of data and return results with relatively quick response times. When querying for larger volumes of data, use the Asynchronous endpoints.

Pagination

Synchronous endpoint results are paginated to a default page size of 50 rows. The size can optionally be set using the size parameter in a request (the value of which cannot exceed the row limit).

If the number of result rows is greater than the given page size, then the response will also include a nextCursor object, whose value can be passed in as the cursor field of the subsequent request.

advertiserReport

Returns reporting data (e.g. the reporting available in the Query Tool of the TripleLift Console or TripleLift Direct).

advertiserFilterOptions

Returns all possible filter values of a dimension in a given time period.

advertiserReport Asynchronous endpoints

These endpoints are designed to handle queries for high volumes of data and return results within 5 minutes. For quicker response times and low volumes of data, use the Synchronous endpoints.

There are two options to obtain a CSV report asynchronously:

1. Submit a request to an asynchronous endpoint and immediately receive a report download link. Poll a second endpoint until your report is ready at that download link.
2. Submit a request to an asynchronous endpoint and wait to receive an email containing the report.

asyncDownloadAdvertiserReport

This endpoint is used in Option 1, above. This endpoint uses the same parameters as the synchronous advertiserReport endpoint (without the pagination-related fields cursor and size) and responds with a download link in the form of a pre-signed S3 URL.

Example request:

query {
  asyncDownloadAdvertiserReport(
    buyerMemberId: "YOUR_MEMBER_ID"
    startDate: "2026-06-15" 
    endDate: "2026-07-30"
    dimensions: [YMD, DEAL_NAME]
    metrics: [DEAL_SPEND, RENDERED]
)
}

Example response:

{
  "data": {
    "asyncDownloadAdvertiserReport": "https://triplelift-reporting-api-downloads.s3.amazonaws.com/9629b338-a654-4f95-ac4f-8b9dfafeb3ca/1735843508921/triplelift_report.csv?X-Amz-Security-Token=IQoJb3JpZ2luXNyF2CRFuvpB430YDTbzZLAIgYBV4T2uFp4np4zZ471RwMNeby0c3%2By3sOTtfYmjRr%2FMqxgUI2%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FARAAGgwyNTU5OTMwMDUwOTEiDAdZ%2FwDCe8O1dvOekSqaBd9AC9BjQXtHukgmdGomyMnnW5qr72B617Xz976w10EfL3KyOyw9KRD5JSJt8Pz8FrRQ23131xlFF35YmH8OSIlvWWkNfGVJMk0vP8fvc7w99T6fgB5yF2KfMVufwH6Y8lQdd0o5%2BSLvG581NstAl7SzSaEuOIqo0j41qRkueVk2QZGX3t2lkkO4Gqmjq51lU3Oaue7Jl6D%2B%2Bag1%2BFOGGIclN%2BFvxE%2FfBVhLzC3R2GgEsIj2UBe5JMUwdubG9xuwCA09sySJecBcOYknyUT%2FuyLEPZ4IvyshDzZtqYJUW8VjnCFGxLKg5PBj6dcw7rRUVHKxv8PfAkOcyonWQv9yEg5NsDhQnxqJ8bwb9no3aL%2Bdr8EBUeAZhhazilmNpOK87sbg%2BaAxI2o4gIpaTYnAEA4hJpFu1FnNOD8pFMMZzURQaB1Rke4omarL93I7spcpWC20r%2F8vAFu7Ahf9JKt20ZKhx65Kpgvqgw5YjmWITw5K4tJjUpvnW234cuBuiFOwUaHovg%2BG9IjDuDZI5WyLCfKKe8gx3glLK6ZNF8h2FD6vUBAD8XJzo31ARDhcdytwke71h%2BlAsGng6A7Umt62mP%2B1yR%2B29Mw0bvngRjJiEk7xz%2FRFZeGkAwDL6lsmnfppzThir3BYyj0WHdpl9TzuD%2Bxy0%2BgKTJ7Amik1qSvJSfu5kHVthjIfQcD%2FOh%2Fmh4cSFP%2F7g7c24nYE1kUL4SuV2DkpbOJhWR4CNm9gloOEcTmNB79YascR%2FeogWaIO9uS9PvHN%2BlCB%2BNNDOIysQfn6h%2Foqd0AtQLp5bHP17FMzAnJk84fPhG4dBOWq56EB5ai1QC6ihsithiuerhstithre31HEadvXaXds9md9%2FPWOEBI2VbzN8Q3eG19yvzDKrdu7BjqxAWas1Pj8UcE%2B2kA42NrTK%2B3H17PnGJG%2FqXD4Rvcx2wC995mJFpJgDLOOkUNRbrp2MHjm3eshQ8F07BuDbq%2BiuI0LNuBHI0qFoK8%2FesX8mBXKURXmGRGsujZDtjNVwHhqRwmgYKjR5HeXbjUgkHfXMEkJPqupeonlfI%2Fb1Om%2B30f0E%2BT46rQxOb%2B4lK9KYFze2XQC%2Bkl19y5WU0RPD23jfqyA53T3M%2B1pNV6U%2FdjKNgdClQ%3D%3D&X-Amz-Algorithm=ABC-123-DFF&X-Amz-Date=20260815T173505Z&X-Amz-SignedHeaders=host&X-Amz-Expires=1799&X-Amz-Credential=ASIIHHEIHTIHLWH%2F20250102%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Signature=14b12cbd349dbbc36acac145778uuuuuuuuuu06f57716b15dba1814"
  }

asyncDownloadReportStatus

This is the polling endpoint mentioned in Option 1. It accepts the pre-signed S3 link in the response from asyncDownloadAdvertiserReport and returns one of 3 possible status strings:

• READY - the report is present in the download link
• WAITING - the report is not ready yet
• ERROR - the report request must be resubmitted

asyncEmailAdvertiserReport

This endpoint is used in Option 2. It uses the same parameters as the synchronous advertiserReport endpoint (without the pagination-related fields cursor and size), as well as a list of valid email addresses for the report recipients. It returns true if the request was successfully received, and false otherwise.

Example request:

query {
  asyncEmailAdvertiserReport(
    buyerMemberId: "YOUR_MEMBER_ID"
    startDate: "2026-06-15" 
    endDate: "2026-07-30"
    dimensions: [YMD, DEAL_NAME]
    metrics: [DEAL_SPEND, RENDERED]
    filters: []
    emails: ["EMAIL_1", "EMAIL_2"]
)
}

Example response:

{
  "data": {
    "asyncEmailAdvertiserReport": true
  }

What's Next

• Reporting API Changelog