- 2 Minutes to read
Limits
- 2 Minutes to read
Reporting API Limitations
The Yahoo DSP API enables you to run and return reports on very large data sets.
The Reporting API supports reports that are up to 20 GB in size.
500,000 row counts per day
All reports are returned as CSV files.
Returned reports are available via a URL that is valid for 24 hours after report creation.
Data Metric Limitations
Yahoo DSP API reports that return certain data metrics are subject to a 500K limitation on the rows returned.
Note
To pull reports larger than 500K rows, please contact your Yahoo account manager.
This includes reports that return the following report metrics:
53 Average Frequency
134 Filtered Impressions
135 Filtered Clicks
115 Unique Viewers
242 Moat Analyzed Impressions
243 Moat AVOC
244 Moat AVFH
245 Moat Measurability Rate
247 Moat AVOC Rate
319 Unique Converters
320 Unique Click Through Converters
321 Unique View Through Converters
399 Filtered Companion Impressions
400 Filtered Companion Clicks
453 Estimated Number of Store Visits
455 Estimated Unique Store Visitors
456 Estimated Store Visit Through Rate (VTR)
457 Estimated Cost per Store Visit (CPSv)
Data Dimension Limitations
Yahoo DSP API reports that return certain data dimensions are subject to a 500K limitation on the rows returned.
Note
To pull reports larger than 500K rows, please contact your Yahoo account manager.
This includes reports that return the following report dimensions:
The
dateTypeId
has a value of1
(Today).The
dateTypeId
has a value of10
(All Time).The
dateTypeId
has a value of11
(Custom) and thestartDate
of the report has a value that is prior to2017-08-11
.22 Postal Code
39 Targeted Audience
42 Advertiser Sub-Category
122 Mobile OS
158 Native Type
1028 Connected TV Make
1054 Package Budget Distributor
1110 Ad Serving Cost Name
1112 Audience Measurement Cost Name
1115 Other Cost Name
To learn more, refer to Resources.
Rate Limits
The DSP Reporting API is rate limited per the following quota limits:
Type | POST | GET | Description |
---|---|---|---|
Request limit per Min | 20 | 60 | Max number of reporting Requests by Method Type per User per Minute. |
Request limit per Hour | 100 | 300 | Max number of reporting Requests by Method Type per User per Hour. |
Request limit per Day | 800 | 12,000 | Max number of reporting Requests by Method Type per User per Day. Limit is for a 24 hour interval starting from the first request from any user. |
If in your normal processing, you hit one of these limits, please reach out to your Account Manager or Product Support.
They can work with you to optimize your requests. If optimizing is not successful in reducing the number of requests, they can request a small increase to the limits.
Recent Data Limitations
In order to deliver these large reports quickly, the platform must periodically preprocess and consolidate campaign data. Consequently, recent campaign data, data collected from events occurring in the previous six hours may or may not be available in reports.
If you need up-to-the-minute reporting data, you can always run reports in the Yahoo DSP console. To learn more, refer to Insights.