BidRequest.site

A Site object describing the website where the impression appears: domain, page URL, publisher, and content. Recommended for browser-based inventory, and never sent together with BidRequest.app or BidRequest.dooh.

CurrentobjectRecommendedSince 2.0

Field facts

Path: site
Object: BidRequest
Type: object
Requirement: Recommended
Added: OpenRTB 2.0
Spec section: 3.2.1

How it is used

Buyers rely on Site.domain, Site.page, and Site.publisher for brand safety, ads.txt checks, and contextual targeting. Mobile web traffic still uses site, with Site.mobile set to 1; only app inventory uses app.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "site": {
    "id": "site-102",
    "domain": "news.example",
    "page": "https://news.example/sports/match-report",
    "publisher": {
      "id": "pub-4791"
    }
  }
}

Common mistakes

Sending site and app on the same request (openrtb.fields.mutually_exclusive).
Leaving out Site.publisher, so buyers cannot tie the request to the seller account in ads.txt and the supply chain.

Version history

Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	object	No	No
2.3 to 2.6-202606	object	Recommended	No

Related fields

Other BidRequest fields

For a walkthrough of the whole object, read Bid request anatomy.