Transfon Team
Let’s talk about transparency in digital advertising. If you’ve ever dabbled in programmatic ads, you know that figuring out who’s actually selling ad inventory can feel like detective work. That’s where Sellers.json comes in—it’s like an industry-wide phonebook for ad sellers, helping advertisers verify who they’re buying from. It was developed by the Interactive Advertising Bureau (IAB) Tech Lab to combat fraud, build trust, and clean up the digital ad space.
Sellers.json File Explained
Think of Sellers.json as a publicly accessible file hosted by ad platforms like supply-side platforms (SSPs) and ad exchanges. It lists out all the entities involved in selling digital ad inventory, making it easier for advertisers and demand-side platforms (DSPs) to confirm whether they’re dealing with legitimate sellers.
Here’s why it matters: without a tool like this, shady resellers can misrepresent inventory, making it harder for advertisers to trust where their money is going. Sellers.json helps solve this problem by distinguishing between direct publishers (who own the inventory) and intermediaries (who resell it).
Another cool feature? Offline verification—instead of bloating every bid request with seller details, ad platforms can refer to the Sellers.json file when needed, keeping transactions lightweight while still being transparent.
Before Sellers.json, advertisers had a tough time confirming who they were actually buying from. There was Ads.txt, which helped publishers specify which platforms could sell their inventory, but it had a big blind spot—it didn’t reveal who those sellers actually were. That lack of transparency opened the door for domain spoofing (where scammers pretend to be premium publishers).
To fix this, IAB Tech Lab launched Sellers.json in 2019, ensuring that advertisers could see exactly who was in the supply chain. Now, with both Ads.txt and Sellers.json, we’ve got a clearer, more fraud-resistant ecosystem.
These two standards work together, but they serve different purposes:
In short: Ads.txt controls authorization, while Sellers.json provides identity.
Sellers.json isn’t the only tool designed for transparency. Enter the OpenRTB Supply Chain Object, a real-time transparency tool that lives inside bid requests.
While Sellers.json is a static file listing all a platform’s sellers, the Supply Chain Object is dynamic—it tracks each bid request as it moves through multiple intermediaries. This way, advertisers can see the exact path an impression took before reaching them.
Together, these tools help advertisers make smarter, more informed buying decisions.
Setting up Sellers.json isn’t complicated, but there are some rules to follow. Here’s what you need to do:
SSPs and ad exchanges must host their Sellers.json file at the root domain so it’s easy to find. The URL should look like this:
https://yourdomain.com/sellers.json
It needs to be accessible via HTTP/HTTPS so advertisers and crawlers can verify seller details.
Sellers.json is written in JSON format and includes key details about each seller. Here’s what a basic file looks like:
{
"sellers": [
{
"seller_id": "123456",
"name": "Example Publisher",
"domain": "examplepublisher.com",
"seller_type": "PUBLISHER"
},
{
"seller_id": "789101",
"name": "Ad Network Inc.",
"domain": "adnetwork.com",
"seller_type": "INTERMEDIARY"
}
]
}
Sellers.json isn’t a “set it and forget it” file. SSPs and ad exchanges must update it regularly to reflect any changes in their seller relationships.
Some sellers may not want their identity made public. In this case, they can set the is_confidential
flag to 1
. However, transparency is always encouraged—advertisers prefer to work with sellers they can fully verify.
Nope! Publishers don’t need to host their own Sellers.json file. Their SSP or ad exchange will handle it for them. However, publishers should check that their information is correctly listed.
Regularly! SSPs and ad exchanges should update their files whenever partnerships change to maintain accuracy.
Yes, but transparency is preferred. Sellers can set their is_confidential
flag to 1
, but advertisers may hesitate to buy from unidentified sellers.
Using both together ensures transparency at both the macro and micro levels.
Sellers.json is a big step toward cleaning up programmatic advertising. By making seller identities public, it helps advertisers make more informed decisions, reduces fraud, and strengthens trust across the ecosystem.
If you’re in the ad tech space, implementing and maintaining Sellers.json isn’t just best practice—it’s a necessity for staying credible in a rapidly evolving industry.