Skip to content

Get platform comparison

GET
/api/social-analytics/comparison

Side-by-side performance comparison across all connected social platforms.

Authorizations

Parameters

Query Parameters

start_date
required

Period start date (YYYY-MM-DD)

string format: date

Period start date (YYYY-MM-DD)

end_date
required

Period end date (YYYY-MM-DD)

string format: date

Period end date (YYYY-MM-DD)

Responses

200

Successful Response

Side-by-side comparison of all connected social platforms.

Attributes: platforms: List of per-platform metrics. best_engagement_rate: Platform with the highest engagement rate. best_reach: Platform with the highest reach. recommendations: Actionable recommendations based on the comparison.

object
best_engagement_rate
string
""
best_reach
string
""
platforms
Array<object>

Per-platform aggregated engagement metrics for a date range.

Attributes: platform: Social platform identifier. reach: Total unique users who saw content. impressions: Total content views (including repeats). engagement: Total engagement actions (likes + shares + comments + clicks). likes: Total likes/reactions. shares: Total shares/retweets/reposts. comments: Total comments/replies. clicks: Total link clicks. followers: Current follower count (latest known). engagement_rate: engagement / impressions (0.0 if no impressions). period_start: Start of the measured period. period_end: End of the measured period.

object
clicks
integer
comments
integer
engagement
integer
engagement_rate
number
followers
integer
impressions
integer
likes
integer
period_end
string format: date
period_start
string format: date
platform
required
string
reach
integer
shares
integer
recommendations
Array<string>

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string