Skip to main content
GET
Get integration account stats

Authorizations

Authorization
string
header
required

Bearer an mk_live_ API key. A key is ORG-SCOPED: it grants full access to every resource in that organization, with no per-endpoint scoping (see the uid pseudo-permission on each operation). Manage keys at https://app.mymarky.ai.

Headers

Marky-Version
enum<string>

Opt into a dated API version. Omit to stay on the floor (2026-04-08) forever — unpinned clients never break. Pin to a newer date (e.g. 2026-08-06) to receive the newest response shapes. Unknown values fall back to the floor. See https://docs.mymarky.ai for the versioning model.

Available options:
2026-04-08,
2026-07-17,
2026-08-02,
2026-08-04,
2026-08-06
Example:

"2026-08-06"

Path Parameters

business_id
string
required

A UUID identifier.

integration_id
string
required

A UUID identifier.

Query Parameters

since
string | null

Start date (YYYY-MM-DD). Defaults to 30 days ago.

until
string | null

End date (YYYY-MM-DD). Defaults to today.

period
string
default:day

Aggregation period: day, week, days_28, lifetime

metrics
string | null

Comma-separated metric names (platform-specific). Omit for defaults.

Response

Successful Response

Account/page-level statistics.

Data-source agnostic: works for API fetches and local DB reads.

fetched_at
string<date-time>
platform
string | null
account_id
string | null
page_id
string | null
followers
integer | null
following
integer | null
posts_count
integer | null
impressions
integer | null
reach
integer | null
profile_views
integer | null
website_clicks
integer | null
audience_age_pct
Audience Age Pct · object | null

Age bucket -> share of audience (0.0-1.0). IG, YT, LinkedIn, Pinterest.

audience_gender_pct
Audience Gender Pct · object | null

Gender ('FEMALE'/'MALE'/'UNKNOWN') -> share. IG, YT, LinkedIn, Pinterest.

audience_country_pct
Audience Country Pct · object | null

ISO country code -> share. IG, YT, LinkedIn.

audience_city_pct
Audience City Pct · object | null

City name -> share. IG only.

audience_industry_pct
Audience Industry Pct · object | null

LinkedIn-only: industry name -> share.

audience_seniority_pct
Audience Seniority Pct · object | null

LinkedIn-only: seniority bucket -> share.

audience_function_pct
Audience Function Pct · object | null

LinkedIn-only: job function -> share.

metrics
MetricTimeseries · object[]
raw_metrics
Raw Metrics · object
unavailable_reason
string | null

Non-null when the platform does not support account-level analytics for this account type (e.g. LinkedIn personal profiles). When set, the numeric fields being null means 'not supported by provider', not 'zero' or 'no data'.

post_stats_hint
string
default:Account-level metrics vary by platform and are often sparse. For per-post impressions, reach, clicks and views, call GET /businesses/{business_id}/integrations/{integration_id}/posts (MCP: list_integration_posts) — it returns rich per-post stats even when these account-level fields are null.