Skip to main content
GET
Get Media 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
Scopes1
tweet.read
View all posts you can see, including those from protected accounts.

Query Parameters

media_keys
string[]
required
Required array length: 1 - 100 elements
Pattern: ^([0-9]+)_([0-9]+)$
start_time
string<date-time>
required
end_time
string<date-time>
required
granularity
enum<string>
default:daily
Available options:
hourly,
daily,
total
media_analytics.fields
enum<string>[]

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

Minimum array length: 1
Available options:
cta_url_clicks,
cta_watch_clicks,
media_key,
play_from_tap,
playback25,
playback50,
playback75,
playback_complete,
playback_start,
timestamp,
timestamped_metrics,
video_views,
watch_time_ms

Response

The request has succeeded.

data
object[]
errors
object[]