Engagement Metrics
Get Historical Metrics for Posts
Get Historical Metrics for Posts.
GET
/
2
/
insights
/
historical
Authorizations
Authorization
string
headerrequiredThe access token received from the authorization server in the OAuth 2.0 flow.
Query Parameters
tweet_ids
string[]
requiredList of PostIds for historical metrics.
end_time
string
requiredYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the end of the time range.
start_time
string
requiredYYYY-MM-DDTHH:mm:ssZ. The UTC timestamp representing the start of the time range.
granularity
enum<string>
requiredgranularity of metrics response.
Available options:
Daily
, Hourly
, Weekly
, Total
requested_metrics
enum<string>[]
requiredrequest metrics for historical request.
Available options:
AppInstallAttempts
, AppOpens
, DetailExpands
, EmailTweet
, Engagements
, Follows
, HashtagClicks
, Impressions
, Likes
, LinkClicks
, MediaEngagements
, MediaViews
, PermalinkClicks
, ProfileVisits
, QuoteTweets
, Replies
, Retweets
, UniqueVideoViews
, UrlClicks
, UserProfileClicks
, VideoCompletions
, VideoPlayed25Percent
, VideoPlayed50Percent
, VideoPlayed75Percent
, VideoStarts
, VideoViews
engagement.fields
enum<string>[]
A comma separated list of Engagement fields to display.
Available options:
errors
, measurement
Response
200 - application/json
data
object[]
errors
object[]