Third-party data insights

The Data Insights GraphQL API empowers data providers with real-time visibility into the status of their data throughout its lifecycle. Whether you're tracking ingestion, ensuring availability within the user interface, or confirming readiness for bidding, this API provides actionable insights to streamline your data workflows. With these insights, you can make informed decisions, resolve issues faster, and maximize the value of your data investments.

This API returns the following types of counts:

• activeCounts (IDs seen in active bidding in the last 7 days)
• hitCounts (every ingestion event, without deduplication, over windows of 1, 7, 30, and 180 days)

For full definitions, see ID counting methodologies.

TIP: If you are new to GraphQL, check out our GraphQL API Resource Hub and familiarize yourself with the basics, such as query anatomy, authentication, rate limits, and more.

Query example

The following query retrieves targeting data insights for a specific third-party data element.

query GetThirdPartyDataExample($targetingDataId: ID!) {
  targetingDataSegment(id: $targetingDataId) {
    targetingDataInsights {
      activeCounts {
        devices
        persons
        households
      }
      hitCounts {
        hitCount180Day
        hitCount30Day
        hitCount7Day
        hitCount1Day
        lastHitTime
      }
      lastUpdatedAtUTC
    }
  }
}

FAQs

What ID do I use for targetingDataId?

Use the ThirdPartyDataId value, the numeric ID The Trade Desk assigns to your segment. Do not use the ProviderElementId value, which you assign when you design your taxonomy. To look up a segment's third-party data ID, use POST /v3/thirdpartydata/query.

Can I see these insights without writing a GraphQL query?

Yes. In the Segments Dashboard, click the menu button next to a segment and select Show Segment Details to view its activity metrics without querying the API.