# sellers.json

> A file where an ad seller lists all the sites it sells for.

**Field:** Marketing & SEO  
**Category:** Media & Ad Tech  
**Also known as:** Sellers.json, Sellers JSON

## Think of it like

It is like a seller's own list of the shops it works for. You can check it matches each shop's list.

## Definition

Sellers.json is a public file that an ad seller, such as an SSP, puts on its own website. It lists every site and company it sells ad space for, with an ID for each one. A buyer can match the ID in a bid request to a real, named seller. Ads.txt is the site's list of its sellers. Sellers.json is the seller's list of its sites. Together they show the path the money takes.

## Example

An SSP's sellers.json shows that account 4052 belongs to a recipe site, example.com. A buyer sees 4052 in a bid request and knows who gets paid.

## Example code

```json
{
  "sellers": [
    {
      "seller_id": "4052",
      "name": "Example Recipes Ltd",
      "domain": "example.com",
      "seller_type": "PUBLISHER"
    }
  ]
}
```

One seller in the list: its ID, its name, its site, and the fact that it owns the space it sells.

## Why it matters

It shows who is really behind each sale. Hidden middlemen and fake sellers are easier to spot.

## Common mistake

Marking sellers as private to hide them. A buyer cannot check a seller it cannot see.

## Three principles

- **The seller's list.** Every site it sells for, by ID.
- **Matches ads.txt.** The same IDs appear in both files.
- **Names in public.** Buyers can see who gets paid.

## Related terms

- [ads.txt](https://learn.benibix.com/term/marketing/ads-txt)
- [Supply-Side Platform (SSP)](https://learn.benibix.com/term/marketing/supply-side-platform)
- [Ad Fraud](https://learn.benibix.com/term/marketing/ad-fraud)
- [Programmatic Advertising](https://learn.benibix.com/term/marketing/programmatic-advertising)
- [Real-Time Bidding (RTB)](https://learn.benibix.com/term/marketing/real-time-bidding)

## Told apart from

- [ads.txt vs sellers.json](https://learn.benibix.com/compare/ads-txt-vs-sellers-json): People think ads.txt and sellers.json are the same file, and they are not. A site puts ads.txt on its own web address. It lists who may sell the site's ad space. An ad seller puts sellers.json on its own address. It lists every site it sells for. A buyer checks that both lists agree.

![On the left, a news site with its ads.txt file, which lists the sellers allowed to sell its space. On the right, a seller with its sellers.json file, which lists the sites it sells for. In the middle, a buyer checks both lists. Below, a fake seller that is on neither list gets no bid.](https://learn.benibix.com/diagrams/media-supply-files.svg)

---

Source: https://learn.benibix.com/term/marketing/sellers-json
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-20
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
