Limits

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 of 1 (Today).

  • The dateTypeId has a value of 10 (All Time).

  • The dateTypeId has a value of 11 (Custom) and the startDate of the report has a value that is prior to 2017-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.