OpenAdLibraryOpenAdLibrary
Definition

sellers.json

sellers.json is a public file that exchanges and SSPs publish to declare the sellers and intermediaries they represent, so buyers can see which entity the platform says stands behind each seller ID.

sellers.json — ad-tech glossary illustration

sellers.json is a public file that an ad exchange or Supply-Side Platform publishes to declare the sellers and intermediaries it represents, including confidential ones, and the account IDs they use in its system. Created by the IAB Tech Lab, it is the seller-side complement to ads.txt: ads.txt is hosted by publishers to declare which companies they authorize to sell their inventory, while sellers.json is hosted by the platforms to say which entity stands behind each seller ID.

How it works#

The file lists each seller account ID with its type, marked as PUBLISHER, INTERMEDIARY, or BOTH, and, unless the entry is confidential, the name and, where the seller has a web presence, the domain of the legal entity that is paid under that ID. A buyer who sees a seller ID in a bid request can look it up in the exchange's sellers.json to see which entity the exchange says that ID represents. Entries marked confidential can omit the name and domain, so they do not identify the seller. Each listing is the platform's own declaration and can be incomplete or out of date, so buyers check it against the publisher's ads.txt and the request's SupplyChain object rather than treat it as proof that a seller is authorized or trustworthy.

Why it matters#

sellers.json helps buyers identify the declared entities behind the seller IDs in a bid, which can expose chains of resold inventory and demand partners that would otherwise be opaque. Combined with the SupplyChain Object (schain), which lists, in order, the entities in the direct flow of payment for a bid request's inventory and carries a flag for whether the chain is complete, it shows who declared a part in selling an impression, except where entries are confidential. Neither standard carries fees or margins, so they cannot show who took what margin. IAB Tech Lab describes these standards as part of a broader effort to eliminate the ability to profit from counterfeit inventory; buyers use them to look for undeclared or unauthorized resellers and to support supply path optimization, but they reduce some risks rather than detect or remove fraud on their own.

Related terms: ads.txt, SupplyChain Object (schain), and Resold Inventory / Demand Partner.

The OpenAdLibrary Team
Written byThe OpenAdLibrary Team
Ad intelligence & native advertising research

We build OpenAdLibrary, the open ad-transparency platform. Every day our systems capture live native ads across Taboola, Outbrain, MGID, Revcontent, Teads, Yahoo and MSN, identify the real advertiser behind each one, and follow the click to its landing page. These guides distill what we see in that data so you can research the market faster.