Get the Apple Ads daily series
One metric of the Apple Ads report, day by day — the chart behind the table. It uses the same project, cohort filters, and reporting basis, in a different shape: no entity axis, no pagination, and no cohort windows.
Not derivable from the report. The report’s cohort metrics are cumulative to date from each install date, while a series point is the value attributed to that day. Use this endpoint for movement over time, and the report for the breakdown by level.
null is not zero. A point is null when no value is available
for that day — for example, a day outside coverage, or a ratio metric
with an empty denominator. 0 is a reported zero.
Filters that do not apply to the requested metric are listed in
filters_ignored. This includes filter[status] and
filter[delivery], which do not apply to a daily series.
Length: a series returns at most 366 daily points. For a longer
period, the oldest days are omitted and truncated is true.
Availability: available to accounts with Apple Ads enabled; other
accounts receive 404. Contact support to enable Apple Ads.
Rate limits: the report and series endpoints are rate limited. A
429 response includes Retry-After; wait that long before
retrying.
Authorizations
Bearer authentication using the project Secret Key (prefixed with sk_), used exactly as shown in the dashboard. Endpoints that support sandbox data take an explicit environment field or parameter. All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.
Query Parameters
Start of the period, Unix seconds UTC. Bounds the days on the axis (and, for cohort metrics, the install dates).
End of the period, Unix seconds UTC. Must be greater than from.
0 = sandbox, 1 = production.
0, 1 Which metric to plot. spend, installs, and taps are Apple metrics; users, trials, trials_converted, paying, revenue, arpu, and arppu are Qonversion cohort metrics; roas and cost_per_subscription combine both. The response echoes is_cohort_metric and a semantics caption that states what a point means — for example, revenue on day X is the revenue attributed to the cohort acquired on day X.
spend, installs, taps, users, trials, trials_converted, paying, revenue, arpu, arppu, roas, cost_per_subscription Which revenue basis feeds the revenue-derived metrics (revenue, arpu, arppu, roas). Both bases exist for every day; this selects the one plotted.
gross, net ISO 4217 code, uppercase. Monetary metrics are converted at one midpoint rate for the whole period, reported in currency_conversion. If no exchange rate is available for the period, values are in USD: currency is USD and currency_conversion.rate_unavailable_for holds the requested code.
^[A-Z]{3}$Narrow the cohort (and Apple metrics where Apple supports the split) by storefront country. Array-valued — repeat the key.
Narrow by campaign name. Array-valued — repeat the key.
Narrow by ad group. Array-valued — repeat the key.
Narrows the Qonversion cohort only; Apple spend is not split by media source. When it does not apply to the requested metric, it is listed in filters_ignored. Array-valued — repeat the key.
Exclude these media sources from the cohort. Array-valued — repeat the key. This is the only supported exclusion; filter_not on country, campaign_name, or ad_set_name returns 400.
Response
Daily series for the requested metric.
"analytics_apple_ads_series"
"/v4/analytics/apple-ads/report/series"
The metric this series plots.
Granularity. Always day — a point is one UTC day.
day Currency of the monetary points. If no exchange rate is available for the period, values are in USD and currency is USD (see currency_conversion).
gross, net One sentence stating what a point of this metric means, including the cohort attribution where it applies.
true when a point is attributed to the cohort acquired that day (revenue, arpu, arppu, trials, and so on); false when it measures what happened that day (spend, installs, taps).
One point per UTC day of the requested period, oldest first. Days without a value are present with value: null.
Filter codes that do not apply to the requested metric and were not applied, including status and delivery. Sorted. An empty array means every filter was applied.
Dates with Apple spend data inside the requested period. Present only for metrics that use Apple spend data (spend, installs, taps, roas, cost_per_subscription).
Present and true when the requested period is longer than 366 days; the oldest days are omitted.
Present when a currency other than USD was requested. Either the rate that was applied, or rate_unavailable_for with the requested code when no exchange rate is available for the period (values are then in USD).