Skip to content

Social analytics

Inspect connected Meta, Instagram and LinkedIn accounts, cross-brand performance and post analytics.

5 tools. Each card documents its effect and tools/list input contract.

Real provider data only

These tools read BrandSuite rows synchronized from connected Meta, Instagram and LinkedIn accounts. They return last-sync timestamps and empty results when data is unavailable; they never synthesize KPI.

Social analytics

Inspect connected Meta, Instagram and LinkedIn accounts, cross-brand performance and post analytics.

5 tools
list_social_connections
read
read only

List real Meta, Instagram and LinkedIn connections, public account metadata, capabilities, readiness and last sync for one or more brands.

Parameters

brandIdsuuid[]
Optional
Default: []

Brand IDs to inspect; empty means every accessible brand.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

statusstring
Optional

Connection status filter.

Values: connected, requires_auth, error, not_connected

get_social_overview
read
read only

Aggregate connected providers, followers, post performance and freshness across one or all accessible brands for a bounded date range.

Parameters

brandIdsuuid[]
Optional
Default: []

Brand IDs to aggregate; empty means every accessible brand.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 30 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

get_social_account_analytics
read
read only

Return provider-backed account-level follower, reach, impression, engagement, click and spend time series for a brand.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 90 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

list_social_post_analytics
read
read only

Rank a brand’s published social content by engagement, impressions, reach, clicks, reactions or date with safe metadata.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

providersstring[]
Optional
Default: []

Provider filters.

Values: meta, linkedin

fromdate
Optional

Start date in YYYY-MM-DD; default is 90 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.

sortBystring
Optional
Default: engagement

Metric used to rank posts.

Values: engagement, impressions, reach, clicks, likes, comments, shares, saves, date

limitinteger
Optional
Default: 20

Maximum posts returned; range 1–100.

get_social_post_analytics
read
read only

Return one social post, its bounded metric time series, totals, engagement rate, click-through rate and last metric date.

Parameters

brandIduuid
Required

Authorized BrandSuite brand ID.

itemIduuid
Required

Published social campaign item ID.

fromdate
Optional

Start date in YYYY-MM-DD; default is 365 days ago.

todate
Optional

End date in YYYY-MM-DD; default is today.