Open navigation

Supermetrics data source historical range, API, and refresh window limits

We've listed below the different limits for historical ranges, API delays, and recommended refresh windows of data available from different data sources. 


Please note that this list is not exhaustive. 



Data source
Historical range (HR), API delay, and recommended refresh window where available
Ad Data + Google Analytics
HR: Depends on the selected data sources — please see data source specific historical ranges.
AdformHR: Last 397 days of data.
Adobe AnalyticsHR: Lifetime, but Adobe best practice is to pull historical data by incrementing it regularly instead of requesting the entire data set at once.
Adobe Analytics 2.0HR: Lifetime, but Adobe best practice is to pull historical data by incrementing it regularly instead of requesting the entire data set at once.
AdRollHR:The AdRoll API doesn't provide data older than 2012-01-01.
AhrefsHR: Only dates that involve first, last, and previous crawls of the links.
BigQueryHR: Depends on data in data warehouse.
Bing Webmaster ToolsHR: The longest available dataset period is 6 months.
CallRailHR: Account lifetime.
CriteoHR: Last 2 years.
Database (Google Apps Script)HR: Historical limits will be based on what data is available in the database.
Facebook Ads

The Facebook Ads API doesn't provide:

- Data older than 2012-09-28

- Demographic data older than 2013-01-01

- Device data older than 2014-07-03

- Ad insights data older than 37 months (reference)

Facebook Audience NetworkHR: Last 540 days of data.
Facebook Insights

HR: Though it doesn't appear to be recorded anywhere, organic reach values are not tracked before October 2017 (and maybe sooner, it could be a rolling window).

Insights only retains last 2 years of data, older data is subject to removal.


API delay: 0-4 days


Refresh window: 5 days

Facebook Public DataDue to the post feed limitation in the Graph API: The API will return approximately 600 ranked, published posts per year.
Google Ad ManagerHR: Up to 3 years of data.
Google AdSenseHR: Last 3 years.
Google AdsHR: No known limits, assumed to be account lifetime.
Google AnalyticsHR: For most data, there is no limit after 2005-01-01.

By default user and event data are deleted after 26 months. This can be changed.

Google Analytics 4HR: User-level data, including conversions, is deleted after 14 months and age, gender, and interest data after 2 months. For all other event data, you may choose the length of retention to be 2 or 14 months. Read more
Google Campaign Manager 360

HR: 2 years for most data; 60 days for Floodlight reports, Multi-channel Funnel reports, and Path to conversion reports. 31 days for keyword data.


API delay: 1 day


Refresh window: 3 days

Google Display & Video 360

Default: Last 2 years of data

Floodlight report: Last 2 months of data

Google My BusinessHR: Last 18 months of data.


API delay: 2 days


Refresh window: 4 days

Google Search Ads 360HR: Last 2 years of data.
Google Search ConsoleHR: Last 16 months of data.


API delay: 2 days


Refresh window: 4 days

HubSpotHR: Account lifetime.
Instagram Insights

HR: Stories disappear after 24 hours. Metrics data stored for up to 2 years. Media endpoint gets a maximum of 10,000 of the most recently created objects.


API delay: 0-4days


Refresh window: 5 days

Instagram Public Data 2HR: Profile posts up to 2 years old; Stories disappear from results after 24 hours. Post Search fetches posts published in the last 24 hours, to a maximum of 250 posts.
JSON/CSV/XML
HR: Historical limits depend on the API/web service you are connecting to. Please check documentation for the source system.
LinkedIn Ads

HR: Non-demographic data available for last 10 years. Daily demographic-based analytics available for the last 6 months, and all other granularities for 2 years.

LinkedIn Company Pages

HR: Non-demographic data available for last 10 years. Daily demographic-based analytics available for the last 6 months, and all other granularities for 2 years.

MailchimpHR: No known limits, assumed to be account lifetime
Microsoft Advertising

HR: Max 3 years of data, but depends on the report type. More information in Microsoft Advertising API docs.

MozHR: No historical data available in the API, all data is current-state.
NetvisorHR: No known limits, assumed to be account lifetime.
OptimizelyHR: Project lifetime.
Outbrain AmplifyHR: Account lifetime.
PayPalHR: Account lifetime.
Pinterest AdsHR: Unclear in API documentation, but UI reporting only allows up to past 25 months of data, in some cases can be up to a year before current date.
Pinterest Organic

HR: Can fetch data from up to a year ago. For Pins and Boards metrics up to last 6 months.

Pinterest Public DataHR: Only reports lifetime metrics. Can only get 50 pins per user.
Quora AdsHR: No known limits, assumed to be account lifetime.
Reddit Public DataHR: Only fetches current state of board/user/etc. No historical data
SalesforceHR: No known limits.
SearchmetricsHR: There are some historical fetches, but limitations depend on report type. See Searchmetrics documentation for more specifics.
Semrush Analytics

HR: Can pull data from US databases from 2012 forward, other locations historical range may be less. Users can pull current data (today), and some report types allow for pulling from past months — please note that this costs more credits.

Semrush Projects

HR: Can pull data from US databases from 2012 forward, other locations historical range may be less. Users can pull current data (today), and some report types allow for pulling from past months — please note that this costs more credits.

ShopifyHR: No documented limit but practical limits apply (the cost of the query). See Shopify API docs for more information.
Snapchat MarketingHR: No known limitations.


API delay: 2 days


Refresh window: 4 days

SnowflakeHR: Historical limits will be based on what data is available in the data warehouse.
StackAdaptHR: No known limits, assumed to be account lifetime.
StripeHR: No known limits, assumed to be account lifetime.
TaboolaHR: No known limits, assumed to be account lifetime.
Tumblr Public DataHR: Only fetches current state of blog. No historical data other than retrieving older posts.
Twitter AdsHR: Account lifetime, though 30-day fetches are recommended.


API delay:  2 days


Refresh window: 4 days

Twitter Premium

HR: Up to last 90 days for impressions and engagements data. 3200 Tweet limit, which includes retweets and replies. See also Twitter Premium limitations and rate limits.

Twitter Public DataHR: Will fetch approx. the last 2000 tweet items (includes retweets and replies), starting from the end date given and moving backwards.
Vimeo Public DataHR: No known limits.
VKontakte Public DataHR: Only fetches current state of board/user/etc. No historical data is available.
Yahoo DSP
HR: Can fetch data up to 2 years; data older than that is purged and cannot be requested.
Yahoo Native Ads
HR: Last 400 days
Yandex.DirectHR: Statistics are available for the last 3 years.
Yandex.MetricaHR: No known limits.
YouTubeHR: No known limits, assumed to be channel lifetime.

API delay: 3 days

Refresh window: 5 days


    

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.