Ad Sellers

Search for ad seller records from sellers.json files.

Search Syntax

Terms

nytimes.com aol.com

Search by ad system, seller ID, type, name, domain, and comment. When there are multiple terms only one needs to match.

Phrases

"New York Times"

Surround terms in quotes to search for a phrase.

Require and Exclude

nytimes.com aol.com +PUBLISHER

Add + before a term or phrase to require it, or - to exclude it.

Prefix

nyt*

Add * after a term or phrase to search by prefix.

Filters

type:PUBLISHER aol.com

Filters restrict results based on specific fields. They are written in the form [filter]:[value].

Filters act as required terms by default, but can be excluded instead by adding - before the filter.

Most filters accept terms or phrases as values (including support for prefixes). Providing only * as a value will match resources where the relevant field exists, regardless of its value.

Some filters can only check if a field exists, so only work with * value. Others filter on boolean fields, so only work with true or false.

Exclude

-type:PUBLISHER aol.com

Filters act as required terms by default, but can be excluded instead by adding - before the filter.

Multiple Options

type:(PUBLISHER BOTH) aol.com

Wrap terms or phrases in parenthesis to supply multiple options to a filter. Only one option needs to match.

Date Filters

fetched:>=2021-06-01 aol.com

Date filters accept RFC3339 formated dates in UTC.

Prefix the date with <, <=, >, or >= to filter by range.

Seller Filters

missing:[true|false]
Filter by whether the seller is missing from the latest sellers.json.

fetched:[date]
Filter by seller fetch date.

system:[value]
Filter by ad system.

seller:[value]
Filter by seller ID.

account:[value]
Filter by the full account ID, in the form [ad system]|[seller id].

type:[PUBLISHER|INTERMEDIARY|BOTH]
Filter by seller type.

confidential:[true|false]
Filter by whether the seller is confidential.

passthrough:[true|false]
Filter by whether the seller is a passthrough account.

name:[value]
Filter by seller name.

domain:[value]
Filter by raw seller domain.

norm_domain:[value]
Filter by normalised seller domain.

base_domain:[value]
Filter by base domain (eTLD+1) of normalised seller domain.

etld:[value]
Filter by effective top-level domain (eTLD) of normalised seller domain.

comment:[value]
Filter by seller comment.

Back to top