Data Formation Migration

Introduction

With the launch of the v2 version of the X API, we have adopted a new data response format and method of requesting different objects and fields, which we are simply calling the X API v2 format. 

In the general differences section, you can learn about some changes that are relevant to standard, and enterprise users. However, we also put together a specific guide for the standard v1.1 Native format, the enterprise Native Enriched format, and the enterprise Activity Streams format which helps to map fields and explains which fields and expansions you must use to request the new v2 fields. 

• Native format to X API v2 (standard v1.1) 
• Native Enriched to X API v2 (enterprise)
• Activity Streams to X API v2 (enterprise)

You may also be interested in our visual data format migration tool to help you quickly see the differences between the X API v1.1 data format and the X API v2 format.

General differences

Requesting objects and fields

One of the biggest changes between the pre-v2 endpoints and v2 is that the newer version only returns a few fields by default, whereas standard, premium, and enterprise endpoints deliver most fields by default. The new version uses parameters called fields and expansions to specifically request additional data beyond the defaults, meaning that you can request just the data you need without having to ingest fields that don’t matter to you. 

Any fields that you request that relate to the primary data object will return in that primary data object along with the default values. However, if you request any expanded objects using the expansions parameter, the secondary objects will return in a new includes object. You can match the expanded objects in the includes object back to the primary object by using the ID field which will return in both.

For example, if you are using the v2 Post lookup endpoint and you include the expansions=author_id parameter in your request, you will receive the author_id field within the primary Post object, as well as a user object per Post in the includes object, each of which will include the default id field that can be used to match the user object back to the Post object. Here is an example of what this looks like:

{
  "data": [
    {
      "author_id": "2244994945",
      "id": "1397568983931392004",
      "text": "The Twitter Developer Platform. Ooh la la! https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev"
      }
    ]
  }
}

Updated JSON design

In addition to the changes in how you request certain fields, X API v2 is also introducing new JSON designs for the objects returned by the APIs, including Post and user objects.

• At the JSON root level, the standard endpoints return Post objects in a statuses array, while X API v2 returns a data array. 
• Instead of referring to Retweeted and Quoted “statuses”, X API v2 JSON refers to Retweeted and Quoted Tweets. Many legacy and deprecated fields, such as contributors and user.translator_type are being removed. 
• Instead of using both favorites (in Post object) and favourites (in user object), X API v2 uses the term like. 
• X is adopting the convention that JSON values with no value (for example, null) are not written to the payload. Post and user attributes are only included if they have a non-null values.   

New v2 fields

We also introduced a new set of fields to the Post object including the following:

• A conversation_id field
• Two new annotations fields, including context and entities
• Several new metrics fields 
• A new reply_setting field, which shows you who can reply to a given Post

Migrating from standard v1.1’s data format to v2

If you haven’t already, we recommend that you read through the data formats migration introduction to start. You may also be interested in our visual data format migration tool to help you quickly see the differences between the X API v1.1 data format and the X API v2 format.

The standard v1.1 data format, also known as the native format, is the primary format that delivers with the standard v1.1 endpoints.

If you are using the premium product, please refer to the native enriched guide. Enterprise clients might be using native enriched or activity streams, depending on how you are set up within the Gnip console. 

Standard v1.1 vs v2 payload structure

The following table displays the high-level objects and format that you can expect to receive from v2 compared to the v1.1 format.

	v1.1 structure	v2 structure
Default	{ all tweet object fields, “entities”: { “hashtags”: [], “symbols”: [], “user_mentions”: [], “urls”: [], “media”: [] }, “extended_entities”: , “user”: , “place”: , “retweeted_status/quoted_status” }	{ “data”: [{ “id”, “text”, “edit_history_tweet_ids” }] }
With defined field and expansion parameters		{ “data”: [{ tweet object fields, “entities”: { “hashtags”: [], “cashtags”: [], “mentions”: [], “urls”: [], }, “attachments”: { “media_keys”: [], “poll_ids”: [] } }], “includes”: [ “tweets”: [tweet objects], “users”: [user objects], “media”: [media objects], “places”: [place object], “polls”: [poll object] ], “matching_rules”: [] }

Field mapping

The following section describes which v1.1 fields map to v2 fields, as well as which v2 parameters are required to receive the new field.  

Tweet object

Twitter 1.1 format	Twitter v2 format	Required v2 parameters
created_at	data.created_at	tweet.fields=created_at
id		N/A id is a string
id_str	data.id	default
text	data.text	default
full_text		N/A text includes the complete text
truncated		N/A text includes the complete text
display_text_range		N/A text includes the complete text
edit_history	data.edit_history_tweet_ids	default
edit_controls	data.edit_controls	tweet.fields=edit_controls
editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls
entities	data.entities	tweet.fields=entities
entities.user_mentions	data.entities.mentions	tweet.fields=entities
entities.symbols	data.entities.cashtags	tweet.fields=entities
entities.hashtags	data.entities.hashtags	tweet.fields=entities
entities.urls	data.entities.urls	tweet.fields=entities
entities.media	includes.media	expansions=attachments.media_keys
extended_entities	data.attachments	tweet_fields=attachments
in_reply_to_status_id		N/A referenced_tweets.id is a string
in_reply_to_status_id_str	data.referenced_tweets.id (if type=replied_to)	expansions=referenced_tweets.id
in_reply_to_user_id		N/A in_reply_to_user_id is a string
in_reply_to_user_id_str	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id
in_reply_to_screen_name	includes.users..username	tweet.fields=in_reply_to_user_id&expansions=entities.mentions.username
user	includes.users	expansions=author_id
geo	data.geo.place_id	tweet.fields=geo
coordinates	data.geo.place_id	expansions=geo.place_id
place	data.geo.place_id	expansions=geo.place_id
retweeted_status	data.referenced_tweets.id (if type=retweeted)	expansions=referenced_tweets.id
is_quoted_status		Not available
quoted_status_id		N/A referenced_tweets.id is a string
quoted_status_id_str	data.referenced_tweets.id (if type=quoted)	expansions=referenced_tweets.id
quoted_status_permalink		Not Available
quoted_status	data.referenced_tweets (if type=quoted)	expansions=referenced_tweets.id
retweet_count	data.public_metrics.retweet_count	tweet.fields=public_metrics
favorite_count	data.public_metrics.like_count	tweet.fields=public_metrics
favorited		Not available
retweeted		Not available
possibly_sensitive	data.possibly_sensitive	tweet.fields=possibly_sensitive
lang	data.lang	tweet.fields=lang
scopes		Not available
withheld	data.withheld	tweet.fields=withheld

Example

Tweet object in 1.1 Example URI with parameters: https://api.x.com/1.1/statuses/lookup.json?id=1359554366051504129&tweet_mode=extended	Tweet object and request with v2 Example URI with parameters: https://api.x.com/2/tweets?ids=1359554366051504129&tweet.fields=attachments,author\_id,context\_annotations,conversation\_id,created\_at,entities,geo,id,in\_reply\_to\_user\_id,lang,possibly\_sensitive,public\_metrics,referenced\_tweets,reply\_settings,text,withheld
{ “created_at”: “Wed Feb 10 17:26:34 +0000 2021”, “id”: 1359554366051504129, “id_str”: “1359554366051504129”, “text”: “Go ahead, follow another puppy account. We won’t judge. \n\nIntroducing the manage follows endpoints to the new… https:\/\/t.co\/3cBZKZUevF”, “truncated”: true, “entities”: { “hashtags”: [], “symbols”: [], “user_mentions”: [], “urls”: [{ “url”: “https:\/\/t.co\/3cBZKZUevF”, “expanded_url”: “https:\/\/twitter.com\/i\/web\/status\/1359554366051504129”, “display_url”: “twitter.com\/i\/web\/status\/1…”, “indices”: [ 111, 134 ] }] }, “in_reply_to_status_id”: null, “in_reply_to_status_id_str”: null, “in_reply_to_user_id”: null, “in_reply_to_user_id_str”: null, “in_reply_to_screen_name”: null, “user”: { … }, “geo”: null, “coordinates”: null, “place”: null, “contributors”: null, “is_quote_status”: false, “retweet_count”: 18, “favorite_count”: 98, “favorited”: false, “retweeted”: false, “possibly_sensitive”: false, “possibly_sensitive_appealable”: false, “lang”: “en” }	{ “data”: [{ “id”: “1359554366051504129”, “text”: “Go ahead, follow another puppy account. We won’t judge. \n\nIntroducing the manage follows endpoints to the new #TwitterAPI. You can now use the v2 API to follow and unfollow accounts. Learn more https://t.co/mtpd9VIMDa”, “lang”: “en”, “conversation_id”: “1359554366051504129”, “possibly_sensitive”: false, “reply_settings”: “everyone”, “created_at”: “2021-02-10T17:26:34.000Z”, “author_id”: “2244994945”, “public_metrics”: { “retweet_count”: 18, “reply_count”: 11, “like_count”: 98, “quote_count”: 7 }, “entities”: { “hashtags”: [{ “start”: 110, “end”: 121, “tag”: “TwitterAPI” }], “urls”: [{ “start”: 194, “end”: 217, “url”: “https://t.co/mtpd9VIMDa”, “expanded_url”: “https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465”, “display_url”: “devcommunity.com/t/introducing-…”, “images”: [{ “url”: “https://pbs.twimg.com/news\_img/1359554367905427457/DczC72\_\_?format=jpg&name=orig”, “width”: 1200, “height”: 630 }, { “url”: “https://pbs.twimg.com/news\_img/1359554367905427457/DczC72\_\_?format=jpg&name=150x150”, “width”: 150, “height”: 150 } ], “status”: 200, “title”: “Introducing the new manage follows endpoints to the X API v2”, “description”: “To follow, or not to follow? You’re now free to answer that question however you like using the X API v2. Today, we’re excited to announce the release of the new manage follows endpoints into the new Twitter API. As teased when we launched the follows lookup endpoints a little over a month ago, the ability to manage follow relationships is finally here. These are some of our most popular endpoints on our v1.1 APIs, so we’re excited to unlock a wide range of use cases on X API v2. W…”, “unwound_url”: “https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465” }] }, “context_annotations”: [{ “domain”: { “id”: “46”, “name”: “Brand Category”, “description”: “Categories within Brand Verticals that narrow down the scope of Brands” }, “entity”: { “id”: “781974596752842752”, “name”: “Services” } }, { “domain”: { “id”: “47”, “name”: “Brand”, “description”: “Brands and Companies” }, “entity”: { “id”: “10045225402”, “name”: “Twitter” } } ] }] }

---

User object

Twitter 1.1 format	Twitter v2 format	Required v2 parameters
user_id	data.author_id	tweet.fields=author_id
user.id		N/A use includes.users.id
user.id_str	includes.users.id	expansions=author_id
user.name	includes.users.name	expansions=author_id
user.screen_name	includes.user.username	expansions=author_id
user.location	includes.users.location	expansions=author_id&user.fields=location
user.description	includes.users.description	expansions=author_id&user.fields=description
user.url	includes.users.url	expansions=author_id&user.fields=entities
user.entities	includes.users.entities
user.entities.url.urls.url	includes.users.entities.url.urls.url
user.entities.url.urls.expanded_url	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[0]	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[1]	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities
user.protected	includes.users.protected	expansions=author_id&user.fields=protected
user.followers_count	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics
user.friends_count	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics
user.listed_count	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics
user.created_at	includes.users.created_at	expansions=author_id&user.fields=created_at
user.favourites_count
user.verified	includes.users.verified	expansions=author_id&user.fields=verified
user.statuses_count	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics
user.profile_image_url_https	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url

Example

User object in 1.1	User object and request with v2
”user”: { “id”: 2244994945, “id_str”: “2244994945”, “name”: “Twitter Dev”, “screen_name”: “TwitterDev”, “location”: “127.0.0.1”, “description”: “The voice of the #TwitterDev team and your official source for updates, news, and events, related to the #TwitterAPI.”, “url”: “https:\/\/t.co\/3ZX3TNiZCY”, “entities”: { “url”: { “urls”: [{ “url”: “https:\/\/t.co\/3ZX3TNiZCY”, “expanded_url”: “https:\/\/developer.x.com\/en\/community”, “display_url”: “developer.x.com\/en\/community”, “indices”: [ 0, 23 ] }] }, “description”: { “urls”: [] } }, “protected”: false, “followers_count”: 517232, “friends_count”: 2032, “listed_count”: 1722, “created_at”: “Sat Dec 14 04:35:55 +0000 2013”, “favourites_count”: 2134, “utc_offset”: null, “time_zone”: null, “geo_enabled”: true, “verified”: true, “statuses_count”: 3677, “lang”: null, “contributors_enabled”: false, “is_translator”: false, “is_translation_enabled”: false, “profile_background_color”: “FFFFFF”, “profile_background_image_url”: “http:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png”, “profile_background_image_url_https”: “https:\/\/abs.twimg.com\/images\/themes\/theme1\/bg.png”, “profile_background_tile”: false, “profile_image_url”: “http:\/\/pbs.twimg.com\/profile_images\/1354494203451961345\/d8HkZl6p_normal.jpg”, “profile_image_url_https”: “https:\/\/pbs.twimg.com\/profile_images\/1354494203451961345\/d8HkZl6p_normal.jpg”, “profile_banner_url”: “https:\/\/pbs.twimg.com\/profile_banners\/2244994945\/1611792896”, “profile_link_color”: “0084B4”, “profile_sidebar_border_color”: “FFFFFF”, “profile_sidebar_fill_color”: “DDEEF6”, “profile_text_color”: “333333”, “profile_use_background_image”: false, “has_extended_profile”: true, “default_profile”: false, “default_profile_image”: false, “following”: null, “follow_request_sent”: null, “notifications”: null, “translator_type”: “regular” }	{ “data”: [{ “author_id”: “2244994945”, “id”: “1362876655061073928”, “text”: “From our living rooms to yours 🐱‍💻🛋️Our developer advocates have some exciting Twitch streams and virtual events planned to help you get started with the new #TwitterAPI. Check out the schedule for details, and let us know if you want to see more!\n👇\nhttps://t.co/cixDY9qkvH” }], “includes”: { “users”: [{ “public_metrics”: { “followers_count”: 517233, “following_count”: 2034, “tweet_count”: 3677, “listed_count”: 1727 }, “username”: “TwitterDev”, “entities”: { “url”: { “urls”: [{ “start”: 0, “end”: 23, “url”: “https://t.co/3ZX3TNiZCY”, “expanded_url”: “https://developer.x.com/en/community”, “display_url”: “developer.x.com/en/community” }] }, “description”: { “hashtags”: [{ “start”: 17, “end”: 28, “tag”: “TwitterDev” }, { “start”: 105, “end”: 116, “tag”: “TwitterAPI” } ] } }, “description”: “The voice of the #TwitterDev team and your official source for updates, news, and events, related to the #TwitterAPI.”, “name”: “Twitter Dev”, “verified”: true, “location”: “127.0.0.1”, “id”: “2244994945”, “protected”: false, “url”: “https://t.co/3ZX3TNiZCY”, “profile_image_url”: “https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg”, “created_at”: “2013-12-14T04:35:55.000Z” }] } }

Entities and expanded entities objects

Twitter 1.1 format	Twitter v2 format	Required v2 parameters	Type in v2
entities	data.entities	tweet.fields=entities	object
entities.hashtags	data.entities.hashtags	tweet.fields=entities	array of objects
entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	number
entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	number
entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	string
entities.urls	data.entities.urls	tweet.fields=entities	array of objects
entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	number
entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	number
entities.urls.url	data.entities.urls.url	tweet.fields=entities	string
entities.user_mentions	data.entities.mentions	tweet.fields=entities	array of objects
entities.user_mentions.indicies[0]	data.entities.mentions.start	tweet.fields=entities	number
entities.user_mentions.indicies[1]	data.entities.mentions.end	tweet.fields=entities	number
entities.user_mentions.screen_name	data.entities.mentions.username	tweet.fields=entities	string
entities.symbols	data.entities.cashtags	tweet.fields=entities	array of objects
entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	number
entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	number
entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	string
entities.media	includes.media	expansions=attachments.media_keys	array of objects
entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	string
entities.media.type	includes.media.media.type	expansions=attachments.media_keys	string
entities.media.media_url		N/A use includes.media.url	string
entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	string
entities.media.url
entities.media.display_url
entities.media.expanded_url
entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	string
extended_entities	data.attachments	tweet_fields=attachments	object
extended_entities	data.attachments.media_keys	tweet.fields=attachments	array of objects
extended_entities.media	includes.media	expansions=attachments.media_keys	array of objects
extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	string
extended_entities.media.type	includes.media.media.type	expansions=attachments.media_keys	string
extended_entities.media.sizes.thumb.w		Not Available
extended_entities.media.sizes.thumb.h		Not Available
extended_entities.media.sizes.thumb.resize		Not Available
extended_entities.media.sizes.large.w	includes.media.height	expansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.h	includes.media.width	expansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize		Not Available
extended_entities.media.sizes.small.w		Not Available
extended_entities.media.sizes.small.h		Not Available
extended_entities.media.sizes.small.resize		Not Available
extended_entities.media.sizes.medium.w		Not Available
extended_entities.media.sizes.medium.h		Not Available
extended_entities.media.sizes.medium.resize		Not Available
extended_entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	string
extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	string
extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	number

Example

Entities and extended entities in v1.1 (with video)	Entities, attachments and includes in v2 https://api.x.com/2/tweets?ids=1370161532013735937&expansions=attachments.media\_keys,entities.mentions.username&tweet.fields=entities&user.fields=created\_at,description,entities,location,name,profile\_image\_url,protected,public\_metrics,url,username,verified,withheld&media.fields=duration\_ms,height,media\_key,preview\_image\_url,public\_metrics,type,url,width
”entities”: { “hashtags”: [{ “text”: “test”, “indices”: [ 8, 13 ] }], “symbols”: [], “user_mentions”: [{ “screen_name”: “TwitterDev”, “name”: “Twitter Dev”, “id”: 2244994945, “id_str”: “2244994945”, “indices”: [ 31, 42 ] }], “urls”: [{ “url”: “https:\/\/t.co\/XVLZ3uwikc”, “expanded_url”: “https:\/\/developer.x.com\/en”, “display_url”: “developer.x.com\/en”, “indices”: [ 91, 114 ] }], “media”: [{ “id”: 1370161464028196868, “id_str”: “1370161464028196868”, “indices”: [ 115, 138 ], “media_url”: “http:\/\/pbs.twimg.com\/ext_tw_video_thumb\/1370161464028196868\/pu\/img\/cGLCoXBHVktkwlC5.jpg”, “media_url_https”: “https:\/\/pbs.twimg.com\/ext_tw_video_thumb\/1370161464028196868\/pu\/img\/cGLCoXBHVktkwlC5.jpg”, “url”: “https:\/\/t.co\/dz4oByygWA”, “display_url”: “pic.x.com\/dz4oByygWA”, “expanded_url”: “https:\/\/twitter.com\/furiouscamper\/status\/1370161532013735937\/video\/1”, “type”: “photo”, “sizes”: { “thumb”: { “w”: 150, “h”: 150, “resize”: “crop” }, “small”: { “w”: 383, “h”: 680, “resize”: “fit” }, “large”: { “w”: 720, “h”: 1280, “resize”: “fit” }, “medium”: { “w”: 675, “h”: 1200, “resize”: “fit” } } }] }, “extended_entities”: { “media”: [{ “id”: 1370161464028196868, “id_str”: “1370161464028196868”, “indices”: [ 115, 138 ], “media_url”: “http:\/\/pbs.twimg.com\/ext_tw_video_thumb\/1370161464028196868\/pu\/img\/cGLCoXBHVktkwlC5.jpg”, “media_url_https”: “https:\/\/pbs.twimg.com\/ext_tw_video_thumb\/1370161464028196868\/pu\/img\/cGLCoXBHVktkwlC5.jpg”, “url”: “https:\/\/t.co\/dz4oByygWA”, “display_url”: “pic.x.com\/dz4oByygWA”, “expanded_url”: “https:\/\/twitter.com\/furiouscamper\/status\/1370161532013735937\/video\/1”, “type”: “video”, “sizes”: { “thumb”: { “w”: 150, “h”: 150, “resize”: “crop” }, “small”: { “w”: 383, “h”: 680, “resize”: “fit” }, “large”: { “w”: 720, “h”: 1280, “resize”: “fit” }, “medium”: { “w”: 675, “h”: 1200, “resize”: “fit” } }, “video_info”: { “aspect_ratio”: [ 9, 16 ], “duration_millis”: 5140, “variants”: [{ “bitrate”: 950000, “content_type”: “video\/mp4”, “url”: “https:\/\/video.twimg.com\/ext_tw_video\/1370161464028196868\/pu\/vid\/480x852\/rAuFVMEqs0MeP4P4.mp4?tag=12” }, { “bitrate”: 2176000, “content_type”: “video\/mp4”, “url”: “https:\/\/video.twimg.com\/ext_tw_video\/1370161464028196868\/pu\/vid\/720x1280\/ZxVL5qYO-DNVuSyq.mp4?tag=12” }, { “content_type”: “application\/x-mpegURL”, “url”: “https:\/\/video.twimg.com\/ext_tw_video\/1370161464028196868\/pu\/pl\/EGVpuZpo-wYxTNCq.m3u8?tag=12” }, { “bitrate”: 632000, “content_type”: “video\/mp4”, “url”: “https:\/\/video.twimg.com\/ext_tw_video\/1370161464028196868\/pu\/vid\/320x568\/M7VtocAwKPFdkqzF.mp4?tag=12” } ] }, “additional_media_info”: { “monetizable”: false } }] }	{ “data”: [{ “entities”: { “hashtags”: [{ “start”: 8, “end”: 13, “tag”: “test” }], “mentions”: [{ “start”: 31, “end”: 42, “username”: “TwitterDev” }], “urls”: [{ “start”: 91, “end”: 114, “url”: “https://t.co/XVLZ3uwikc”, “expanded_url”: “https://developer.x.com/en”, “display_url”: “developer.x.com/en”, “status”: 200, “title”: “Use Cases, Tutorials, & Documentation”, “description”: “Publish & analyze Tweets, optimize ads, & create unique customer experiences with the Twitter API, Twitter Ads API, & Twitter for Websites. Let’s start building.”, “unwound_url”: “https://developer.x.com/en” }, { “start”: 115, “end”: 138, “url”: “https://t.co/dz4oByygWA”, “expanded_url”: “https://x.com/furiouscamper/status/1370161532013735937/video/1”, “display_url”: “pic.x.com/dz4oByygWA” } ] }, “id”: “1370161532013735937”, “text”: “Another #test with a video and @TwitterDev mention. Excited for new format migration docs! https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”, “attachments”: { “media_keys”: [ “7_1370161464028196868” ] } }], “includes”: { “media”: [{ “type”: “video”, “height”: 1280, “public_metrics”: { “view_count”: 37 }, “width”: 720, “media_key”: “7_1370161464028196868”, “duration_ms”: 5140, “preview_image_url”: “https://pbs.twimg.com/ext\_tw\_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg” }], “users”: [{ “public_metrics”: { “followers_count”: 517233, “following_count”: 2034, “tweet_count”: 3677, “listed_count”: 1727 }, “created_at”: “2013-12-14T04:35:55.000Z”, “profile_image_url”: “https://pbs.twimg.com/profile\_images/1354494203451961345/d8HkZl6p\_normal.jpg”, “description”: “The voice of the #TwitterDev team and your official source for updates, news, and events, related to the #TwitterAPI.”, “verified”: true, “id”: “2244994945”, “username”: “TwitterDev”, “protected”: false, “entities”: { “url”: { “urls”: [{ “start”: 0, “end”: 23, “url”: “https://t.co/3ZX3TNiZCY”, “expanded_url”: “https://developer.x.com/en/community”, “display_url”: “developer.x.com/en/community” }] }, “description”: { “hashtags”: [{ “start”: 17, “end”: 28, “tag”: “TwitterDev” }, { “start”: 105, “end”: 116, “tag”: “TwitterAPI” } ] } }, “url”: “https://t.co/3ZX3TNiZCY”, “name”: “Twitter Dev”, “location”: “127.0.0.1” }] } }

---

Place object

Twitter 1.1 format	Twitter v2 format	Required v2 parameters
place	data.geo.place_id	tweet.fields=geo
place.id	includes.places.id	expansions=geo.place_id
place.id.place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type
place.id.name	includes.places.name	expansions=geo.place_id&place.fields=name
place.id.full_name	includes.places.full_name	expansions=geo.place_id
place.id.country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code
place.id.country	includes.places.country	expansions=geo.place_id&place.fields=country
place.id.contained_within	includes.places.contained_within	expansions=geo.place_id&place.fields=contained_within
place.id.bounding_box.type	includes.places.geo.type	expansions=geo.place_id&place.fields=place_type
place.id.bounding_box.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo
place.id.attributes	includes.places.properties	expansions=geo.place_id&place.fields=geo

Example

Place object in v1.1	Place object with v2 https://api.x.com/2/tweets?ids=1370161532013735937&expansions=geo.place\_id&tweet.fields=geo&place.fields=contained\_within,country,country\_code,full\_name,geo,id,name,place_type
”place”: { “id”: “f7eb2fa2fea288b1”, “url”: “https:\/\/api.x.com\/1.1\/geo\/id\/f7eb2fa2fea288b1.json”, “place_type”: “city”, “name”: “Lakewood”, “full_name”: “Lakewood, CO”, “country_code”: “US”, “country”: “United States”, “contained_within”: [], “bounding_box”: { “type”: “Polygon”, “coordinates”: [ [ [ -105.193475, 39.60973 ], [ -105.053164, 39.60973 ], [ -105.053164, 39.761974 ], [ -105.193475, 39.761974 ] ] ] }, “attributes”: }	{ “data”: [{ “id”: “1370161532013735937”, “text”: “Another #test with a video and @TwitterDev mention. Excited for new format migration docs! https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”, “geo”: { “place_id”: “f7eb2fa2fea288b1” } }], “includes”: { “places”: [{ “name”: “Lakewood”, “place_type”: “city”, “full_name”: “Lakewood, CO”, “id”: “f7eb2fa2fea288b1”, “geo”: { “type”: “Feature”, “bbox”: [ -105.193475, 39.60973, -105.053164, 39.761974 ], “properties”: }, “country_code”: “US”, “country”: “United States” }] }

Next step

• Learn more about fields
• Learn more about expansions
• Learn how to use fields with expansions

Migrating from Native Enriched data format to v2

The Native Enriched data format is used by our enterprise products.

The Native Enriched data format has been updated to provide edited Tweet metadata. To learn more about Edit Tweet metadata, check out the Edit Tweets fundamentals page.

If you are using the standard v1.1 endpoints, please refer to the standard v1.1 to v2 guide. If you are using the enterprise products with Activity Streams, we have an Activity Streams to v2 guide for you as well.

X API v2 introduces new JSON designs for Tweet and user objects.

• At the JSON root level, the Native Enriched format returns Tweet objects in a results array, while X API v2 returns a data array. 
• Instead of using both favorites (in Tweet object) and favourites (in user object), X API v2 uses the term like. 
• X is adopting the convention that JSON values with no value (for example, null) are not written to the payload. Tweet and user attributes are only included if they have non-null values. 
• All id fields in v2 will be in string format  

In addition to the changes made to the new JSON format, we also introduced a new set of fields to the Tweet object including the following:

• conversation_id
• reply_settings
• alt_text on media
• Two new annotations fields, including context and entities
• Several new metrics fields
• Several new polls fields  

Many legacy and deprecated fields are being removed:

• contributors
• Certain entities.media and extended_entities.media fields
• filter_level
• timestamp_ms
• truncated

Native Enriched vs v2 payload structure

The following table displays the high-level objects and format that you can expect to receive from v2 compared to the Native Enriched format.

	Native Enriched structure	v2 structure
Default	{ tweet object fields, “user”: , “place”: , “entities”: { “hashtags”: [], “urls”: [], “user_mentions”: [], “symbols”: [], “annotations”: [], “media”: [] }, “extended_entities”: , “matching_rules”: [] }	{ “data”: [{ “id”, “text”, “edit_history_tweet_ids” }] }
With defined field and expansion parameters		{ “data”: [{ tweet object fields, “entities”: { “hashtags”: [], “cashtags”: [], “mentions”: [], “urls”: [], }, “attachments”: { “media_keys”: [], “poll_ids”: [] } }], “includes”: [ “tweets”: [user objects], “users”: [user objects], “media”: [media objects], “places”: [place object], “polls”: [poll object] ], “matching_rules”: [] }

Field mapping

The following section describes which native enriched fields map to v2 fields, as well as which v2 parameters are required to receive the new field.  

Tweet object

Native Enriched format	Twitter v2 format	Required v2 parameters	Type in v2
created_at	data.created_at	tweet.fields=created_at	String
id		N/A - See id
id_str	data.id	Default	String
text	data.text	Default	String
edit_history	data.edit_history_tweet_ids	Default	Array
edit_controls	data.edit_controls	tweet.fields=edit_controls	Object
editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls	Boolean
display_text_range		N/A - text includes complete text
source	data.source	tweet.fields=source	String
truncated		N/A - text includes complete text
Not available	data.conversation_id	tweet.fields=conversation_id	String
Not available	data.reply_settings	tweet.fields=reply_settings	String
in_reply_to_status_id		N/A - See referenced_tweets.id
in_reply_to_status_id_str	data.referenced_tweets.id (if type=replied_to)	expansions=referenced_tweets.id	String
in_reply_to_user_id		N/A - See in_reply_to_user_id_str
in_reply_to_user_id_str	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id	String
in_reply_to_screen_name	includes.users..username	tweet.fields=in_reply_to_user_id&expansions=entities.mentions.username	String
user	includes.users	expansions=author_id	Object
user.id_str	data.author_id	tweet.fields=author_id	String
geo	data.geo.place_id	tweet.fields=geo
coordinates	data.geo.place_id	tweet.fields=geo
place	data.geo.place_id	tweet.fields=geo
is_quoted_status	data.referenced_tweets.id (if type=quoted)	tweet.fields=referenced_tweets	String
extended_tweet.full_text		N/A - text is complete text
Not available	data.public_metrics	tweet.fields=public_metrics	Object
quote_count	data.public_metrics.quote_count	tweet.fields=public_metrics	Int
reply_count	data.public_metrics.reply_count	tweet.fields=public_metrics	Int
retweet_count	data.public_metrics.retweet_count	tweet.fields=public_metrics	Int
favorite_count	data.public_metrics.like_count	tweet.fields=public_metrics	Int
Not available	data.non_public_metrics	tweet.fields=non_public_metrics	Object
Not available	data.non_public_metrics.impression_count	tweet.fields=non_public_metrics	Int
Not available	data.non_public_metrics.url_link_count	tweet.fields=non_public_metrics	Int
Not available	data.non_public_metrics.user_profile_count	tweet.fields=non_public_metrics	Int
Not available	data.organic_metrics	tweet.fields=organic_metrics	Object
Not available	data.organic_metrics.like_count	tweet.fields=organic_metrics	Int
Not available	data.organic_metrics.retweet_count	tweet.fields=organic_metrics	Int
Not available	data.organic_metrics.reply_count	tweet.fields=organic_metrics	Int
Not available	data.organic_metrics.impression_count	tweet.fields=organic_metrics	Int
Not available	data.organic_metrics.url_link_count	tweet.fields=organic_metrics	Int
Not available	data.organic_metrics.user_profile_count	tweet.fields=organic_metrics	Int
Not available	data.promoted_metrics	tweet.fields=promoted_metrics	Object
Not available	data.promoted_metrics.like_count	tweet.fields=promoted_metrics	Int
Not available	data.promoted_metrics.retweet_count	tweet.fields=promoted_metrics	Int
Not available	data.promoted_metrics.reply_count	tweet.fields=promoted_metrics	Int
Not available	data.promoted_metrics.impression_count	tweet.fields=promoted_metrics	Int
Not available	data.promoted_metrics.url_link_count	tweet.fields=promoted_metrics	Int
Not available	data.promoted_metrics.user_profile_count	tweet.fields=promoted_metrics	Int
contributors	Not available	Not available
entities	data.entities	tweet.fields=entities	Object
entities.user_mentions	data.entities.mentions	tweet.fields=entities	Array of objects
entities.symbols	data.entities.cashtags	tweet.fields=entities	Array of objects
entities.hashtags	data.entities.hashtags	tweet.fields=entities	Array of objects
entities.urls	data.entities.urls	tweet.fields=entities	Array of objects
entities.media	includes.media	expansions=attachments.media_keys	Array of objects
entities.annotations		tweet.fields=entities,context_annotations	Object
entities.annotations.context	data.context_annotations	tweet.fields=entities,context_annotations	Array of objects
No equivalent	data.context_annotations.domain	tweet.fields=context_annotations	Object
entities.annotations.context.context_domain_id_str	data.context_annotations.domain.id	tweet.fields=context_annotations	String
entities.annotations.context.context_domain_id	Not available	Not available - see data.context_annotations.domain.id for string format
entities.annotations.context.context_domain_name	data.context_annotations.domain.name	tweet.fields=context_annotations	String
entities.annotations.context.context_domain_description	data.context_annotations.domain.description	tweet.fields=context_annotations	String
No equivalent	data.context_annotations.entity	tweet.fields=context_annotations	Object
entities.annotations.context.context_entity_id_str	data.context_annotations.entity.id	tweet.fields=context_annotations	String
entities.annotations.context.context_entity_id	Not available	Not available - see data.context_annotations.entity.id for string format
entities.annotations.context.context_entity_name	data.context_annotations.entity.name	tweet.fields=context_annotations	String
entities.annotations.context.context_entity_description	data.context_annotations.entity.description	tweet.fields=context_annotations	String
entities.annotations.entity	data.entities.annotations	tweet.fields=entities,context_annotations	Array of objects
extended_entities	data.attachments	tweet_fields=attachments	Object
favorited	Not available	Not available
retweeted	Not available	Not available
retweeted_status
possibly_sensitive	data.possibly_sensitive	tweet.fields=possibly_sensitive	Boolean
lang	data.lang	tweet.fields=lang	String
filter_level	Not available	Not available
scopes	Not available	Not available
timestamp_ms	Not available	Not available
withheld	data.withheld	tweet.fields=withheld	Array of objects
matching_rules	matching_rules		Array of objects
matching_rules.id	Not available	Not available
matching_rules.id_str	matching_rules.id	Default with filtered stream	String
matching_rules.tag	matching_rules.tag	Default with filtered stream	String

User object

Native Enriched format	Twitter v2 format	Required v2 parameters	Type in v2
user	includes.users	expansions=author_id	Array of objects
user.id	Not available	N/A - See includes.users.id	String
user.id_str	includes.users.id	expansions=author_id	String
user.name	includes.users.name	expansions=author_id	String
user.screen_name	includes.user.username	expansions=author_id	String
user.location	includes.users.location	expansions=author_id&user.fields=location	Object
user.description	includes.users.description	expansions=author_id&user.fields=description	String
Not available	includes.users.url	expansions=author_id&user.fields=url	String
user.followers_count	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics	Int
user.friends_count	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics	Int
user.listed_count	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics	Int
user.created_at	includes.users.created_at	expansions=author_id&user.fields=created_at	String
user.favourites_count		Not yet available
user.verified	includes.users.verified	expansions=author_id&user.fields=verified	Boolean
Not available	includes.users.pinned_tweet_id	expansions=author_id&user.fields=pinned_tweet_id	String
user.statuses_count	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics	Int
user.profile_image_url_https	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url	String
user.translator_type	Not available	Not available
user.utc_offset	Not available	Not available
user.time_zone	Not available	Not available
user.geo_enabled	Not available	Not available
user.lang	Not available	Not available - infer from Tweet lang
user.contributors_enabled	Not available	Not available
user.is_translator	Not available	Not available
user.profile_background_color	Not available	Not available
user.profile_background_image_url	Not available	Not available
user.profile_background_image_url_https	Not available	Not available
user.profile_background_title	Not available	Not available
user.profile_sidebar_border_color	Not available	Not available
user.profile_sidebar_fill_color	Not available	Not available
user.profile_text_color	Not available	Not available
user.profile_user_background_image	Not available	Not available
user.profile_image_url		See includes.user.profile_image_url
user.default_profile	Not available	Not available
user.default_profile_image	Not available	Not available
user.following	Not available	Not available
user.follow_request_sent	Not available	Not available
user.notifications	Not available	Not available
user.withheld_in_countries	includes.users.withheld	expansions=author_id&user.fields=withheld	Object
user.protected	includes.users.protected	expansions=author_id&user.fields=protected	Boolean
Not available	includes.users.entities	expansions=author_id&user.fields=entities	Object
Not available	includes.users.entities.url	expansions=author_id&user.fields=entities	Object
Not available	includes.users.entities.url.urls	expansions=author_id&user.fields=entities	Array of objects
Not available	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities	Int
Not available	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities	Int
Not available	includes.users.entities.url.urls.url	expansions=author_id&user.fields=entities	String
user.url	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities	String
Not available	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities	String
Not available	includes.users.entities.descriptions	expansions=author_id&user.fields=entities	Object
Not available	includes.users.entities.descriptions.hashtags	expansions=author_id&user.fields=entities	Array of objects
Not available	includes.users.entities.descriptions.hashtags.start	expansions=author_id&user.fields=entities	Int
Not available	includes.users.entities.descriptions.hashtags.end	expansions=author_id&user.fields=entities	Int
included in user.description	includes.users.entities.descriptions.hashtags.tag	expansions=author_id&user.fields=entities	String
Not available	includes.users.entities.descriptions.mentions	expansions=author_id&user.fields=entities	Array of objects
Not available	includes.users.entities.descriptions.mentions.start	expansions=author_id&user.fields=entities	Int
Not available	includes.users.entities.descriptions.mentions.end	expansions=author_id&user.fields=entities	Int
Included in user.description	includes.users.entities.descriptions.mentions.username	expansions=author_id&user.fields=entities	String
Not available	includes.users.entities.descriptions.cashtags	expansions=author_id&user.fields=entities	Array of objects
Not available	includes.users.entities.descriptions.cashtags.start	expansions=author_id&user.fields=entities	Int
Not available	includes.users.entities.descriptions.cashtags.end	expansions=author_id&user.fields=entities	Int
Included in user.description	includes.users.entities.descriptions.cashtags.tag	expansions=author_id&user.fields=entities	String

Entities and expanded entities objects

Native Enriched format	Twitter v2 format	Required v2 parameters	Type in v2
entities	data.entities	tweet.fields=entities	Object
entities.hashtags	data.entities.hashtags	tweet.fields=entities	Array of objects
entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	Integer
entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	Integer
entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	String
entities.urls	data.entities.urls	tweet.fields=entities	Array of objects
entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	Integer
entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	Integer
entities.urls.url	data.entities.urls.url	tweet.fields=entities	String
entities.urls.expanded_url	data.entities.urls.expanded_url	tweet.fields=entities	String
entities.urls.display_url	data.entities.urls.display_url	tweet.fields=entities	String
entities.urls.unwound.url	data.entities.urls.unwound_url	tweet.fields=entities	String
entities.urls.unwound.status	data.entities.urls.status	tweet.fields=entities	String
entities.urls.unwound.title	data.entities.urls.title	tweet.fields=entities	String
entities.urls.unwound.description	data.entities.urls.description	tweet.fields=entities	String
Not available	data.entities.urls.images	tweet.fields=entities	Array of objects
Not available	data.entities.urls.images.url	tweet.fields=entities	String
Not available	data.entities.urls.images.width	tweet.fields=entities	Int
Not available	data.entities.urls.images.height	tweet.fields=entities	Int
entities.user_mentions	data.entities.mentions	tweet.fields=entities	Array of objects
entities.user_mentions.indicies[0]	data.entities.mentions.start	tweet.fields=entities	Integer
entities.user_mentions.indicies[1]	data.entities.mentions.end	tweet.fields=entities	Integer
entities.user_mentions.screen_name	data.entities.mentions.username	tweet.fields=entities	String
entities.symbols	data.entities.cashtags	tweet.fields=entities	Array of objects
entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	Integer
entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	Integer
entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	String
entities.media OR extended_entities.media	includes.media	expansions=attachments.media_keys	Array of objects
entities.media.id_str OR extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	String
entities.media.id OR extended_entities.media.id		Not available - id is a String
entities.media.type OR extended_entities.media.type	includes.media.media.type	expansions=attachments.media_keys	String
entities.media.indices OR extended_entities.media.indices	Not available	Not available
Not available	includes.media.alt_text	expansions=attachments.media_keys&media.fields=alt_text	String
entities.media.additional_media_info OR extended_entities.media.additional_media_info	Not available	Not available
entities.media.additional_media_info.monetizable OR extended_entities.media.additional_media_info.monetizable	Not available	Not available
entities.media.media_url OR extended_entities.media.media_url		N/A - See includes.media.url	String
entities.media.media_url_https OR extended_entities.media.media_url_https	includes.media.url	expansions=attachments.media_keys&media.fields=url	String
entities.media.url OR extended_entities.media.url
entities.media.display_url OR extended_entities.media.expanded_url
entities.media.expanded_url
entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	String
extended_entities	data.attachments	tweet_fields=attachments	Object
extended_entities	data.attachments.media_keys	tweet.fields=attachments	Array of objects
Not available	data.attachments.poll_ids	tweet.fields=attachments	Array of objects
extended_entities.media.sizes.thumb.w		Not Available
extended_entities.media.sizes.thumb.h		Not Available
extended_entities.media.sizes.thumb.resize		Not Available
extended_entities.media.sizes.large.w	includes.media.height	expansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.h	includes.media.width	expansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize	Not Available	Not Available
extended_entities.media.sizes.small.w	Not Available	Not Available
extended_entities.media.sizes.small.h	Not Available	Not Available
extended_entities.media.sizes.small.resize	Not Available	Not Available
extended_entities.media.sizes.medium.w	Not Available	Not Available
extended_entities.media.sizes.medium.h	Not Available	Not Available
extended_entities.media.sizes.medium.resize	Not Available	Not Available
extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	String
extended_entities.media.video_info.aspect_ratio	Not available	Not available
extended_entities.media.variants	Not available	Not available
extended_entities.media.variants.bitrate	Not available	Not available
extended_entities.media.variants.content_type	Not available	Not available
extended_entities.media.variants.url	Not available	Not available
extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	Int
Not available	includes.media.public_metrics	expansions=attachments.media_keys&media.fields=public_metrics	Object
Not available	includes.media.public_metrics.view_count	expansions=attachments.media_keys&media.fields=public_metrics	Int
Not available	includes.media.non_public_metrics	expansions=attachments.media_keys&media.fields=non_public_metrics	Object
Not available	includes.media.non_public_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.organic_metrics	expansions=attachments.media_keys&media.fields=organic_metrics	Object
Not available	includes.media.organic_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.view_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.promoted_metric	expansions=attachments.media_keys&media.fields=promoted_metrics	Object
Not available	includes.media.promoted_metric.playback_0_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metric.playback_25_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metric.playback_50_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metric.playback_75_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metric.playback_100_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.view_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int

Place object

Native Enriched format	Twitter v2 format	Required v2 parameters	Type in v2
place	includes.places	expansions=geo.place_id	Array of objects
place.id	includes.places.id	expansions=geo.place_id	String
place.url	Not available	Not available
place.id.place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type	String
place.id.name	includes.places.name	expansions=geo.place_id&place.fields=name	String
place.id.full_name	includes.places.full_name	expansions=geo.place_id	String
place.id.country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code	String
place.id.country	includes.places.country	expansions=geo.place_id&place.fields=country	String
place.id.contained_within	includes.places.contained_within	expansions=geo.place_id&place.fields=contained_within	Array
place.id.bounding_box.type	includes.places.geo.type	expansions=geo.place_id&place.fields=place_type	String
place.id.bounding_box.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo	Array
place.id.attributes	includes.places.properties	expansions=geo.place_id&place.fields=geo	Object

Poll object

Native Enriched format	Twitter v2 format	Required v2 parameters	Type in v2
entities.polls	includes.polls	expansions=attachments.poll_ids	Array of objects
Not available	includes.polls.id	expansions=attachments.poll_ids	String
entities.poll.options	includes.polls.options	expansions=attachments.poll_ids	Array of objects
entities.polls.options.position	includes.polls.options.position	expansions=attachments.poll_ids	Int
entities.polls.options.text	includes.polls.options.label	expansions=attachments.poll_ids	String
Not available	includes.polls.options.votes	expansions=attachments.poll_ids	Int
Not available	includes.polls.voting_status	expansions=attachments.poll_ids&poll.fields=voting_status	String
entities.polls.duration_minutes	includes.polls.duration_minutes	expansions=attachments.poll_ids&poll.fields=duration_minutes	Int
entities.polls.end_datetime	includes.polls.end_datetime	expansions=attachments.poll_ids&poll.fields=end_datetime	Date (ISO 8601)

Migrating from Activity Streams data format to v2

The Activity Streams data format is available with our enterprise products.

The Activity Streams data format has been updated to provide edited Tweet metadata. To learn more about Edit Tweet metadata, check out the Edit Tweets fundamentals page.

If you are using the standard v1.1 endpoints, please refer to the standard v1.1 to v2 guide. If you are using the premium endpoints, or the Native Enriched format for enterprise, please refer to the Native Enriched to v2 guide.

X API v2 introduces new JSON designs for Post and user objects.

• At the JSON root level, the Activity Streams format returns Tweet objects in a results array, while X API v2 returns a data array. 
• Instead of referring to Retweeted and Quoted “activities”, X API v2 JSON refers to Retweeted and Quoted Tweets. 
• Instead of using both favorites (in Tweet object) and favourites (in user object), X API v2 uses the term like. 
• Twitter is adopting the convention that JSON values with no value (for example, null) are not written to the payload. Tweet and user attributes are only included if they have non-null values. 
• All id fields in v2 will be in string format.  

In addition to the changes made to the new JSON format, we also introduced a new set of fields to the Tweet object including the following:

• conversation_id
• reply_settings
• alt_text on media
• Two new annotations fields, including context and entities
• Several new metrics fields
• Several new polls fields  

Many legacy and deprecated fields are being removed or replaced:

• display_text_range
• generator
• gnip
• link
• objectType
• provider
• twitter_entities.symbols replaced with data.entities.cashtags
• Certain twitter_extended_entities.media and twitter_entities.media fields
• twitter_filter_level
• twitterTimeZone
• verb

Tweet object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
postedTime	data.created_at	tweet.fields=created_at	Date (ISO 8601)
generator	Not Available	Not Available
generator.link	Not Available	Not Available
generator.displayName	data.source	tweet.fields=source	String
twitter_lang	data.lang	tweet.fields=lang	String
Not Available	data.conversation_id	tweet.fields=conversation_id	String
Not Available	data.reply_settings	tweet.fields=reply_settings	String
Not Available	data.possibly_sensitive	tweet.fields=possibly_sensitive	Boolean
Not Available	data.withheld	tweet.fields=withheld	Object
objectType	Not Available	Not Available
verb	Not Available	Not Available
provider	Not Available	Not Available
provider.objectType	Not Available	Not Available
provider.displayName	Not Available	Not Available
provider.link	Not Available	Not Available
link	Not Available	Not Available
display_text_range	Not Available	Not Available
object	Not Available	Not Available
object.objectType	Not Available	Not Available
object.id	Not Available	Not Available
object.summary	data.text	default	String
object.edit_history	data.edit_history_tweet_ids	default	Array
object.edit_controls	data.edit_controls	tweet.fields=edit_controls	Object
object.editable	data.edit_controls.is_edit_eligible	tweet.fields=edit_controls	Boolean
object.link	Not Available	Not Available
object.postedTime	data.created_at	tweet.fields=created_at	Date (ISO 8601)
Derived from actor.id	data.author_id	tweet.fields=created_at
twitter_filter_level	Not Available	Not Available
Derived from username in inReplyTo.link	data.in_reply_to_user_id	tweet.fields=in_reply_to_user_id	String
Not Available	data.referenced_tweets	tweet.fields=referenced_tweets	Array of objects
Not Available	data.referenced_tweets.type	tweet.fields=referenced_tweets	String
Derived from inReplyTo.link	data.referenced_tweets.id	tweet.fields=referenced_tweets	String
Not Available	data.attachments	tweet.fields=attachments	Object
Derived from twitter_entities.media.id_str	data.attachments.media_keys	tweet.fields=attachments	Array
Not Available	data.attachments.poll_ids	tweet.fields=attachments	Array
twitter_entities	data.entities	tweet.fields=entities	Object
Not Available	data.entities.annotations	tweet.fields=entities	Array of objects
Not Available	data.entities.annotations.start	tweet.fields=entities	Int
Not Available	data.entities.annotations.end	tweet.fields=entities	Int
Not Available	data.entities.annotations.probability	tweet.fields=entities	Float
Not Available	data.entities.annotations.type	tweet.fields=entities	String
Not Available	data.entities.annotations.normalized_text	tweet.fields=entities	String
twitter_entities.urls	data.entities.urls	tweet.fields=entities	Array of objects
twitter_entities.urls.indices[0]	data.entities.urls.start	tweet.fields=entities	Int
twitter_entities.urls.indices[1]	data.entities.urls.end	tweet.fields=entities	Int
twitter_entities.urls.url	data.entities.urls.url	tweet.fields=entities	String
twitter_entities.urls.expanded_url	data.entities.urls.expanded_url	tweet.fields=entities	String
twitter_entities.urls.display_url	data.entities.urls.display_url	tweet.fields=entities	String
Not Available	data.entities.urls.images	tweet.fields=entities	Array of objects
Not Available	data.entities.urls.images.url	tweet.fields=entities	String
Not Available	data.entities.urls.images.width	tweet.fields=entities	Int
Not Available	data.entities.urls.images.height	tweet.fields=entities	Int
gnip.urls.expanded_status	data.entities.urls.status	tweet.fields=entities	Int
gnip.urls.expanded_url_title	data.entities.urls.title	tweet.fields=entities	String
gnip.urls.expanded_url_description	data.entities.urls.description	tweet.fields=entities	String
gnip.urls.expanded_url	data.entities.urls.unwound_url	tweet.fields=entities	String
twitter_entities.symbols	data.entities.cashtags	tweet.fields=entities	Array of objects
twitter_entities.symbols.indices[0]	data.entities.cashtags.start	tweet.fields=entities	Int
twitter_entities.symbols.indices[1]	data.entities.cashtags.end	tweet.fields=entities	Int
twitter_entities.symbols.text	data.entities.cashtags.tag	tweet.fields=entities	String
twitter_entities.hashtags	data.entities.hashtags	tweet.fields=entities	Array of objects
twitter_entities.hashtags.indices[0]	data.entities.hashtags.start	tweet.fields=entities	Int
twitter_entities.hashtags.indices[1]	data.entities.hashtags.end	tweet.fields=entities	Int
twitter_entities.hashtags.text	data.entities.hashtags.tag	tweet.fields=entities	String
twitter_entities.user_mentions	data.entities.mentions	tweet.fields=entities	Array of objects
twitter_entities.user_mentions.indices[0]	data.entities.mentions.start	tweet.fields=entities	Int
twitter_entities.user_mentions.indices[1]	data.entities.mentions.end	tweet.fields=entities	Int
twitter_entities.user_mentions.screen_name	data.entities.mentions.tag	tweet.fields=entities	String
twitter_entities.user_mentions.id_str	data.entities.mentions.id	tweet.fields=entities	String
twitter_entities.user_mentions.id	Not Available	Not Available
Not Available	data.context_annotations	tweet.fields=context_annotations	Array of objects
Not Available	data.context_annotations.domain	tweet.fields=context_annotations	Object
Not Available	data.context_annotations.domain.id	tweet.fields=context_annotations	String
Not Available	data.context_annotations.domain.name	tweet.fields=context_annotations	String
Not Available	data.context_annotations.domain.description	tweet.fields=context_annotations	String
Not Available	data.context_annotations.entity	tweet.fields=context_annotations	Object
Not Available	data.context_annotations.entity.id	tweet.fields=context_annotations	String
Not Available	data.context_annotations.entity.name	tweet.fields=context_annotations	String
Not Available	data.context_annotations.entity.description	tweet.fields=context_annotations	String
geo	data.geo	tweet.fields=geo	Object
Derived from location.link	data.geo.place_id	tweet.fields=geo	String
Not Available	data.public_metrics	tweet.fields=public_metrics	Object
favoritesCount	data.public_metrics.like_count	tweet.fields=public_metrics	Int
retweetCount	data.public_metrics.retweet_count	tweet.fields=public_metrics	Int
Not Available	data.public_metrics.quote_count	tweet.fields=public_metrics	Int
Not Available	data.public_metrics.reply_count	tweet.fields=public_metrics	Int
Not Available	data.non_non_public_metrics	tweet.fields=non_public_metrics	Object
Not Available	data.non_public_metrics.impression_count	tweet.fields=non_public_metrics	Int
Not Available	data.non_public_metrics.url_link_count	tweet.fields=non_public_metrics	Int
Not Available	data.non_public_metrics.user_profile_count	tweet.fields=non_public_metrics	Int
Not Available	data.organic_metrics	tweet.fields=organic_metrics	Object
Not Available	data.organic_metrics.like_count	tweet.fields=organic_metrics	Int
Not Available	data.organic_metrics.retweet_count	tweet.fields=organic_metrics	Int
Not Available	data.organic_metrics.reply_count	tweet.fields=organic_metrics	Int
Not Available	data.organic_metrics.impression_count	tweet.fields=organic_metrics	Int
Not Available	data.organic_metrics.url_link_count	tweet.fields=organic_metrics	Int
Not Available	data.organic_metrics.user_profile_count	tweet.fields=organic_metrics	Int
Not Available	data.promoted_metrics	tweet.fields=promoted_metrics	Object
Not Available	data.promoted_metrics.like_count	tweet.fields=promoted_metrics	Int
Not Available	data.promoted_metrics.retweet_count	tweet.fields=promoted_metrics	Int
Not Available	data.promoted_metrics.reply_count	tweet.fields=promoted_metrics	Int
Not Available	data.promoted_metrics.impression_count	tweet.fields=promoted_metrics	Int
Not Available	data.promoted_metrics.url_link_count	tweet.fields=promoted_metrics	Int
Not Available	data.promoted_metrics.user_profile_count	tweet.fields=promoted_metrics	Int
gnip.profileLocations	Not Available	Not Available
gnip.profileLocations.address	Not Available	Not Available
gnip.profileLocations.address.country	Not Available	Not Available
gnip.profileLocations.address.countryCode	Not Available	Not Available
gnip.profileLocations.displayName	Not Available	Not Available
gnip.profileLocations.geo	Not Available	Not Available
gnip.profileLocations.geo.coordinates	Not Available	Not Available
gnip.profileLocations.geo.type	Not Available	Not Available
gnip.profileLocations.objectType	Not Available	Not Available

User object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
actor	includes.users	expansions=author_id	Array of objects
Derived from actor.id	includes.users.id	expansions=author_id	String
actor.displayName	includes.users.name	expansions=author_id	String
actor.preferredUsername	includes.users.username	expansions=author_id	String
actor.postedTime	includes.users.created_at	expansions=author_id&user.fields=created_at	Date (ISO 8601)
actor.summary	includes.users.description	expansions=author_id&user.fields=description	String
Not Available	includes.users.pinned_tweet_id	expansions=author_id&user.fields=pinned_tweet_id	String
Not Available	includes.users.protected	expansions=author_id&user.fields=protected	Boolean
actor.link	Not Available	Not Available - construct from includes.users.username
actor.twitterTimeZone	Not Available	Not Available - infer from Tweet created_at
actor.utcOffset	Not Available	Not Available - infer from Tweet created_at
actor.favoritesCount	Not Available	Not Available
actor.followersCount	includes.users.public_metrics.followers_count	expansions=author_id&user.fields=public_metrics	Int
actor.friendsCount	includes.users.public_metrics.following_count	expansions=author_id&user.fields=public_metrics	Int
actor.listedCount	includes.users.public_metrics.listed_count	expansions=author_id&user.fields=public_metrics	Int
actor.statusesCount	includes.users.public_metrics.tweet_count	expansions=author_id&user.fields=public_metrics	Int
actor.languages[]	Not Available	Not Available -  infer from Tweet  lang
actor.location.displayName	includes.users.location	expansions=author_id&user.fields=location	String
actor.image	includes.users.profile_image_url	expansions=author_id&user.fields=profile_image_url	String
actor.links	includes.users.url	expansions=author_id&user.fields=url	String
actor.verified	includes.users.verified	expansions=author_id&user.fields=verified	Boolean
Not Available	includes.users.withheld	expansions=author_id&user.fields=withheld	Object
Not Available	includes.users.entities	expansions=author_id&user.fields=entities	Object
Not Available	includes.users.entities.url	expansions=author_id&user.fields=entities	Object
actor.links	includes.users.entities.url.urls	expansions=author_id&user.fields=entities	Array of objects
Not Available	includes.users.entities.url.urls.start	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.url.urls.end	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.url.urls.url	expansions=author_id&user.fields=entities	String
actor.links.href	includes.users.entities.url.urls.expanded_url	expansions=author_id&user.fields=entities	String
Not Available	includes.users.entities.url.urls.display_url	expansions=author_id&user.fields=entities	String
Not Available	includes.users.entities.description	expansions=author_id&user.fields=entities	Object
Not Available	includes.users.entities.description.hashtags	expansions=author_id&user.fields=entities	Array of objects
Not Available	includes.users.entities.description.hashtags.start	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.hashtags.end	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.hashtags.tag	expansions=author_id&user.fields=entities	String
Not Available	includes.users.entities.description.mentions	expansions=author_id&user.fields=entities	Array of objects
Not Available	includes.users.entities.description.mentions.start	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.mentions.end	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.mentions.username	expansions=author_id&user.fields=entities	String
Not Available	includes.users.entities.description.cashtags	expansions=author_id&user.fields=entities	Array of objects
Not Available	includes.users.entities.description.cashtags.start	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.cashtags.end	expansions=author_id&user.fields=entities	Int
Not Available	includes.users.entities.description.cashtags.tag	expansions=author_id&user.fields=entities	String

Poll object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
Not Available	includes.polls	expansions=attachments.poll_ids	Array of objects
Not Available	includes.polls.id	expansions=attachments.poll_ids	String
Not Available	includes.polls.options	expansions=attachments.poll_ids	Array of objects
Not Available	includes.polls.options.position	expansions=attachments.poll_ids	Int
Not Available	includes.polls.options.label	expansions=attachments.poll_ids	String
Not Available	includes.polls.options.votes	expansions=attachments.poll_ids	Int
Not Available	includes.polls.voting_status	expansions=attachments.poll_ids&poll.fields=voting_status	String
Not Available	includes.polls.duration_minutes	expansions=attachments.poll_ids&poll.fields=duration_minutes	Int
Not Available	includes.polls.end_datetime	expansions=attachments.poll_ids&poll.fields=end_datetime	Date (ISO 8601)

Place object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
location	includes.places	expansions=geo.place_id	array of objects
location.displayName	includes.places.full_name	expansions=geo.place_id	string
Parsed from location.link	includes.places.id	expansions=geo.place_id	string
location.name	includes.places.name	expansions=geo.place_id&place.fields=name	string
location.country_code	includes.places.country	expansions=geo.place_id&place.fields=country	string
location.twitter_place_type	includes.places.place_type	expansions=geo.place_id&place.fields=place_type	string
location.twitter_country_code	includes.places.country_code	expansions=geo.place_id&place.fields=country_code	string
location.geo	includes.places.geo	expansions=geo.place_id&place.fields=geo	object
location.geo.type	includes.places.geo.type	expansions=geo.place_id&place.fields=geo	string
location.geo.coordinates	includes.places.geo.bbox	expansions=geo.place_id&place.fields=geo	array
Not Available	includes.places.geo.properties	expansions=geo.place_id&place.fields=geo	object

Media object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
twitter_entities.media OR twitter_extended_entities.media	includes.media	expansions=attachments.media_keys	Array of objects
twitter_entities.media.id_str OR twitter_extended_entities.media.id_str	includes.media.media_key	expansions=attachments.media_keys	String
twitter_entities.media.id OR twitter_extended_entities.media.id	Not available	Not available
twitter_entities.media.indices OR twitter_extended_entities.media.indices	Not available	Not available
twitter_entities.media.additional_media_info OR twitter_extended_entities.media.additional_media_info	Not available	Not available
twitter_entities.media.additional_media_info.monetizable OR twitter_extended_entities.media.additional_media_info.monetizable	Not available	Not available
twitter_entities.media.media_url OR twitter_extended_entities.media.media_url	Not available	Not available
twitter_entities.media.media_url_https OR twitter_extended_entities.media.media_url_https	includes.media.preview_image_url	expansions=attachments.media_keys&media.fields=preview_image_url	String
twitter_entities.media.url OR twitter_extended_entities.media.url	Not available	Not available
twitter_entities.media.display_url OR twitter_extended_entities.media.display_url	Not available	Not available
twitter_entities.media.expanded_url OR twitter_extended_entities.media.expanded_url	Not available	Not available
twitter_entities.media.type OR twitter_extended_entities.media.type	includes.media.type	expansions=attachments.media_keys	String
twitter_entities.media.sizes OR twitter_extended_entities.media.sizes	Not available	Not available
twitter_entities.media.sizes.thumb OR twitter_extended_entities.media.sizes.thumb	Not available	Not available
twitter_entities.media.sizes.thumb.h OR twitter_extended_entities.media.sizes.thumb.h	Not available	Not available
twitter_entities.media.sizes.thumb.w OR twitter_extended_entities.media.sizes.thumb.w	Not available	Not available
twitter_entities.media.sizes.thumb.resize OR twitter_extended_entities.media.sizes.thumb.resize	Not available	Not available
twitter_entities.media.sizes.small OR twitter_extended_entities.media.sizes.small	Not available	Not available
twitter_entities.media.sizes.small.h OR twitter_extended_entities.media.sizes.small.h	Not available	Not available
twitter_entities.media.sizes.small.w OR twitter_extended_entities.media.sizes.small.w	Not available	Not available
twitter_entities.media.sizes.small.resize OR twitter_extended_entities.media.sizes.small.resize	Not available	Not available
twitter_entities.media.sizes.medium OR twitter_extended_entities.media.sizes.medium	Not available	Not available
twitter_entities.media.sizes.medium.h OR twitter_extended_entities.media.sizes.medium.h	Not available	Not available
twitter_entities.media.sizes.medium.w OR twitter_extended_entities.media.sizes.medium.w	Not available	Not available
twitter_entities.media.sizes.medium.resize OR twitter_extended_entities.media.sizes.medium.resize	Not available	Not available
twitter_entities.media.sizes.large OR twitter_extended_entities.media.sizes.large	Not available	Not available
twitter_entities.media.sizes.large.h OR twitter_extended_entities.media.sizes.large.h	includes.media.height	expansions=attachments.media_keys&media.fields=height	Int
twitter_entities.media.sizes.large.w OR twitter_extended_entities.media.sizes.large.w	includes.media.width	expansions=attachments.media_keys&media.fields=width	Int
twitter_entities.media.sizes.large.resize OR twitter_extended_entities.media.sizes.large.resize	Not available	Not available
twitter_extended_entities.media.video_info	Not available	Not available
twitter_extended_entities.media.video_info.aspect_ratio	Not available	Not available
twitter_extended_entities.media.video_info.duration_millis	includes.media.duration_ms	expansions=attachments.media_keys&media.fields=duration_ms	Int
twitter_extended_entities.media.video_info.variants	Not available	Not available
twitter_extended_entities.media.video_info.variants.bitrate	Not available	Not available
twitter_extended_entities.media.video_info.variants.content_type	Not available	Not available
twitter_extended_entities.media.video_info.variants.url	Not available	Not available
Not available	includes.media.alt_text	expansions=attachments.media_keys&media.fields=alt_text	String
Not available	includes.media.public_metrics	expansions=attachments.media_keys&media.fields=public_metrics	Object
Not available	includes.media.public_metrics.view_count	expansions=attachments.media_keys&media.fields=public_metrics	Int
Not available	includes.media.non_public_metrics	expansions=attachments.media_keys&media.fields=non_public_metrics	Object
Not available	includes.media.non_public_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.non_public_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=non_public_metrics	Int
Not available	includes.media.organic_metrics	expansions=attachments.media_keys&media.fields=organic_metrics	Object
Not available	includes.media.organic_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.organic_metrics.view_count	expansions=attachments.media_keys&media.fields=organic_metrics	Int
Not available	includes.media.promoted_metrics	expansions=attachments.media_keys&media.fields=promoted_metrics	Object
Not available	includes.media.promoted_metrics.playback_0_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.playback_25_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.playback_50_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.playback_75_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.playback_100_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int
Not available	includes.media.promoted_metrics.view_count	expansions=attachments.media_keys&media.fields=promoted_metrics	Int

Matching rules object

Activity Streams format	Twitter v2 format	Required v2 parameters	Type in v2
gnip.matching_rules	matching_rules	Default in filtered stream	Array of objects
gnip.matching_rules.tag	matching_rules.tag	Default in filtered stream	String
gnip.matching_rules.tag.id	Not Available	Not Available
gnip.matching_rules.tag.id_str	matching_rules.id	Default in filtered stream	String

Visual data format migration tool

The visual data format migration tool is a web application that displays the fields that map from the X API v1.1. data format to the X API v2 format for a given Tweet or user object. Either a Tweet ID or user ID can be provided to the application to see this mapping.

Please note that you will need to log in with your Twitter account in order to use the app.

Try the visual data format migration tool