API Stats for Publisher/SSP

https://api.admachine.co/api/reports/?from=2024-11-01&to=2024-11-30&segment=site_id&segment_column=name&output=json&api_key={api_key}&filter[ssp_id][id][0]={ssp_id}

Request parameters

The GET Request should contain the parameters listed below:

Parameter	Type	Description
from*	Date	Report start date (format: YYYY-MM-DD). If omitted, uses current server date. Example: &from=2024-02-01
to*	Date	Report end date (inclusive, format: YYYY-MM-DD). Example: &to=2024-01-01
segment*	String	Segmentation dimension. Values: hour, day, publisher_id_original, country, site_id (equals widget_id). Example: &segment=country
output*	String	Response format: xml or json
api_key	String	Your authentication API key
ssp_id	Integer	Your SSP account identifier

*- non-obligatory parameter

Max date interval (from - to) = 30 days. The bids and requests use a probabilistic format of recording, occurring once every 100 requests.

XML Example

segment = day:

<response>
    <result>
        <record>
            <bids>38521</bids>
            <requests>293764</requests>
            <impressions>1291</impressions>
            <publisher_profit>15.266401853412</publisher_profit>
            <accepted_clicks>12530</accepted_clicks>
            <name>2019-01-01</name>
        </record>
    </result>
    <total>
        <bids>59745840</bids>
        <requests>189020410</requests>
        <impressions>568570</impressions>
        <publisher_profit>106.459150640165</publisher_profit>
        <accepted_clicks>6547</accepted_clicks>
        <name>Total</name>
    </total>
</response>

JSON Example

segment site_id:

{
  "response": {
    "result": [
      {
        "bids": 70,
        "site_id_original": "wiget_id:placehholder",
        "requests": 20,
        "impressions": 69,
        "publisher_profit": 0.15,
        "accepted_clicks": 6,
        "timestamp": "",
        "name": "wiget_id:placehholder"
      },
      {
        "bids": 100,
        "site_id_original": "351352:placehholder",
        "requests": 100,
        "impressions": 100,
        "publisher_profit": 12.32,
        "accepted_clicks": 10,
        "timestamp": "",
        "name": "351352:placehholder"
      }
    ],
    "total": {
      "bids": 1200,
      "requests": 0,
      "impressions": 70,
      "publisher_profit": 0.1550093,
      "accepted_clicks": 6,
      "name": "Total"
    }
  }