Bid request endpoint (POST method)

post

https://csr.onet.pl/{network_id}/bid

Endpoint for requesting ad offers. Accepts OpenRTB-compatible bid request
as JSON in request body.

POST method reads JSON directly from request body (more efficient for large requests).

Performance: POST is recommended for requests with large keyvalues or multiple impressions.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

network_id

string

required

Network identifier (e.g., "1746213")

Body Params

OpenRTB 2.5 compatible bid request

OpenRTB 2.5 compatible bid request.

Validation: See api/http/openrtb.go:ValidateBidRequest()

string

required

Unique identifier for bid request.
Required field - returns missing.bid_request_id error if missing.

imp

array of objects

required

length ≥ 1

Array of impression objects representing ad slots.
Required field - returns missing.imp error if empty.

imp*

site

object

Website/site object providing context for the ad request

user

object

User object providing information about the user

integer

enum

Defaults to 1

Auction type (1 = first price, 2 = second price)

Allowed:

tmax

integer

1 to 5000

Defaults to 800

Maximum time in milliseconds to submit a bid.

Default: 800ms
Adbeta mode (when ext.adbeta is non-empty): 2000ms
Server-side timeout context is created based on this value
Server write timeout: 800ms

regs

object

Regulatory information (GDPR, privacy, etc.)

ext

object

Request extension fields.

Responses

204

No Content - no available ad offers

200Success - returned one or more ad offers

400Bad Request - validation errors

500Internal Server Error

504Gateway Timeout - request processing exceeded timeout limit