Docs
Search docs...⌘K

Post metrics

API + MCP
GET/v3/social-media/post-metrics

Requests to this endpoint are free and do not consume any API units.

Query parameters

date_tostring

The end date of the historical period in YYYY-MM-DD format.

date_fromstringRequired

The start date of the historical period in YYYY-MM-DD format.

channel_idstringRequired

Unique identifier for the social media channel.

external_post_idstringRequired

Platform-specific post identifier.

outputstring

The output format.

Allowed values:jsonphp

Responses

metricsarray<object>
facebook_metricsobject or null

Facebook-specific engagement metrics. Present only when the post is on Facebook.

commentsinteger
reactionsinteger
instagram_metricsobject or null

Instagram-specific engagement metrics. Present only when the post is on Instagram.

commentsinteger
sharesinteger
savedinteger
likesinteger

Number of likes on the post.

linkedin_metricsobject or null

LinkedIn-specific engagement metrics. Present only when the post is on LinkedIn.

commentsinteger
resharesinteger
retrieved_atstring

Timestamp when the metrics were last retrieved.

threads_metricsobject or null

Threads-specific engagement metrics. Present only when the post is on Threads.

repliesinteger
repostsinteger
quotesinteger
sharesinteger
twitter_metricsobject or null

Twitter/X-specific engagement metrics. Present only when the post is on Twitter/X.

repliesinteger
retweetsinteger
quote_tweetsinteger
unique_viewsinteger

Number of unique users who viewed the post.

viewsinteger

Total number of times the post was viewed.