Skip to main content
POST
Reference example

Request contract

  • Method and path: POST /apis/v1/social/analytics/googleanalytics/realtime
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/social/analytics/googleanalytics/realtime
  • Runtime facts: 99acb5bddbedc8d3352e7c4fef86c3e6d8852c14772bcd18dbcf415237a642bd
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.

Body

application/json
accountId
string
required

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
metrics
string[]
required

GA4 metric API names, e.g. sessions, activeUsers, keyEvents, totalRevenue.

Required array length: 1 - 10 elements
dimensionFilter
object

A Google FilterExpression on dimensions, in Google's own shape.

dimensions
string[]

GA4 dimension API names, e.g. date, sessionSource, pagePath. List them with GET /apis/v1/social/analytics/googleanalytics/metadata.

Maximum array length: 9
limit
integer

Rows to return. Defaults to Google's default (10000).

Required range: 1 <= x <= 10000
metricFilter
object

A Google FilterExpression on metrics, in Google's own shape.

minuteRanges
object[]
Required array length: 1 - 2 elements
orderBys
object[]

Google OrderBy objects, e.g. { "metric": { "metricName": "sessions" }, "desc": true }.

Maximum array length: 10

Response

Realtime report rows from Google

Google Analytics Data API report, passed through as Google returns it. Every value in rows is a string; read metricHeaders[].type to parse metrics.

accountId
string

One of your social accounts (acc_...).

Pattern: ^acc_[0-9A-Za-z]{22}$
dimensionHeaders
object[]
metadata
object

Google report metadata (currency, time zone, sampling and thresholding flags).

metricHeaders
object[]
propertyId
string

Numeric GA4 property ID.

propertyQuota
object

Google quota left on this property after the request (tokens per day and per hour, concurrent requests). Cached responses carry the quota from when they were fetched.

rowCount
integer

Total rows matching the request, across all pages.

rows
object[]