Bids
POST /v2/api
Use this method to get your reporting data of the bids
Headers
Name
Value
Authorization
Basic <token>
Body
{
table: "bids",
startDate: string, // (format: YYYY-MM-DDThh:mm:ss)
endDate: string, // (format: YYYY-MM-DDThh:mm:ss)
fields: [
{ name: "timestamp", as?: string },
{ name: "account_id", as?: string },
{ name: "account_name", as?: string },
{ name: "sub_account_id", as?: string },
{ name: "sub_account_name", as?: string },
{ name: "site_id", as?: string },
{ name: "site_name", as?: string },
{ name: "tag_id", as?: string },
{ name: "tag_name", as?: string },
{ name: "auction_type", as?: string },
{ name: "mediatype", as?: string },
{ name: "inventory_type", as?: string },
{ name: "device", as?: string },
{ name: "ssp", as?: string },
{ name: "ssp_alias", as?: string },
{ name: "classification", as?: string },
{ name: "status", as?: string },
{ name: "deal_external_id", as?: string },
{ name: "placement", as?: string },
{ name: "os", as?: string },
{ name: "browser", as?: string },
{ name: "consent", as?: string },
{ name: "domain", as?: string },
{ name: "area", as?: string },
{ name: "buyeruid", as?: string },
{ name: "country", as?: string },
{ name: "customid", as?: string },
{ name: "gpid", as?: string }
],
metrics: [
{ name: "bid_requests", as?: string },
{ name: "bid_responses", as?: string },
{ name: "bid_net_eur", as?: string },
{ name: "bid_net_usd", as?: string },
{ name: "bid_gross_eur", as?: string },
{ name: "bid_gross_usd", as?: string }
],
timeSplit: "day"
}{
table: "bids",
startDate: string, // (format: YYYY-MM-DDThh:mm:ss)
endDate: string, // (format: YYYY-MM-DDThh:mm:ss)
fields: [
{ name: "timestamp", as?: string },
{ name: "account_id", as?: string },
{ name: "account_name", as?: string },
{ name: "sub_account_id", as?: string },
{ name: "sub_account_name", as?: string },
{ name: "site_id", as?: string },
{ name: "site_name", as?: string },
{ name: "tag_id", as?: string },
{ name: "tag_name", as?: string },
{ name: "auction_type", as?: string },
{ name: "mediatype", as?: string },
{ name: "inventory_type", as?: string },
{ name: "device", as?: string },
{ name: "ssp", as?: string },
{ name: "ssp_alias", as?: string },
{ name: "classification", as?: string },
{ name: "status", as?: string },
{ name: "deal_external_id", as?: string },
{ name: "placement", as?: string }
],
metrics: [
{ name: "bid_requests", as?: string },
{ name: "bid_responses", as?: string },
{ name: "bid_net_eur", as?: string },
{ name: "bid_net_usd", as?: string },
{ name: "bid_gross_eur", as?: string },
{ name: "bid_gross_usd", as?: string }
],
timeSplit: "hour"
}[
{
"timestamp": "2025-12-01T00:00:00.000Z",
"account_id": 1067,
"account_name": "Nexx360 Demo",
"sub_account_id": 2001,
"sub_account_name": "Sub Account Demo",
"site_id": 5001,
"site_name": "example-site.com",
"tag_id": "tag_def456",
"tag_name": "Article Footer",
"auction_type": "dynamic",
"mediatype": "video",
"inventory_type": "inapp",
"device": "Tablet",
"ssp": "pubmatic",
"ssp_alias": "PubMatic Video",
"classification": "premium",
"status": "won",
"deal_external_id": "deal_67890",
"placement": "footer_video",
"os": "iOS",
"browser": "Safari",
"consent": true,
"domain": "example-app.com",
"area": "us-east",
"buyeruid": false,
"country": "US",
"customid": "custom_def",
"gpid": "/67890/footer/video",
"bid_requests": "320000",
"bid_responses": "285000",
"bid_net_eur": 2850.00,
"bid_net_usd": 3135.00,
"bid_gross_eur": 3420.00,
"bid_gross_usd": 3762.00
}
][
{
"message": "'unvalid_name' must be equal to one of the allowed values for table 'bids'",
"params": {
"allowedValues": [
"timestamp",
"account_id",
"account_name",
"site_id",
"site_name",
"tag_id",
"tag_name",
"auction_type",
"mediatype",
"inventory_type",
"os",
"browser",
"device",
"ssp",
"ssp_alias",
"size",
"consent",
"buyeruid",
"domain",
"adomain",
"deal_external_id",
"country"
]
}
}
]Last updated
Was this helpful?