Back to glossary
DOOH GlossaryDSP, SSP & Exchange

sellers.json

An SSP's published list of authorized sellers, pairs with ads.txt to make the full supply path auditable.

sellers.json is the SSP-side companion to ads.txt. It's a JSON file served at the SSP's root domain (e.g. ssp.example.com/sellers.json) that declares every account ID the SSP knows about and links each one to a seller, either a publisher (DIRECT) or another SSP (INTERMEDIARY). A DSP combines the two files to verify that the bid request's claimed supply path is real end-to-end.

The IAB Tech Lab released sellers.json in 2019, two years after ads.txt, to close the symmetric gap. Without sellers.json, a buyer could verify that publisher X authorized SSP Y, but couldn't verify that SSP Y in turn was authorized to relay through SSP Z. The full chain is reconstructable from the SupplyChain Object (schain) in the bid request, with each hop verifiable against the upstream party's sellers.json.

In practice, most fraud-prevention happens at the schain check. A DSP that sees a 5-hop schain where hop 3 isn't in hop 2's sellers.json knows the chain is forged or stale, and won't bid. Sites and networks that don't expose sellers.json get downweighted.

Trillboards publishes supply-chain declarations at trillboards.com/sellers.json so buyers and partners can inspect the entities in the inventory path. Trillboards aggregates screens and works with SSP partners to make that inventory available.

Authoritative reference

IAB Tech Lab, sellers.json

See also

Reference docs

Building against Trillboards?

Our developer reference covers the DSP API, partner SDK, proof-of-play verification, and the sensing pipeline that powers buyer-grade audience signals.

View developer docs