Skip to main content
GET
Get Posts Analytics

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://api.x.com/2/oauth2/authorize
Token URL
https://api.x.com/2/oauth2/token
Scopes2
users.read
View any account you can see, including protected accounts.
tweet.read
View all posts you can see, including those from protected accounts.

Query Parameters

ids
string[]
required
Required array length: 1 - 100 elements

Unique identifier of a Analytics

Pattern: ^[0-9]{1,19}$
start_time
string<date-time>
required
end_time
string<date-time>
required
granularity
enum<string>
default:total
Available options:
hourly,
weekly,
daily,
total
analytics.fields
enum<string>[]

A comma separated list of Analytics fields to display. The fields available for a Analytics object.

Minimum array length: 1
Available options:
app_install_attempts,
app_opens,
bookmarks,
detail_expands,
email_tweet,
engagements,
follows,
hashtag_clicks,
id,
impressions,
likes,
media_views,
permalink_clicks,
quote_tweets,
replies,
retweets,
shares,
timestamp,
timestamped_metrics,
unfollows,
unlikes,
url_clicks,
user_profile_clicks

Response

The request has succeeded.

data
object[]
errors
object[]