Combine Demand, Data, market intelligence and supply-chain records

Use Demand to buy and serve media, campaign delivery to measure the purchased campaign, market intelligence to inspect observed quotes, and the Data API for separately authorized datasets. Each interface keeps its existing account, entitlement and measurement definitions.

Match the credential to the work

WorkInterfaceCredential
Planned advertiser campaign/openrtb/v2/buyingAdvertiser OAuth token for that exact resource.
DSP opportunities, bids and seat reports/openrtb/v2Platform key linked to the DSP seat and route scopes.
Supplier organization and devices/v1/partnerExisting partner key and permissions.
Licensed data reads and streaming/v1/data and the documented Data productsData key and the requested dataset/operation entitlement.
Supply-chain declarationsPublished seller files and bid request schainPublic declarations and the exact transaction's supply-chain metadata.

A DSP key does not identify a paying advertiser. A market benchmark or campaign report does not grant licensed raw-data access. Follow the security declaration of the operation in the Data reference or Demand reference.

Query market intelligence for a bid decision


curl --fail-with-body -sS \
  'https://api.trillboards.com/openrtb/v2/market/cpm-benchmarks?days=30&country=US&state=NY&granularity=daypart' \
  -H "Authorization: Bearer $TRILLBOARDS_API_KEY"

curl --fail-with-body -sS \
  'https://api.trillboards.com/openrtb/v2/market/demand-analysis?days=30&country=US&state=NY&limit=10' \
  -H "Authorization: Bearer $TRILLBOARDS_API_KEY"

Both market reads support days (1–90 periods of 24 completed UTC hours ending at coverage.as_of), country, state with country and venue_type. CPM benchmarks use granularity (none, daily, daypart). Demand analysis uses limit for category ranking and returns the seven UTC daypart groups.

These reads describe the top bid on observed outbound responses joined to their exact auction attempt. CPM is price per thousand in each row's own currency. Currency groups remain separate. Geography comes from the observed attempt, and the overview uses the same filter cohort.

sample_size counts priced responses. bid_volume sums the bids in the observed response cohort. Categories use actual creative classifications, with classified and unclassified coverage reported separately. A response with several venue classifications can contribute to more than one venue group; do not sum those groups into a unique response total.

The seven dayparts are UTC for these market endpoints. Read coverage.window, as_of and observed_last_response_at to distinguish the query window from the latest observed quote. The latest completed hour must have refreshed within fifteen minutes. Simultaneous identical requests share the same bounded read. coverage.window_basis is completed_utc_hours; missing required hours or a stale recent-hour refresh return 503, while a fully measured empty window returns zero. Historical hours refresh daily; coverage.oldest_snapshot_at gives the oldest hourly refresh start in the window.

This quote cohort does not measure fill, completion or a segment-premium baseline. Those fields return null, not estimated percentages. Use the issued-opportunity funnel for its own measured rates, and campaign delivery for the purchased campaign.

Read licensed data using its existing contract

Start with the Data quickstart. For example:


curl --fail-with-body -sS 'https://api.trillboards.com/v1/data/screens?limit=5' \
  -H "X-API-Key: $TRILLBOARDS_DATA_API_KEY"

Use the returned screen identifiers when relating authorized planning or measurement reads to inventory. Consult the exact dataset's dimensions, measures, units, time window, timezone and watermark. Keep distinct reach counts at their returned grain; adding daily distinct counts does not produce flight reach.

The campaign delivery endpoint already returns the canonical campaign measurement and its source reconciliation. Use that result for consistency with the portal and campaign exports. Request a Data dataset when the task needs that dataset; do not substitute a second set of campaign formulas.

Verify supply-chain identity for the actual route

Inspect the published declarations:


curl --fail-with-body -sS https://api.trillboards.com/sellers.json
curl --fail-with-body -sS https://api.trillboards.com/app-ads.txt

Read the exact bid request's supply-chain object and seller identifiers against those declarations. The transaction's configured supply route supplies the chain. Inventory connection class and company ownership do not by themselves determine the seller/payment chain.

Keep seller, publisher, screen, deal and connection identifiers distinct. Preserve an upstream chain when the route provides one; a catalogue source label cannot prove a complete chain. Use the route's returned supply-chain metadata and the current declarations instead of constructing a chain from a brand name or inventory class.

Reconcile results at the right grain

Use the metric dictionary before comparing campaign delivery, DSP reports, market quotes or Data exports. Preserve measured zero, unmeasured null, report freshness and partial outcomes. An unavailable dependency is exposed through that operation's coverage, degraded fields or unavailable error; it does not mean an observed empty cohort.