Statistics API

Authorization

Request parameters:

Authorization key is required for all API requests to get costs. API key should be sent in “apiKey” get-parameter. API key is unique for each user and is activated by personal manager.

Get user’s campaigns list:

GET|POST /adv/v1/campaigns

Request example:

https://panel.adness.co/adv/v1/campaigns?apiKey={apiKey}

Response example:

  • id (string) – campaign id
  • name (string) – campaign name

JSON

[{"id":"{idCampaign1}","name":"{nameCampaignId1}"},...

Get costs by campaigns:

Get costs grouped by day for requested period. Max days per request – 31.

GET|POST /adv/v1/campaigns/costs

d’s you got by “get user’s campaigns list” method

  • dateFrom (string) – period start date in Y-m-d
  • dateTo (string) – period end date Y-m-d

http://panel.adness.co/adv/v1/campaigns/costs?apiKey={apiKey}&dateFrom={dateStart}&dateTo={dateEnd}&campaigns[]={campaignId1}&campaigns[]={campaignId2}&campaigns[]={campaignId3}

Response example:

  • date (string) – date in y-m-d
  • campaign (string) – campaign id
  • cost (float) – cost in cents

JSON

{
  "result":"OK",
  "сost":[
     {
        "date":"2020-11-10",
        "campaign":"\\{campaignId1}",
        "cost":{
           cost for campaign 1 in cent by 10 november
        }
     },
     {
        "date":"2020-11-11",
        "campaign":"\\{campaignId1}",
        "cost":{
           cost for campaign 1 in cent by 11 november
        }
     },
     {
        "date":"2020-11-12",
        "campaign":"\\{campaignId1}",
        "cost":{
           cost for campaign 1 in cent by 12 november
        }
     }
  ]
}