Historical data limitations by connector#
This page summarizes how far back you can fetch data for each connector, and any per-request date range limits that affect backfills and initial data loads. Limits are imposed by the underlying platform APIs and cannot be changed in Adverity.
For setup instructions and full limitations for a specific connector, see the individual connector guides.
Connector |
Historical data available |
Notes |
|---|---|---|
Up to 397 days |
Maximum 10 metrics per datastream |
|
Up to 60 days |
— |
|
Most recent 13 months (event-level data) |
— |
|
Varies by granularity |
See Apple Search Ads below |
|
Up to 2 years in total |
Maximum 1 year per individual report |
|
Data retained for up to 3 years |
Maximum date range per request is 100 days |
|
No stated limit |
Start date and end date cannot be the same; when fetching a single day, set the start date to the day before and filter the results accordingly |
|
Up to 37 months |
Reach metrics with breakdown dimensions (age, gender, country, placement, device) are limited to the last 13 months |
|
Varies by report type |
See Google Campaign Manager 360 below |
|
Varies by report type |
See Google Display & Video 360 below |
|
No stated limit |
When backfilling, fetch in increments of no more than one year at a time and wait for each fetch to complete before starting the next |
|
Demographic data retained for up to 2 years |
Deleted campaigns are not returned by the API and cannot be fetched historically |
|
Varies by granularity |
See Microsoft Ads below |
|
Up to 3 years per request |
— |
|
Varies by granularity and report type |
See Pinterest below |
|
Up to 24 months |
Reach and frequency data is only available from June 2024 |
|
Delivery Insights data available from 1 January 2020 |
See Snapchat below for metric-level cutoffs and retention limits |
|
Varies by granularity |
See Spotify Ads below |
|
Hourly data retained for 90 days |
For data older than 90 days, use daily or higher granularity |
|
Data Element reports limited to a maximum date range of 100 days |
Maximum of 100 report schedules per partner API account |
|
No stated limit |
The date range of a single fetch cannot exceed 365 days |
|
Up to 90 days per request for some endpoints |
To fetch longer periods, split the fetch into multiple 30-day windows |
|
Varies by report type; most standard report types support several years |
See the Xandr documentation for per-report retention details |
|
Up to 3 years prior to the current month |
— |
Connectors with granularity or report-type dependent limits#
Apple Search Ads#
The availability of historical data depends on the report granularity:
For weekly and monthly granularity, historical data is available for up to 24 months.
For daily granularity, historical data is available for up to 90 days.
For hourly granularity, historical data is available for up to 30 days.
Google Campaign Manager 360#
The availability of historical data depends on the report type:
Data availability |
Report types |
|---|---|
730 days |
Most reporting data, including Reach and Unique Reach reports |
60 days |
Floodlight reports, Path to Conversion (P2C) reports, and The Attribution Modeling Tool |
31 days |
Keyword data |
Google Display & Video 360#
The availability of historical data depends on the report type:
Data availability |
Report types |
|---|---|
730 days |
Most reporting data, including Reach and Unique Reach reports |
98 days |
Audience performance reports |
60 days |
Floodlight reports and Keyword data |
30 days |
Inventory Availability reports |
Microsoft Ads#
The availability of historical data depends on the report granularity:
For daily, weekly, monthly, yearly, and aggregated reports, historical data is available for up to 36 months.
For hourly reports, historical data is available for up to 6 months.
Pinterest#
The availability of historical data depends on the report granularity and type:
For non-hourly granularity, you can fetch data from up to 914 days before the current date. The maximum date range per request is 186 days.
For hourly granularity, you can fetch data from up to 8 days before the current date. The maximum date range per request is 3 days.
For product-level (
PRODUCT_ITEM) reports, you can fetch data from up to 92 days before the current date. The maximum date range per request is 31 days.
Snapchat#
Snapchat data availability depends on the metric type:
Delivery Insights data is available from 1 January 2020. Some metrics have later availability start dates:
Country and OS metrics breakdown is available from 24 October 2022.
Viewability metrics are available from 1 April 2021.
Reach metrics do not support monthly aggregation.
Data collected via Lead Gen Ads is not stored for more than 30 days.
Spotify Ads#
The maximum date range per request depends on the selected time granularity:
For Lifetime and Day granularity, the start and end date must be within 90 days of each other.
For Hour granularity, the requested date range must fall within the last 2 weeks.