Open navigation

Supermetrics data source historical range limits, known API delays, and refresh window recommendations

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


A standard Supermetrics license supports as much history as each data source allows (data warehouse, cloud storage, and data lake licenses are an exception with an upgradable limit of 2 years).


The refresh window determines how many days of data will be updated every time the data is refreshed. Learn more about refresh windows.


Please note that this list isn't exhaustive. If a data source doesn't have a recommended refresh window, 3 days is a good starting point. 



Data source
Historical range (HR), API delay, and recommended refresh window where available
Ad + Google Analytics Data
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.
Apple Search Ads

HR:

  • Up to 24 months on a monthly level and overall
  • Up to 365 days on a weekly level
  • Up to 90 days on a daily level
BigQueryHR: Depends on data in the 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)

Refresh window: Set to the maximum of your attribution windows on the platform.

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 DataHR: Due to the post feed limitation in the Graph API, it 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.

Refresh window: Set to the maximum of your attribution windows on the platform.

Google AnalyticsHR: For most data, there is no limit after 2005-01-01.
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

Google TrendsHR: Returns data from 2004 onwards and only the last 31 days for Daily Trends.
HubSpotHR: Account lifetime.
Instagram Insights

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


API delay: 0-4 days


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/XMLHR: Historical limits depend on the API/web service you are connecting to. Please check the documentation for the source system.
LinkedIn Ads

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

Refresh window: Set to the maximum of your attribution windows on the platform.

LinkedIn Company Pages

HR: Non-demographic data available for the 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.

Refresh window: Set to the maximum of your attribution windows on the platform.

MozHR: No historical data is available in the API. All data is current-state.
OptimizelyHR: Project lifetime.
Outbrain AmplifyHR: Account lifetime.
PayPalHR: Account lifetime.
Pinterest AdsHR: UI reporting only allows up to the past 25 months of data, in some cases can be up to a year before the current date. API allows 30 months of data for non-hourly breakdowns.

Refresh window: Set to the maximum of your attribution windows on the platform.

Pinterest Organic

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

Pinterest Public DataHR: Only reports lifetime metrics. Can only get 50 pins per user.
Quora AdsHR: Quora Ads has a limit of 2000 requests per hour. Learn more in Quora's documentation.

Refresh window: Set to the maximum of your attribution windows on the platform.

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 the 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.

Daily demographic-based analytics are only available for the last 6 months.
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.
The Trade DeskHR: API can only pull data created on or after June 20, 2017. Supermetrics supports the last 180 days from the first client login.

For example, if you connect The Trade Desk to Supermetrics for the first time on January 1, 2022, the oldest date you can pull data from is 180 days before that. This will stay the same for as long as you use this connector.
TikTok AdsHR: Account lifetime

API delay: Spend-related metrics have a latency of 48 hours. Learn more about data latency in TikTok Ads' documentation.
TikTok OrganicHR: Last 60 days
Tumblr Public DataHR: Only fetches current state of blog. No historical data other than retrieving older posts.
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.

Vimeo Public DataHR: No known limits.
VKontakte Public DataHR: Only fetches current state of board/user/etc. No historical data is available.
X Ads (Twitter)HR: Account lifetime, though 30-day fetches are recommended.


API delay: 2 days


Refresh window: Set to the maximum of your attribution windows on the platform.

X Organic (Twitter)HR: Up to last 90 days for Tweet engagement.
X Public Data (Twitter)HR: Will fetch approx. the last 2000 tweet items (includes retweets and replies), starting from the end date given and moving backwards.
Yahoo DSPHR: Can fetch data up to 2 years; data older than that is purged and cannot be requested.
Yahoo Native AdsHR: Last 400 days


Refresh window: Set to the maximum of your attribution windows on the platform.

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.