GZIP Compression

GZIP (short for GNU zip) is a compression format that has found widespread adoption for bid requests and bid responses. This helps programmatic exchanges, as well as demand partners, save about 30% of network bandwidth.

Getting Started with GZIP

GZIP is used at the HTTP transport layer; the uncompressed payload remains OpenRTB JSON.

Accepting Compressed Bid Requests

If you have been receiving uncompressed traffic and would like to switch to compressed traffic, please contact your Account Manager.

Please Note: We require all new DSPs to handle GZIP compressed bid requests.

Compressed bid requests will contain Content-Encoding: gzip in the HTTP header to indicate compression being applied.

To test your handling of compressed bid requests, you can use this compressed bid request sample and execute the following command:

Sample file:

curl --verbose --request POST \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "Content-Encoding: gzip" \
  --data-binary @bid-request.json.gz \
  https://bidder.example.com/openrtb

You can choose to respond with non-compressed or compressed bid responses; the option of responding compressed is indicated by Accept-Encoding: gzip being included in the request’s HTTP header.

If you send a compressed bid response, include Content-Encoding: gzip in the response headers to indicate that the response body is compressed.