What does the sellers.json check on an ads.txt line mean?

Every record line in an ads.txt file names an advertising system and an account ID. That advertising system publishes its own file, sellers.json, saying who each of its account IDs belongs to, and buyers read both. A line whose account the advertising system does not list, or lists as something other than the line says, is one a buyer may not trust. The IAB Tech Lab's supply chain validation asks a validator to compare the two, and the ads.txt Guru validator does that for every record line that has no error.

Where you see it

In the validate/adstxt API answer, each record line with no error carries a sellers_json block with the result and its findings. The API documentation lists every field. It costs no extra tokens.

What each result means

  • Listed. The advertising system lists the account ID. Any finding below still applies.
  • Listed, ignoring case. It lists the ID, but with different capitals. Buyers compare IDs exactly, so copy the ID exactly as the advertising system writes it.
  • Not listed (IAB 12020 on a DIRECT line, 13020 on a RESELLER one). The advertising system's sellers.json does not list the account ID. Check the ID with whoever gave you the line: a mistyped ID is common, and so is an account the advertising system has closed or not added yet. On a RESELLER line the account belongs to the reseller, so the fix is usually theirs.
  • Unreadable (12010 / 13010). We could not read the advertising system's sellers.json, and the result says why. Nothing is known to be wrong with your line; it simply could not be checked.
  • Not checked. We hold no copy of that advertising system's sellers.json, usually because it is not one of the advertising systems in our registry. Nothing is said about the line.

The other findings

  • An INTERMEDIARY on a DIRECT line (12050). DIRECT says the account is yours and you are paid through it directly. If the advertising system says the account is an intermediary's, either the line should say RESELLER or the advertising system has the account's type wrong.
  • A PUBLISHER on a RESELLER line (13050). RESELLER says someone else sells your inventory through the account. If the advertising system says the account belongs to a publisher, it may be your own, and the line should say DIRECT.
  • Listed as BOTH (12040 / 13040). Allowed, but a buyer cannot tell from the sellers.json which relationship applies.
  • A different business domain (12030, DIRECT lines only). On a DIRECT line the seller should be you, so the domain the advertising system records for it should be yours: the file's OWNERDOMAIN where it has one, otherwise the domain the file was read from. It is not asked for a seller the advertising system marks confidential. The IAB Tech Lab expects this to be seen often, so it is a notice.
  • Listed more than once (12060 / 13060). The sellers.json lists the account ID twice, which the specification forbids. That is the advertising system's to fix.
  • No valid seller type. The advertising system lists the account without saying whether it is a publisher or an intermediary, so the relationship could not be checked.

Why it never makes a file invalid

These findings are reported beside the validation, not inside it: they never add to a line's errors, warnings or notices, and never change whether the file is valid. Many valid files carry a reseller's line whose account the reseller has not listed, which the publisher cannot fix, and counting that as an error would mark the file invalid for something outside its owner's control.

How fresh it is

We read the sellers.json of every advertising system in our registry each night and check against that copy, so a change an advertising system made today shows tomorrow. If its file stops being readable, we keep using the last good copy for three days before its lines say unreadable, and a file we have never been able to read says unreadable only after two nightly attempts.

To check an advertising system's sellers.json itself, against the specification, use the free sellers.json Validator.

The codes are those of the IAB Tech Lab's Supply Chain Validation for Publishers. ads.txt Guru is not affiliated with or endorsed by IAB Tech Lab.