Ad Quality Raw Data API

The Ad Quality Raw Data API enables you to pull impression-level data from Ad Quality to use on your internal BI platform.

How to use the API

• Pulling the Ad Quality raw data is done in 2 steps:

1. 1. Make an API request which returns a URL link to download the report
   2. Download the report by clicking on the provided link

• Each API call must be made for each individual app and  a single date
• The data for each date is stored and available for 14 days
  • Example: Data for January 1st will be available until January 14th
• Data for any given date will only be available the following day from 08:00 AM UTC. Make sure to only call the API after this time
  • Example: The data for January 1st is only available on January 2nd, after 08:00 AM UTC
• Data will continue to be updated for a period of 2 days after they become available. After that, they will not change.
  • Example: The data for January 1st will update on January 2nd and January 3rd. After January 3rd, the data will not change
• Date & App Key aren’t included in the report as they are unique per report (file)

API request for report URL

Authentication Type

Bearer API authentication

Method

GET https://ad-quality.soomla.com/api/rawdata/v1?

Required Parameters 

Request Example URL

request GET 'https://ad-quality.soomla.com/api/rawdata/v1?appKey=c0492d05&date=2022-07-12'

Response Example URL

{
   "urls": [
       "https://ad-quality-raw-data-api.s3.amazonaws.com/production/daily_dumps/2022-07-06/4/appkey%3Dc0492d05/20220707_070020_00066_jht7e_bucket-00000.gz?AWSAccessKeyId=ASIAZF2UTGTCQF2VSIVE&Expires=1657212469&Signature=u%2F2qOWmVw3iC2v21nqRYnOE443s%3D&x-amz-security-token=FwoGZXIvYXdzELv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDJtzCMfRJtv%2B7dCGjyLkAQX4BODoGx%2F92huTOXt86j31N1mrr2UvKuD9Qi5w1Kzu0B%2FfBrXlk4in64Z53Iy%2BOR1A5cGxvu25LObGXreMeCfdLz1S5p4WOM1ldmKgkWxYMvU01obpj3dvUXob4G1Gz13Uf5Go9B7THZlVV6g8Mhduk7zpIqYRmwYDCq4U2WBeN%2BKiJOT6Rf2SRDvpDXQJDW1bl%2FV4UfYFJUz8s%2B1HIVxmeVmrIzJVevD35Wjh4dGHuD0OTRSEL7NsTjzqtTZs7mUIWjqV2aJh8l8Rz%2BwG3d%2FGtgblKJ%2Fi3wE5X0xJjkQNJgm6WCiW1pqWBjIyuheodw%2FxNLedYFcSY7wuJa6iKhxdZQwumUZgp1TS0j2kfu8eSPe6D0jvsGhlpk4zYms%3D"
   ],
   "expiration": "2022-07-07 18:47:49"
}

Fields Definition

This table displays the fields that will show in the reports once you pull the Ad Quality raw data. For each you can see a description and an example of what it will contain. 

Simply click the URL that was pulled via the steps above to download the report.