Kochava for Publisher Reporting API

Run a new report with the given parameters. The result will be a report id that can be used to query the status of the report and, eventually, get the results. See Get Results for more info.

• start and end are expected to be unix timestamps
• type is optional, specifying summary returns summary style results and leaving it blank will return row level data.
• format is optional and defaults to csv, acceptable values are json and csv.

 

Endpoint:

POST: https://adsmeasurement.com/v1/report/skad
Headers:
Authentication Key: api key
Content-Type: application/json

 

Request Body:

{
  "start": 1603200000,
  "end": 1603230270,
  "type": "summary",
  "format": "csv"
}

 

Response Body:

{
  "report_id": "123456789"
}

Query the results of the report. The results may not be available which will be indicated by status on the response. Reports expire after some time at which time this endpoint will return requested resource not found.

When the report is complete links to download the files will be listed in files. The links will be valid for aproximately a week.

 

Endpoint:

GET: https://adsmeasurement.com/v1/report/skad/result?report_id=123456789
Header:
Authentication Key: 123456789

 

Response Body:

{
  "status": "running"
}

 

Response Body:

{
  "status": "failed",
  "message": "no results found for 123456789"
}

 

Response Body:

{
  "message": "requested resource not found"
}

 

Response Body:

{
  "status": "complete",
  "files": [
    "<file1>",
    "<file2>",
    "...",
    "<filen>"
  ]
}