Seat service
Important
This feature is currently in Closed Beta. If you are interested in participating, please reach out to your Xandr representative.
The Buyer Seat ID product allows for external bidders to bid with their custom buyer IDs rather than using Xandr member IDs. This allows external bidders to utilize buyer IDs from their own systems when bidding on Xandr inventory and will allow for more seamless reporting and deal set up.
The seat service is a brand new API service used to register new seats for a bidder. This can be done manually through post calls to the API or done in real time when a bidder bids with a new seat id in the bid response.
Seat Service is used to store a bidder's seat IDs. These seat IDs will be used in the bid response and logged in transaction reporting.
HTTP Method | Endpoint | Description |
---|---|---|
GET | https://api.adnxs.com/seat/BIDDER_ID |
To see all of your seats attached to your bidder |
GET | https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID |
To see an existing seat using API seat identifier |
GET | https://api.adnxs.com/seat?bidder_id=BIDDER_ID&code=SEATCODE |
To see an existing seat using API bidder seat id |
POST | https://api.adnxs.com/seat/BIDDER_ID |
Add a new seat |
PUT | https://api.adnxs.com/seat/BIDDER_ID/SEAT_ID |
Modify an existing seat using API seat identifier |
PUT | https://api.adnxs.com/seat?bidder_id=BIDDER_ID&co6de=SEATCODE |
Modify an existing seat using bidder seat id |
Field | Type | Description |
---|---|---|
bidder_id |
int | The ID of the bidder. This is a read-only field. |
code |
string | Bidder seat id. |
id |
int | The ID of the seat. This is a read-only field. |
name |
string | Name of the buyer for this seat. Note: In auto registered seats, the standard naming convention will be seat_code (bidder name) |
The below example API calls show how you can upload new seats or edit existing seats:
$ cat seats.json
{
"seats": [{
"bidder_id": 1,
"code": "sdfg54VVsh",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 129,
"code": "54Gfa762Gbse",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
$ curl -b cookies -c cookies -X POST -d @seats.json "https://api.adnxs.com/seat/1"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}
$ cat seats.json
{
"seats": [{
"bidder_id": 1,
"code": "sdfg54VVsh",
"name": "Bidder seat name"
}
]
}
$ curl -b cookies -c cookies -X PUT -d @seats.json "https://api.adnxs.com/seat/1/11"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "Bidder seat name"
}
]
}
}
$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1/22"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}
$ curl -b cookies -c cookies -X GET "https://api.adnxs.com/seat/1"
{
"response": {
"status": "OK",
"num_elements": 100,
"seats": [
{
"bidder_id": 1,
"code": "sdfg54VVsh",
"created_on": "2018-12-13 15:31:13",
"id": 11,
"last_activity": "2018-12-13 15:31:13",
"name": "sdfg54VVsh(Bidder)"
},
{
"bidder_id": 1,
"code": "54Gfa762Gbse",
"created_on": "2018-12-13 17:09:26",
"id": 22,
"last_activity": "2018-12-13 17:09:26",
"name": "54Gfa762Gbse(Bidder)"
}
]
}
}