Skip to main content
GET
Get daily account metrics

Request contract

  • Method and path: GET /apis/v1/ads/timeline
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/ads/timeline
  • connectionId: query; required
  • adAccountId: query; optional
  • fromDate: query; optional
  • toDate: query; optional
  • platform: query; optional
  • compare: query; optional
  • Runtime facts: fe60122939c67dc98a3a6ac6b97bd5c326b526105150c8959304dd2160d4dd09
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

A request reference price is not currently available; use a request quote where supported. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

connectionId
string
required

The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.

Pattern: ^adc_[0-9A-Za-z]+$
adAccountId
string

Optional platform-native ad account ID (e.g. Meta act_…, TikTok advertiser ID). Use when the connection wraps multiple platform ad accounts and the chart should show one only.

fromDate
string<date>

Inclusive start of metrics range (YYYY-MM-DD). Defaults to 90 days ago.

toDate
string<date>

Inclusive end of metrics range (YYYY-MM-DD). Defaults to today. Max 730-day range.

platform
enum<string>

Restrict to one platform.

Available options:
facebook,
instagram,
tiktok,
linkedin,
pinterest,
google,
twitter,
openai,
reddit,
microsoft,
meta,
x
compare
enum<string>

Set to previous to also return previousRows for the period of the same length that ends the day before fromDate, with that period as previousRange. Needs a fromDate (sent or defaulted); toDate alone answers 400.

Available options:
previous

Response

Daily time series of aggregate metrics. Empty rows means the account has no ad activity in the range.

backfillPending
boolean

Meta only. Present and true while historical data is being backfilled.

previousRange
object

Only with compare=previous. The period of the same length that ends the day before fromDate.

previousRows
object[]

Only with compare=previous. The daily rows of previousRange, in the same shape as rows.

rows
object[]