跳转到主要内容

​
介绍

随着 X API v2 的推出，我们采用了全新的 data 响应格式以及请求不同对象和 fields 的方式，我们将其统称为 X API v2 格式。  在“常规差异”部分，您可以了解与标准版和企业版用户相关的一些变更。此外，我们还整理了面向 standard v1.1 的 Native 格式、企业版的 Native Enriched 格式以及企业版的 Activity Streams 格式的专门指南，用于字段映射，并说明在请求新的 v2 fields 时必须使用哪些 fields 和 expansions。  您可能也会对我们的可视化数据格式迁移工具感兴趣，用于快速对比 X API v1.1 数据格式与 X API v2 格式 之间的差异。

​
常见差异

​
请求对象和字段

v2 之前的端点与 v2 相比，最大变化之一在于：新版本默认仅返回少量字段，而标准版、高级版和企业版端点默认会返回大多数字段。新版本通过 fields 和 expansions 参数来明确请求超出默认范围的额外 data，这意味着你可以只请求所需的 data，而无需处理与你无关的字段。  你请求的任何与主 data 对象相关的字段，都会连同默认值一起返回在该主 data 对象中。但是，如果你使用 expansions 参数请求任何被展开的对象，这些次级对象将返回在新的 includes 对象中。你可以使用同时出现在两者中的 id 字段，将 includes 中的展开对象与主对象进行匹配。 例如，如果你使用 v2 的 Post lookup 端点，并在请求中包含 expansions=author_id 参数，你将在主 Post 对象中收到 author_id 字段，同时还会在 includes 中为每个 Post 收到一个 user 对象，每个对象都会包含默认的 id 字段，可用于将该 user 对象匹配回对应的 Post 对象。下面是示例： 
{
  "data": [
    {
      "author_id": "2244994945",
      "id": "1397568983931392004",
      "text": "X 开发者平台。太棒了！https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "X Dev",
        "username": "XDev"
      }
    ]
  }
}

​
更新的 JSON 设计

除了更改请求特定 fields 的方式之外，X API v2 还为 API 返回的对象引入了新的 JSON 设计，包括 Post 和 user 对象。
  • 在 JSON 根级，标准端点会在 statuses 数组中返回 Post 对象，而 X API v2 则返回 data 数组。
  • X API v2 的 JSON 不再将“转发”和“引用”称为“statuses”，而是称为 Retweeted 和 Quoted Tweets。许多传统与已弃用的字段（例如 contributors 和 user.translator_type）将被移除。
  • X API v2 不再在 Post 对象中使用 favorites、在 user 对象中使用 favourites，而是统一使用术语 like。
  • X 采用的约定是：无值的 JSON 字段（例如 null）不会写入负载。仅当 Post 和 user 的属性为非空时才会包含。   

​
新的 v2 字段

我们还为Post 对象引入了一组新字段，包括：
  • 一个 conversation_id 字段
  • 两个新的 annotations 字段：context 和 entities
  • 多个新的 metrics 字段
  • 一个新的 reply_setting 字段，用于显示哪些人可以回复某条特定的 Post

​
从标准 v1.1 的 data 格式迁移到 v2

如果你尚未阅读，我们建议先查看data 格式迁移简介。你也可以使用我们的可视化 data 格式迁移工具，快速了解X API v1.1 data 格式与X API v2 格式之间的差异。 标准 v1.1 data 格式（也称为原生格式）是standard v1.1 端点提供的主要格式。 如果你使用的是高级版产品，请参阅原生增强版指南。Enterprise 客户可能会根据在 Gnip 控制台中的配置，使用原生增强版或活动流。 

​
标准版 v1.1 与 v2 载荷结构

下表展示了与 v1.1 相比，您可在 v2 中预期接收到的高层对象与格式。
v1.1 结构v2 结构
默认{
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”
}]
}
使用已定义的 fields 和 expansions 参数{
“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”: []
}
字段映射 以下部分说明哪些 v1.1 字段映射到 v2 字段，以及需要哪些 v2 参数才能返回这些新字段。  

​
Tweet 对象

Twitter 1.1 格式Twitter v2 格式v2 所需参数
created_atdata.created_attweet.fields=created_at
id不适用：id 为字符串
id_strdata.id默认
textdata.text默认
full_text不适用：text 已包含完整文本
truncated不适用：text 已包含完整文本
display_text_range不适用：text 已包含完整文本
edit_historydata.edit_history_tweet_ids默认
edit_controlsdata.edit_controlstweet.fields=edit_controls
editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controls
entitiesdata.entitiestweet.fields=entities
entities.user_mentionsdata.entities.mentionstweet.fields=entities
entities.symbolsdata.entities.cashtagstweet.fields=entities
entities.hashtagsdata.entities.hashtagstweet.fields=entities
entities.urlsdata.entities.urlstweet.fields=entities
entities.mediaincludes.mediaexpansions=attachments.media_keys
extended_entitiesdata.attachmentstweet_fields=attachments
in_reply_to_status_id不适用：referenced_tweets.id 为字符串
in_reply_to_status_id_strdata.referenced_tweets.id (if type=replied_to)expansions=referenced_tweets.id
in_reply_to_user_id不适用：in_reply_to_user_id 为字符串
in_reply_to_user_id_strdata.in_reply_to_user_idtweet.fields=in_reply_to_user_id
in_reply_to_screen_nameincludes.users..usernametweet.fields=in_reply_to_user_id&expansions=entities.mentions.username
userincludes.usersexpansions=author_id
geodata.geo.place_idtweet.fields=geo
coordinatesdata.geo.place_idexpansions=geo.place_id
placedata.geo.place_idexpansions=geo.place_id
retweeted_statusdata.referenced_tweets.id (if type=retweeted)expansions=referenced_tweets.id
is_quoted_status不可用
quoted_status_id不适用：referenced_tweets.id 为字符串
quoted_status_id_strdata.referenced_tweets.id (if type=quoted)expansions=referenced_tweets.id
quoted_status_permalink不可用
quoted_statusdata.referenced_tweets (if type=quoted)expansions=referenced_tweets.id
retweet_countdata.public_metrics.retweet_counttweet.fields=public_metrics
favorite_countdata.public_metrics.like_counttweet.fields=public_metrics
favorited不可用
retweeted不可用
possibly_sensitivedata.possibly_sensitivetweet.fields=possibly_sensitive
langdata.langtweet.fields=lang
scopes不可用
withhelddata.withheldtweet.fields=withheld
示例
1.1 版中的 Tweet 对象

包含参数的示例 URI：

https://api.x.com/1.1/statuses/lookup.json?id=1359554366051504129&tweet_mode=extended		v2 中的 Tweet 对象与请求

示例 URI（含参数）：

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
{
“已创建_在”：“2021年2月10日 周三 17:26:34 +0000”，
“id”: 1359554366051504129,
“id_字符串（str）”:“1359554366051504129”，
“文本”:“尽管去吧，再关注一个小狗账号吧。我们不会评价你。 \n\n向全新的……介绍“管理关注”端点 https://t.co/3cBZKZUevF”，
“已截断”: true,
“实体”:{
“主题标签”: [],
“符号”: [],
“用户_提到”: [],
“URL”: [{
“URL”:“https://t.co/3cBZKZUevF”，
“已展开_url”：“https://twitter.com/i/web/status/1359554366051504129”，
“显示_URL”:“twitter.com/i/web/status/1…”，
“索引”: [
111，
134
]
}]
}，

“在_回复_至_状态_id”: null,
“于_回复_到_状态_id_字符串（str）”: null,
“在_回复_至_用户_id”: null,
“在_回复_到_用户_id_字符串（str）”: null,
“在_回复_至_屏幕_名称”: null,
“用户”:{
…
}，
“地理”: null,
“坐标”: null,
“位置”: null,
“贡献者”: null,
“为_引文_状态”: false,
“转推_计数”: 18,
“喜爱_计数”: 98,
“已加为最爱”: false,
“已转推”: false,
“可能地_敏感""": false,
“可能地_敏感内容_可上诉”: false,
“语言代码”:“英语”
}		{
“data”：[{
“id”:“1359554366051504129”,
“文本”：“尽管去，再关注一个小狗账号吧。我们不会评判。\n\n全新 #TwitterAPI 推出“管理关注”端点。现在你可以使用 v2 API 来关注或取消关注账号。了解更多https://t.co/mtpd9VIMDa”，
“语言”：“zh”，
“会话_id”：“1359554366051504129”,
“可能_敏感内容”: false,
“回复_设置”：“各位”，
“已创建_于”：“2021-02-10T17:26:34.000Z”，
“作者_id”：“2244994945”，
“公共_度量”:{
“转推_计数”: 18,
“回复_计数器”: 11,
“点赞_计数”: 98,
“引文_计数”: 7
},
“实体”：{
“标签”: [{
“开始”: 110,
“结束”: 121,
“标签”：“Twitter API”
}],
“URL”: [{
“开始”: 194,
“结束”: 217,
“URL”：“https://t.co/mtpd9VIMDa”，
“已扩展_url”:“https://devcommunity.x.com/t/introducing-the-new-manage-follows-endpoints-to-the-twitter-api-v2/149465”，
“显示_URL”：“devcommunity.com/t/introducing-…”，
“图像”: [{
“URL”:“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=orig”，
“宽度”: 1200,
“高度”：630
}，
{
“URL”：“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=150x150”，
“宽度”: 150,
“高度”：150
}
],
“状态”: 200,
“标题”:“全新“管理关注”端点现已加入 X API v2”，
“说明”：“关注，还是不关注？现在你可以使用 X API v2 按你的方式自由作答。今天，我们很高兴宣布全新的“管理关注”端点已在新的 Twitter API 中发布。正如我们在一个多月前推出“关注查询”端点时所预告的那样，管理关注关系的能力终于上线。这些端点是我们 v1.1 API 中最受欢迎的之一，因此我们很高兴在 X API v2 上解锁更广泛的用例。W…”，
“已展开_URL”：“https://devcommunity.x.com/t/推出全新“管理关注”端点：Twitter API v2/149465”
}]
}，
“上下文_标注”: [{
“域名”:{
“id”:“46”，
“名称”：“品牌类别”，
“说明”：“品牌垂直领域中的细分类别，用于缩小品牌范围”
}，
“实体”：{
“id”：“781974596752842752”，
“名称”：“服务”
}
}，
{
“域名”：{
“id”:“47”，
“名称”:“品牌”，
“说明”：“品牌与企业”
}，
“实体”:{
“id”:“10045225402”，
“名称”：“X（原 Twitter）”
}
}
]
}]
}

​
用户对象

Twitter 1.1 格式Twitter v2 格式所需 v2 参数
user_iddata.author_idtweet.fields=author_id
user.id不适用，使用 includes.users.id
user.id_strincludes.users.idexpansions=author_id
user.nameincludes.users.nameexpansions=author_id
user.screen_nameincludes.users.usernameexpansions=author_id
user.locationincludes.users.locationexpansions=author_id&user.fields=location
user.descriptionincludes.users.descriptionexpansions=author_id&user.fields=description
user.urlincludes.users.urlexpansions=author_id&user.fields=entities
user.entitiesincludes.users.entities
user.entities.url.urls.urlincludes.users.entities.url.urls.url
user.entities.url.urls.expanded_urlincludes.users.entities.url.urls.expanded_urlexpansions=author_id&user.fields=entities
user.entities.url.urls.display_urlincludes.users.entities.url.urls.display_urlexpansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[0]includes.users.entities.url.urls.startexpansions=author_id&user.fields=entities
user.entities.url.urls.display_url.indicies[1]includes.users.entities.url.urls.endexpansions=author_id&user.fields=entities
user.protectedincludes.users.protectedexpansions=author_id&user.fields=protected
user.followers_countincludes.users.public_metrics.followers_countexpansions=author_id&user.fields=public_metrics
user.friends_countincludes.users.public_metrics.following_countexpansions=author_id&user.fields=public_metrics
user.listed_countincludes.users.public_metrics.listed_countexpansions=author_id&user.fields=public_metrics
user.created_atincludes.users.created_atexpansions=author_id&user.fields=created_at
user.favourites_count
user.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verified
user.statuses_countincludes.users.public_metrics.tweet_countexpansions=author_id&user.fields=public_metrics
user.profile_image_url_httpsincludes.users.profile_image_urlexpansions=author_id&user.fields=profile_image_url
示例
1.1 版中的 User 对象v2 中的用户对象与请求
”用户”:{
“id”: 2244994945,
“id_字符串”:“2244994945”，
“名称”：“Twitter 开发者”，
“屏幕_名称”:“TwitterDev”，
“位置”：“127.0.0.1”，
“描述”:“#TwitterDev 团队的发声窗口，也是你获取 #TwitterAPI 相关更新、新闻和活动信息的官方渠道。”，
“url”:“https://t.co/3ZX3TNiZCY”，
“实体”：{
“URL”：{
“URL”: [{
“url”:“https://t.co/3ZX3TNiZCY”，
“已扩展_URL”:“https://developer.x.com/en/community”，
“显示_url”:“developer.x.com/community”，
“索引”: [
0，
23
]
}]
}，
“说明”:{
“URL”: []
}
}，
“受保护”: false,
“粉丝_计数”: 517232,
“好友_计数”: 2032,
“已列出_计数器”: 1722,
“已创建_于”：“周六 2013年12月14日 04:35:55 +0000”，
“收藏夹_计数”: 2134,
“UTC_偏移”: null,
“时间_区”: null,
“地理位置_已启用”: true,
“已认证”: true,
“状态_计数”: 3677,
“语言”: null,
“贡献者_已启用”: false,
“为_翻译”: false,
“为_译文_已启用”: false,
“个人资料_背景_颜色”:“FFFFFF”，
“个人资料_背景_图片_url”:“http://abs.twimg.com/images/themes/theme1/bg.png”，
“个人简介_背景_图片_URL_https”:“https://abs.twimg.com/images/themes/theme1/bg.png”，
“个人资料_背景_磁贴”: false,
“个人资料_图像_URL”:“http://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”，
“资料_图像_URL_https”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”，
“个人资料_横幅标语_URL”：“https://pbs.twimg.com/profile_banners/2244994945/1611792896”，
“个人资料_链接_颜色”：“0084B4”，
“个人资料_侧栏_边框_颜色”:“FFFFFF”，
“个人资料_侧边栏_填充_颜色”：“DDEEF6”，
“个人资料_文本_颜色”：“333333”，
“个人资料_使用_背景_图片”: false,
“具有_延长_个人资料”: true,
“默认值_个人资料”: false,
“默认值_个人资料_图像”: false,
“关注中”: null,
“关注_请求_已发送”: null,
“通知”: null,
“翻译_类型”：“常规”
}		{
“data”: [{
“作者_id”：“2244994945”，
“id”:“1362876655061073928”，
“文本”:“从我们的客厅到您的客厅 🐱‍💻🛋️我们的开发者倡导团队为您准备了精彩的 Twitch 直播和线上活动,帮助您快速上手全新的 #TwitterAPI。查看活动日程了解详情,欢迎告诉我们您还想看到哪些内容!\n👇\nhttps://t.co/cixDY9qkvH”
}],
“includes”:{
“用户”: [{
“公共_度量指标”:{
“粉丝_计数值”: 517233,
“正在关注_计数值”: 2034,
“Tweet_计数”: 3677,
“已列出_计数”: 1727
}，
“用户名”：“TwitterDev”，
“实体”:{
“URL”：{
“URL”: [{
“开始”: 0,
“结束”: 23,
“URL”:“https://t.co/3ZX3TNiZCY”，
“展开_url”:“https://developer.x.com/en/community”，
“显示_url”:“developer.x.com/zh-cn/community”
}]
}，
“说明”:{
“主题标签”: [{
“开始”: 17,
“结束”: 28,
“标记”:“TwitterDev”
}，
{
“开始”: 105,
“结束”: 116,
“标签”:“Twitter API”
}
]
}
}，
“说明”:“#TwitterDev 团队的官方发声渠道，也是你获取 #TwitterAPI 相关更新、新闻和活动信息的官方来源。”，
“名称”:“Twitter 开发者”，
“已认证”: true,
“位置”:“127.0.0.1”，
“id”：“2244994945”，
“受保护”: false,
“URL”：“https://t.co/3ZX3TNiZCY”，
“个人资料_图像_url”：“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”，
“已创建_于”：“2013-12-14T04:35:55.000Z”
}]
}
}

​
Entities 与 Expanded Entities 对象

Twitter 1.1 格式Twitter v2 格式v2 必需参数v2 中的类型
entitiesdata.entitiestweet.fields=entitiesobject
entities.hashtagsdata.entities.hashtagstweet.fields=entitiesarray of objects
entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entitiesnumber
entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entitiesnumber
entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entitiesstring
entities.urlsdata.entities.urlstweet.fields=entitiesarray of objects
entities.urls.indices[0]data.entities.urls.starttweet.fields=entitiesnumber
entities.urls.indices[1]data.entities.urls.endtweet.fields=entitiesnumber
entities.urls.urldata.entities.urls.urltweet.fields=entitiesstring
entities.user_mentionsdata.entities.mentionstweet.fields=entitiesarray of objects
entities.user_mentions.indicies[0]data.entities.mentions.starttweet.fields=entitiesnumber
entities.user_mentions.indicies[1]data.entities.mentions.endtweet.fields=entitiesnumber
entities.user_mentions.screen_namedata.entities.mentions.usernametweet.fields=entitiesstring
entities.symbolsdata.entities.cashtagstweet.fields=entitiesarray of objects
entities.symbols.indices[0]data.entities.cashtags.starttweet.fields=entitiesnumber
entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entitiesnumber
entities.symbols.textdata.entities.cashtags.tagtweet.fields=entitiesstring
entities.mediaincludes.mediaexpansions=attachments.media_keysarray of objects
entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysstring
entities.media.typeincludes.media.media.typeexpansions=attachments.media_keysstring
entities.media.media_url不适用，请使用 includes.media.urlstring
entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_keys&media.fields=urlstring
entities.media.url
entities.media.display_url
entities.media.expanded_url
entities.media.media_url_httpsincludes.media.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlstring
extended_entitiesdata.attachmentstweet_fields=attachmentsobject
extended_entitiesdata.attachments.media_keystweet.fields=attachmentsarray of objects
extended_entities.mediaincludes.mediaexpansions=attachments.media_keysarray of objects
extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysstring
extended_entities.media.typeincludes.media.media.typeexpansions=attachments.media_keysstring
extended_entities.media.sizes.thumb.w不可用
extended_entities.media.sizes.thumb.h不可用
extended_entities.media.sizes.thumb.resize不可用
extended_entities.media.sizes.large.wincludes.media.heightexpansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.hincludes.media.widthexpansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize不可用
extended_entities.media.sizes.small.w不可用
extended_entities.media.sizes.small.h不可用
extended_entities.media.sizes.small.resize不可用
extended_entities.media.sizes.medium.w不可用
extended_entities.media.sizes.medium.h不可用
extended_entities.media.sizes.medium.resize不可用
extended_entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_keys&media.fields=urlstring
extended_entities.media.media_url_httpsincludes.media.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlstring
extended_entities.media.video_info.duration_millisincludes.media.duration_msexpansions=attachments.media_keys&media.fields=duration_msnumber
示例
v1.1 中的 entities 和 extended_entities（含视频）v2 中的实体、附件和 includes

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
”实体”：{
“标签”: [{
“文本”：“测试”,
“索引”: [
8,
13
]
}],
“符号”: [],
“用户_提及”: [{
“屏幕_名称”:“TwitterDev”,
“名称”:“X 开发者”，
“id”: 2244994945,
“id_str”：“2244994945”,
“索引”: [
31，
42
]
}],
“URL”: [{
“URL”：“https://t.co/XVLZ3uwikc”,
“展开_url”：“https://developer.x.com/en”，
“显示_URL”:“developer.x.com/en”，
“索引”: [
91，
114
]
}],
“媒体”: [{
“id”: 1370161464028196868,
“id_字符串”：“1370161464028196868”，
“索引”: [
115，
138
],
“媒体_URL”：“http://pbs.twimg.com/ext_tw_视频_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”，
“媒体_url_https”:“https://pbs.twimg.com/ext_台灣_视频_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”，
“url”:“https://t.co/dz4oByygWA”，
“显示_URL”：“pic.x.com/dz4oByygWA”，
“展开_URL”：“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”，
“类型”:“照片”，
“大小”：{
“拇指”：{
“w”: 150,
“h”: 150,
“调整”：“裁切”
}，
“小号”:{
“w”: 383,
“h”: 680,
“调整尺寸”：“适合”
},
“大”:{
“w”: 720,
“h”: 1280,
“调整尺寸”:“适配”
}，
“中等”：{
“w”: 675,
“h”: 1200,
“调整”:“适合”
}
}
}]
}，
“延长_实体”：{
“媒体”: [{
“id”: 1370161464028196868,
“id_字符串（str）”：“1370161464028196868”，
“索引”: [
115，
138
],
“媒体_URL”:“http://pbs.twimg.com/ext_tw_视频_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”,
“媒体_url_https”:“https://pbs.twimg.com/ext_台湾_视频_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”，
“url”:“https://t.co/dz4oByygWA”，
“显示_URL”:“pic.x.com/dz4oByygWA”,
“扩展_url”:“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”，
“类型”：“视频”，
“大小”：{
“缩略图”：{
“w”: 150,
“h”: 150,
“调整大小”:“裁剪”
}，
“小型”:{
“w”: 383,
“h”: 680,
“调整尺寸”：“适合”
},
“大型”:{
“w”: 720,
“h”: 1280,
“调整大小”：“适合”
}，
“中等”:{
“w""": 675,
“h”: 1200,
“调整大小”:“适合”
}
},
“视频_信息”:{
“方面_比值”: [
9,
16
],
“时长_毫秒”: 5140,
“变量版本”: [{
“比特率”: 950000,
“内容_类型”：“video/mp4”，
“URL”：“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12”
}，
{
“比特率”: 2176000,
“内容_类型”:“video/mp4”，
“URL”：“https://video.twimg.com/ext_台湾_video/1370161464028196868/pu/vid/720x1280/ZxVL5qYO-DNVuSyq.mp4?tag=12”
}，
{
“内容_类型”：“application/x-mpegURL”,
“URL”:“https://video.twimg.com/ext_台灣_video/1370161464028196868/pu/pl/EGVpuZpo-wYxTNCq.m3u8?tag=12”
},
{
“比特率”: 632000,
“内容_类型”:“video/mp4”,
“URL”：“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12”
}
]
}，
“附加_媒体_信息”:{
“可获利”: false
}
}]
}		{
“data”: [{
“实体”：{
“主题标签”: [{
“开始”: 8,
“结束”: 13,
“标签”：“测试”
}],
“提及”: [{
“开始”: 31,
“结束”: 42,
“用户名”:“TwitterDev”
}],
“URL”: [{
“开始”: 91,
“结束”: 114,
“URL”:“https://t.co/XVLZ3uwikc”，
“展开_url”:“https://developer.x.com/en”，
“显示_URL”:“developer.x.com/en”，
“状态”: 200,
“标题”:“使用场景、教程，&文档”,
“说明”:“发布&分析 Tweet，优化广告，&使用 X API、X Ads API，打造独特的客户体验，&Twitter for Websites。让’开始动手构建吧。”，
“松开_URL”:“https://developer.x.com/en”
}，
{
“开始”: 115,
“结束”: 138,
“URL”:“https://t.co/dz4oByygWA”，
“已扩展_url”:“https://x.com/furiouscamper/status/1370161532013735937/video/1”，
“显示_URL”：“pic.x.com/dz4oByygWA”
}
]
}，
“id”:“1370161532013735937”，
“文本内容”：“又来一次 #test，这次带视频并提到了 @TwitterDev。对新的格式迁移文档感到很期待！https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”,
“附件”：{
“媒体_密钥”: [
“7_1370161464028196868”
]
}
}],
“includes（扩展的相关资源）”:{
“媒体”: [{
“类型”:“视频”,
“高度”: 1280,
“公共_度量”:{
“视图_计数”: 37
}，
“宽度”: 720,
“媒体_密钥”:“7_1370161464028196868”，
“时长_毫秒（ms）”: 5140,
“预览_图片_URL”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”
}],
“用户”: [{
“公共_度量”:{
“粉丝_计数”: 517233,
“关注_计数”: 2034,
“Tweet_计数”: 3677,
“已列出_计数”：1727
}，
“已创建_于”:“2013-12-14T04:35:55.000Z”，
“个人资料_图片_URL”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”，
“说明”：“#TwitterDev 团队的官方发声渠道，也是你获取 #TwitterAPI 相关更新、新闻与活动信息的权威来源。”，
“已认证”: true,
“id”:“2244994945”，
“用户名”：“TwitterDev”,
“受保护”: false,
“实体”:{
“url”：{
“URL”: [{
“开始”: 0,
“结束”: 23,
“url”:“https://t.co/3ZX3TNiZCY”，
“已展开_URL”:“https://developer.x.com/en/community”，
“显示_URL”:“developer.x.com/zh-cn/community”
}]
}，
“说明”:{
“主题标签”:[{
“开始”: 17,
“结束”: 28,
“标签”:“TwitterDev”
}，
{
“开始”: 105,
“结束”: 116,
“标签”:“TwitterAPI”
}
]
}
},
“url”:“https://t.co/3ZX3TNiZCY”,
“名称”：“Twitter 开发者”，
“位置”:“127.0.0.1”
}]
}
}

​
Place 对象

Twitter 1.1 格式Twitter v2 格式所需 v2 参数
placedata.geo.place_idtweet.fields=geo
place.idincludes.places.idexpansions=geo.place_id
place.id.place_typeincludes.places.place_typeexpansions=geo.place_id&place.fields=place_type
place.id.nameincludes.places.nameexpansions=geo.place_id&place.fields=name
place.id.full_nameincludes.places.full_nameexpansions=geo.place_id
place.id.country_codeincludes.places.country_codeexpansions=geo.place_id&place.fields=country_code
place.id.countryincludes.places.countryexpansions=geo.place_id&place.fields=country
place.id.contained_withinincludes.places.contained_withinexpansions=geo.place_id&place.fields=contained_within
place.id.bounding_box.typeincludes.places.geo.typeexpansions=geo.place_id&place.fields=place_type
place.id.bounding_box.coordinatesincludes.places.geo.bboxexpansions=geo.place_id&place.fields=geo
place.id.attributesincludes.places.propertiesexpansions=geo.place_id&place.fields=geo
示例
v1.1 中的 Place 对象v2 中的 Place 对象

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”
}]
}
后续步骤

​
从 Native Enriched 数据格式迁移到 v2

Native Enriched 数据格式用于我们的企业版产品。 我们已更新 Native Enriched 数据格式，以提供已编辑 Tweet 的元数据。要深入了解 Edit Tweet 元数据，请参阅Edit Tweets 基础页面。 如果你使用的是标准 v1.1 端点，请参考标准 v1.1 到 v2 指南。如果你使用的是包含 Activity Streams 的企业版产品，我们也提供了Activity Streams 到 v2迁移指南。 X API v2 为 Tweet 和 user 对象引入了新的 JSON 设计。
  • 在 JSON 根级别，Native Enriched 格式在 results 数组中返回 Tweet 对象，而 X API v2 在 data 数组中返回对象。
  • X API v2 不再分别在 Tweet 对象中使用 favorites、在 user 对象中使用 favourites，而是统一采用术语 like。
  • X 采用的约定是：没有值的 JSON 字段（例如 null）不写入载荷。仅当 Tweet 和 user 属性为非空时才会包含。
  • v2 中的所有 id 字段均为字符串格式  
除新的 JSON 格式变更外，我们还在 Tweet 对象中引入了一组新字段，包括：
  • conversation_id
  • reply_settings
  • 媒体上的 alt_text
  • 两个新的annotations字段：context 和 entities
  • 多个新的metrics字段
  • 多个新的polls字段  
许多旧版和已弃用字段将被移除：
  • contributors
  • 某些 entities.media 和 extended_entities.media 字段
  • filter_level
  • timestamp_ms
  • truncated

​
Native Enriched 与 v2 负载结构对比

下表展示了与 Native Enriched 格式相比，您可从 v2 接收到的高层级对象及其格式。
Native Enriched 结构v2 结构
默认{
tweet object fields,

“user”: ,
“place”: ,
“entities”: {
“hashtags”: [],
“urls”: [],
“user_mentions”: [],
“symbols”: [],
“annotations”: [],
“media”: []
},
“extended_entities”: ,
“matching_rules”: []
}		{
“data”: [{
“id”,
“text”,

“edit_history_tweet_ids”
}]
}
使用已定义的 fields 和 expansions 参数{
“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”: []
}
字段映射 以下部分说明了哪些 Native Enriched 字段映射到 v2 字段，以及为接收这些新字段需要哪些 v2 参数。  

​
Tweet 对象

原生 Enriched 格式X v2 格式必填的 v2 参数v2 中的类型
已创建_在data.created_在tweet.fields=created_在字符串
id不适用 - 请参见 id
id_字符串（str）data.id默认值字符串
文本data.text默认值字符串（String）
编辑_历史记录data.edit_历史记录_Tweet_ids默认值数组
编辑_控件data.edit_控制项tweet.fields=edit_控制项对象
可编辑的data.edit_controls.is_编辑_符合条件tweet.fields=edit_控件布尔
显示_文本_范围不适用 - 文本包含完整内容
来源data.sourcetweet.fields=source字符串
已截断不适用 - 文本包含完整内容
暂无可用内容data.conversation_idtweet.fields=conversation_id_id字符串
不可用data.reply_设置tweet.fields=reply_设置字符串
在_回复_至_状态_id不适用 - 参见引用内容_tweets.id
在_回复_至_状态_id_strdata.referenced_tweets.id（如果 type=replied）_至)expansions=referenced_tweets.id字符串
于_回复_至_用户_id不适用 - 参见_回复_至_用户_id_str
在_回复_至_用户_id_strdata.in_回复_至_用户_idtweet.fields=in_回复_至_用户_id字符串
在_回复_至_屏幕_名称includes.users..usernametweet.fields=in_回复_至_用户_id&expansions=entities.mentions.username字符串
用户includes.usersexpansions=author_id对象
user.id_strdata.author_idtweet.fields=author_id_id字符串
地理位置data.geo.place_idtweet.fields=geo
坐标data.geo.place_idtweet.fields=geo
位置data.geo.place_idtweet.fields=geo
是_已引用_状态data.referenced_tweets.id（如果 type=quoted）tweet.fields=referenced_Tweet字符串
扩展版_tweet.full_文本不适用 — 文本已完整
不可用data.public_度量tweet.fields=public_指标对象
引文_计数data.public_metrics.quote_计数tweet.fields=public_度量Int
回复_计数值data.public_metrics.reply_计数tweet.fields=public_指标Int
转推_计数data.public_metrics.retweet_计数tweet.fields=public_度量Int（整型）
收藏_计数data.public_metrics.like_计数tweet.fields=public_度量Int（整数）
不可用data.non_公共_度量tweet.fields=none_公共_度量指标对象
不可用data.non_公共_metrics.impression（曝光）_计数tweet.fields=non_公共_度量指标Int
不可用data.non_公共_metrics.url_链接_计数值tweet.fields=none_公共_度量整数
不可用data.non_公共_metrics.user_个人资料_计数tweet.fields=none_公共_度量Int（整数）
不可用data.organic_度量tweet.fields=organic_度量对象
不可用data.organic_metrics.like_计数tweet.fields=organic_度量指标Int（整型）
不可用data.organic_metrics.retweet_计数值tweet.fields=organic_度量Int
不可用data.organic_metrics.reply_计数tweet.fields=organic_度量Int
不可用data.organic_metrics.impression（曝光）_计数tweet.fields=organic_度量Int（整型）
不可用data.organic_metrics.url_链接_计数tweet.fields=organic_度量Int
不可用data.organic_metrics.user_资料_计数tweet.fields=organic_度量整数
不可用data.promoted_指标tweet.fields=promoted_度量对象
不可用data.promoted_metrics.like_计数tweet.fields=promoted_度量整数
不可用data.promoted_metrics.retweet_计数tweet.fields=promoted_度量Int（整型）
不可用data.promoted_metrics.reply_计数值tweet.fields=promoted_度量指标整数
不可用data.promoted_metrics.impression（曝光）_计数tweet.fields=promoted_指标Int
不可用data.promoted_metrics.url_链接_计数tweet.fields=promoted_度量指标Int
不可用data.promoted_metrics.user_个人资料_计数tweet.fields=promoted_度量指标Int
贡献者不可用不可用
实体data.entitiestweet.fields=entities对象
entities.user_提及data.entities.mentionstweet.fields=entities对象数组
entities.symbolsdata.entities.cashtagstweet.fields=entities对象的数组
entities.hashtagsdata.entities.hashtagstweet.fields=entities对象数组
entities.urlsdata.entities.urlstweet.fields=entities对象组成的数组
entities.mediaincludes.mediaexpansions=attachments.media_密钥对象数组
entities.annotationstweet.fields=entities,context_标注对象
entities.annotations.contextdata.context_标注tweet.fields=entities,context_标注对象数组
无对应data.context_annotations.domaintweet.fields=context_标注对象
entities.annotations.context.context_域名_id_strdata.context_annotations.domain.idtweet.fields=context_标注字符串
entities.annotations.context.context_域名_id不可用不可用 - 请参见 data.context_有关字符串格式，请参见 annotations.domain.id
entities.annotations.context.context_域名_名称data.context_annotations.domain.nametweet.fields=context_标注字符串
entities.annotations.context.context_域名_说明data.context_annotations.domain.descriptiontweet.fields=context_标注字符串
无对应data.context_annotations.entitytweet.fields=context_标注对象
entities.annotations.context.context_实体_id_字符串（str）data.context_annotations.entity.idtweet.fields=context_标注字符串
entities.annotations.context.context_实体_id不可用不可用 — 请查看 data.context_字符串格式的 annotations.entity.id
entities.annotations.context.context_实体_名称data.context_annotations.entity.nametweet.fields=context_标注字符串
entities.annotations.context.context_实体_说明data.context_annotations.entity.descriptiontweet.fields=context_标注字符串
entities.annotations.entitydata.entities.annotationstweet.fields=entities,context_标注对象的数组
延长_实体data.attachmentsTweet_fields=attachments对象
已收藏不可用不可用
已转推不可用不可用
已转发帖子_状态
可能地_敏感data.possibly_敏感tweet.fields=possibly_敏感布尔
langdata.langtweet.fields=lang字符串
筛选器_层级不可用不可用
权限范围不可用不可用
时间戳_毫秒（ms）不可用不可用
被扣留data.withheldtweet.fields=withheld对象的数组
匹配_规则匹配_规则对象的数组
匹配_rules.id暂无可用暂无可用
匹配_rules.id_str匹配_rules.id使用过滤后的流的默认设置字符串
匹配_rules.tag匹配_rules.tag默认（使用过滤后的流）字符串

​
User 对象

原生 Enriched 格式Twitter v2 格式必填的 v2 参数v2 中的类型
用户includes.usersexpansions=author_id对象数组
user.id暂无可用内容不适用 — 参见 includes.users.id字符串
user.id_字符串（str）includes.users.idexpansions=author_id字符串
user.nameincludes.users.nameexpansions=author_id字符串
user.screen_名称includes.user.usernameexpansions=author_id字符串
user.locationincludes.users.locationexpansions=author_id&user.fields=location对象
user.descriptionincludes.users.descriptionexpansions=author_id&user.fields=description字符串
不可用includes.users.urlexpansions=author_id&user.fields=url字符串
user.followers_计数器includes.users.public_metrics.followers_计数expansions=author_id&user.fields=public_度量Int（整型）
user.friends_计数includes.users.public_metrics.following_计数expansions=author_id&user.fields=public_度量整数
user.listed_计数includes.users.public_指标.listed_计数expansions=author_id&user.fields=public_指标整数
user.created_在includes.users.created_在expansions=author_id&user.fields=created_在字符串
user.favorites_计数尚未提供
user.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verified布尔
不可用includes.users.pinned_Tweet_idexpansions=author_id&user.fields=pinned_Tweet_id字符串
user.statuses_计数includes.users.public_metrics.tweet_计数expansions=author_id&user.fields=public_度量整数
user.profile_图片_url_httpsincludes.users.profile_图像_urlexpansions=author_id&user.fields=profile_图像_URL字符串
用户.翻译器_类型不可用不可用
user.utc_偏移不可用不可用
user.time_区域不可用不可用
user.geo_已启用不可用暂无可用内容
user.lang不可用不可用 — 可从 Tweet 的语言推断
user.contributors_已启用不可用不可用
user.is_翻译器不可用不可用
user.profile_背景_颜色不可用不可用
user.profile_背景_图片_URL不可用不可用
user.profile_背景信息_图片_url_https不可用不可用
user.profile_背景_标题不可用不可用
user.profile_侧边栏_边框_颜色不可用不可用
user.profile_侧栏_填充_颜色不可用不可用
user.profile_文本_颜色不可用暂无可用
user.profile_用户_背景_图像不可用不可用
user.profile_图像_URL请参阅 includes.user.profile_图像_URL
user.default_个人资料不可用不可用
user.default_个人资料_图像不可用不可用
user.following不可用不可用
user.follow_请求_已发送不可用暂无可用
user.notifications不可用不可用
user.withheld_于_国家includes.users.withheldexpansions=author_id&user.fields=withheld对象
user.protectedincludes.users.protectedexpansions=author_id&user.fields=protected布尔
暂无可用includes.users.entitiesexpansions=author_id&user.fields=entities对象
不可用includes.users.entities.urlexpansions=author_id&user.fields=entities对象
不可用includes.users.entities.url.urlsexpansions=author_id&user.fields=entities对象的数组
不可用includes.users.entities.url.urls.startexpansions=author_id&user.fields=entitiesInt
不可用includes.users.entities.url.urls.endexpansions=author_id&user.fields=entitiesInt（整型）
不可用includes.users.entities.url.urls.urlexpansions=author_id&user.fields=entities字符串
user.urlincludes.users.entities.url.urls.expanded_urlexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.url.urls.display_urlexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.descriptionsexpansions=author_id&user.fields=entities对象
不可用includes.users.entities.descriptions.hashtagsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.descriptions.hashtags.startexpansions=author_id&user.fields=entitiesInt（整数）
不可用includes.users.entities.descriptions.hashtags.endexpansions=author_id&user.fields=entitiesInt（整数）
包含在 user.description 中includes.users.entities.descriptions.hashtags.tagexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.descriptions.mentionsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.descriptions.mentions.startexpansions=author_id&user.fields=entitiesInt（整型）
不可用includes.users.entities.descriptions.mentions.endexpansions=author_id&user.fields=entitiesInt（整数）
包含在 user.description 中includes.users.entities.descriptions.mentions.usernameexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.descriptions.cashtagsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.descriptions.cashtags.startexpansions=author_id&user.fields=entitiesInt（整数）
暂无可用includes.users.entities.descriptions.cashtags.endexpansions=author_id&user.fields=entitiesInt（整型）
包含在 user.description 中includes.users.entities.descriptions.cashtags.tagexpansions=author_id&user.fields=entities字符串

​
entities 与 expanded_entities 对象

原生 Enriched 格式Twitter v2 格式必填的 v2 参数v2 中的类型
实体data.entitiestweet.fields=entities对象
entities.hashtagsdata.entities.hashtagstweet.fields=entities对象数组
entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entities整数
entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entities整数
entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entities字符串
entities.urlsdata.entities.urlstweet.fields=entities对象的数组
entities.urls.indices[0]data.entities.urls.starttweet.fields=entities整数
entities.urls.indices[1]data.entities.urls.endtweet.fields=entities整数
entities.urls.urldata.entities.urls.urltweet.fields=entities字符串
entities.urls.expanded_URLdata.entities.urls.expanded_urltweet.fields=entities字符串
entities.urls.display_urldata.entities.urls.display_URLtweet.fields=entities字符串
entities.urls.unwound.urldata.entities.urls.unwound_URLtweet.fields=entities字符串
entities.urls.unwound.statusdata.entities.urls.statustweet.fields=entities字符串
entities.urls.unwound.titledata.entities.urls.titletweet.fields=entities字符串
entities.urls.unwound.descriptiondata.entities.urls.descriptiontweet.fields=entities字符串（String）
不可用data.entities.urls.imagestweet.fields=entities对象数组
不可用data.entities.urls.images.urltweet.fields=entities字符串
暂无可用data.entities.urls.images.widthtweet.fields=entitiesInt
不可用data.entities.urls.images.heighttweet.fields=entitiesInt（整型）
entities.user_提到data.entities.mentionstweet.fields=entities对象的数组
entities.user_mentions.indices[0]data.entities.mentions.starttweet.fields=entities整数
entities.user_mentions.indices[1]data.entities.mentions.endtweet.fields=entities整数
entities.user_mentions.screen_名称data.entities.mentions.usernametweet.fields=entities字符串
entities.symbolsdata.entities.cashtagstweet.fields=entities对象的数组
entities.symbols.indices[0]data.entities.cashtags.starttweet.fields=entities整数
entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entities整数
entities.symbols.textdata.entities.cashtags.tagtweet.fields=entities字符串
entities.media 或 extended_entities.mediaincludes.mediaexpansions=attachments.media_密钥对象数组
entities.media.id_str 或 extended_entities.media.id_strincludes.media.media_密钥expansions=attachments.media_密钥字符串
entities.media.id 或 extended_entities.media.id不可用 - id 为字符串类型
entities.media.type 或 extended_entities.media.typeincludes.media.media.typeexpansions=attachments.media_密钥字符串
entities.media.indices 或 extended_entities.media.indices暂无可用不可用
暂无可用includes.media.alt_文本expansions=attachments.media_密钥&media.fields=alt_文本字符串
entities.media.additional_媒体_info 或 extended_entities.media.additional_媒体_信息不可用不可用
entities.media.additional_媒体_info.monetizable OR extended_entities.media.additional_媒体_info.monetizable暂无可用不可用
entities.media.media_url 或 extended_entities.media.media_url不适用 - 请参见 includes.media.url字符串
entities.media.media_url_https 或 extended_entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_密钥&media.fields=url字符串
entities.media.url 或 extended_entities.media.url
entities.media.display_url 或 extended_entities.media.expanded_URL
entities.media.expanded_URL
entities.media.media_url_httpsincludes.media.preview_图片_URLexpansions=attachments.media_密钥&media.fields=preview_图片_URL字符串
扩展版_实体data.attachmentsTweet_fields=attachments对象
延长_实体data.attachments.media_密钥tweet.fields=attachments对象的数组
不可用data.attachments.poll_idstweet.fields=attachments对象数组
扩展版_entities.media.sizes.thumb.w不可用
扩展版_entities.media.sizes.thumb.h不可用
扩展版_entities.media.sizes.thumb.resize不可用
延长_entities.media.sizes.large.wincludes.media.heightexpansions=attachments.media_密钥&media.fields=height
扩展版_entities.media.sizes.large.hincludes.media.widthexpansions=attachments.media_密钥&media.fields=width
延展_entities.media.sizes.large.resize暂无可用不可用
扩展版_entities.media.sizes.small.w暂无可用暂无可用
扩展版_entities.media.sizes.small.h暂无可用不可用
延长_entities.media.sizes.small.resize不可用不可用
延长_entities.media.sizes.medium.w不可用不可用
扩展版_entities.media.sizes.medium.h不可用不可用
扩展版_entities.media.sizes.medium.resize不可用不可用
扩展版_entities.media.media_url_httpsincludes.media.preview_图片_urlexpansions=attachments.media_密钥&media.fields=preview_图片_URL字符串
扩展版_entities.media.video_info.aspect_比例不可用不可用
已扩展_entities.media.variants不可用不可用
扩展_entities.media.variants.bitrate不可用不可用
已扩展_entities.media.variants.content_类型不可用不可用
已扩展_entities.media.variants.url不可用不可用
扩展版_entities.media.video_info.duration_毫秒数includes.media.duration_毫秒（ms）expansions=attachments.media_密钥&media.fields=duration_msInt（整型）
暂无可用includes.media.public_度量expansions=attachments.media_键&media.fields=public_度量对象
不可用includes.media.public_metrics.view_计数值expansions=attachments.media_密钥&media.fields=public_度量Int（整型）
不可用includes.media.non_公共_度量指标expansions=attachments.media_密钥&media.fields=none_公共_度量对象
不可用includes.media.none_公共_metrics.playback_0_计数expansions=attachments.media_密钥&media.fields=none_公共_度量整数
不可用includes.media.non_公共_metrics.playback_25_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int（整数）
不可用includes.media.none_公共_metrics.playback_50_计数值expansions=attachments.media_密钥&media.fields=none_公共_度量Int
不可用includes.media.non_公共_metrics.playback_75_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int（整型）
不可用includes.media.non_公共_metrics.playback（回放）_100_计数expansions=attachments.media_密钥&media.fields=none_public_度量Int（整数）
不可用includes.media.organic_度量expansions=attachments.media_密钥&media.fields=organic_度量对象
不可用includes.media.organic_metrics.playback_0_计数expansions=attachments.media_密钥&media.fields=organic_度量整数
不可用includes.media.organic_metrics.playback_25_计数expansions=attachments.media_密钥&media.fields=organic_指标Int
不可用includes.media.organic_metrics.playback_50_计数expansions=attachments.media_密钥&media.fields=organic_度量整型
不可用includes.media.organic_metrics.playback_75_计数值expansions=attachments.media_密钥&media.fields=organic_指标Int（整数）
不可用includes.media.organic_metrics.playback_100_计数expansions=attachments.media_密钥&media.fields=organic_指标Int（整型）
不可用includes.media.organic_metrics.view_计数expansions=attachments.media_密钥&media.fields=organic_度量整型
不可用includes.media.promoted_度量expansions=attachments.media_密钥&media.fields=promoted_度量对象
不可用includes.media.promoted_metric.playback_0_计数expansions=attachments.media_密钥&media.fields=promoted_指标Int
不可用includes.media.promoted_metric.playback_25_计数expansions=attachments.media_密钥&media.fields=promoted_度量Int（整型）
不可用includes.media.promoted_metric.playback_50_计数expansions=attachments.media_密钥&media.fields=promoted_度量指标Int（整型）
不可用includes.media.promoted_metric.playback_75_计数expansions=attachments.media_密钥&media.fields=promoted_度量Int（整型）
不可用includes.media.promoted_metric.playback_100_计数值expansions=attachments.media_密钥&media.fields=promoted_度量Int（整型）
不可用includes.media.promoted_metrics.view_计数expansions=attachments.media_密钥&media.fields=promoted_度量Int（整数）

​
Place 对象

原生 Enriched 格式Twitter v2 格式必需的 v2 参数v2 中的类型
placeincludes.placesexpansions=geo.place_id对象数组
place.idincludes.places.idexpansions=geo.place_id字符串
place.url不提供不提供
place.id.place_typeincludes.places.place_typeexpansions=geo.place_id&place.fields=place_type字符串
place.id.nameincludes.places.nameexpansions=geo.place_id&place.fields=name字符串
place.id.full_nameincludes.places.full_nameexpansions=geo.place_id字符串
place.id.country_codeincludes.places.country_codeexpansions=geo.place_id&place.fields=country_code字符串
place.id.countryincludes.places.countryexpansions=geo.place_id&place.fields=country字符串
place.id.contained_withinincludes.places.contained_withinexpansions=geo.place_id&place.fields=contained_within数组
place.id.bounding_box.typeincludes.places.geo.typeexpansions=geo.place_id&place.fields=place_type字符串
place.id.bounding_box.coordinatesincludes.places.geo.bboxexpansions=geo.place_id&place.fields=geo数组
place.id.attributesincludes.places.propertiesexpansions=geo.place_id&place.fields=geo对象

​
投票对象

原生增强格式Twitter v2 格式v2 必需参数v2 类型
entities.pollsincludes.pollsexpansions=attachments.poll_ids对象数组
不适用includes.polls.idexpansions=attachments.poll_ids字符串
entities.poll.optionsincludes.polls.optionsexpansions=attachments.poll_ids对象数组
entities.polls.options.positionincludes.polls.options.positionexpansions=attachments.poll_ids整数
entities.polls.options.textincludes.polls.options.labelexpansions=attachments.poll_ids字符串
不适用includes.polls.options.votesexpansions=attachments.poll_ids整数
不适用includes.polls.voting_statusexpansions=attachments.poll_ids&poll.fields=voting_status字符串
entities.polls.duration_minutesincludes.polls.duration_minutesexpansions=attachments.poll_ids&poll.fields=duration_minutes整数
entities.polls.end_datetimeincludes.polls.end_datetimeexpansions=attachments.poll_ids&poll.fields=end_datetime日期（ISO 8601）

​
从 Activity Streams 数据格式迁移到 v2

Activity Streams 数据格式适用于我们的企业版产品。 Activity Streams 数据格式已更新，现可提供已编辑 Tweet 的元数据。要了解 Edit Tweet 元数据的更多信息，请参阅Edit Tweets 基础页面。 如果你使用标准 v1.1 端点，请参阅标准 v1.1 到 v2 指南。如果你使用高级端点，或企业版的 Native Enriched 格式，请参阅Native Enriched 到 v2 指南。 X API v2 为Post和用户对象引入了全新的 JSON 设计。
  • 在 JSON 根级别，Activity Streams 格式在 results 数组中返回 Tweet 对象，而 X API v2 在 data 数组中返回。 
  • X API v2 的 JSON 不再将转发和引用称为“activities”，而是称为 Retweeted 和 Quoted Tweets。 
  • 不再在 Tweet 对象中使用 favorites、在 user 对象中使用 favourites，X API v2 统一使用 like 这一术语。 
  • X 采用的约定是，对于没有值的 JSON 字段（例如 null），不会写入到负载中。仅当 Tweet 和用户属性为非空时才会包含。 
  • v2 中所有 id 字段均为字符串格式。  
除新的 JSON 格式外，我们还为 Tweet 对象引入了一组新的字段，包括：
  • conversation_id
  • reply_settings
  • 媒体上的 alt_text
  • 两个新的注解字段，包括 context 和 entities
  • 多个新的指标字段
  • 多个新的投票字段  
许多传统和已弃用的字段将被移除或替换：
  • display_text_range
  • generator
  • gnip
  • link
  • objectType
  • provider
  • twitter_entities.symbols 替换为 data.entities.cashtags
  • 某些 twitter_extended_entities.media 和 twitter_entities.media 字段
  • twitter_filter_level
  • twitterTimeZone
  • verb

​
Tweet 对象

Activity Streams 格式Twitter v2 格式v2 必填参数v2 中的类型
发布时间data.created_在tweet.fields=created_在日期（ISO 8601）
生成器暂无可用不可用
generator.link不可用不可用
generator.displayNamedata.sourcetweet.fields=source字符串
X（原 Twitter）_语言代码data.langtweet.fields=lang字符串
不可用data.conversation_idtweet.fields=conversation_id字符串
不可用data.reply_设置tweet.fields=reply_设置字符串
不可用data.possibly_敏感tweet.fields=possibly_sensitive_敏感布尔
不可用data.withheldtweet.fields=withheld对象
对象类型不可用不可用
动词不可用不可用
服务提供方不可用不可用
provider.objectType不可用暂无可用
provider.displayName暂无可用不可用
provider.link暂无可用暂不可用
链接不可用不可用
显示_文本_范围不可用不可用
对象不可用不可用
object.objectType暂无可用不可用
object.id不可用不可用
object.summarydata.text默认字符串
object.edit_历史记录data.edit_历史记录_Tweet_ids默认数组
object.edit_控制项data.edit_控件tweet.fields=edit_控件对象
object.editabledata.edit_controls.is_编辑_有资格tweet.fields=edit_控制项布尔
object.link暂无不可用
object.postedTimedata.created_于tweet.fields=created_在日期（ISO 8601）
来自 actor.iddata.author_idtweet.fields=created_在
Twitter_筛选器_层级不可用不可用
源自 inReplyTo.link 中的用户名data.in_回复_至_用户_idtweet.fields=in_回复_至_用户_id字符串
不可用data.referenced_Tweettweet.fields=referenced_Tweet对象数组
不可用data.referenced_tweets.typetweet.fields=referenced_tweets字符串
源自 inReplyTo.linkdata.referenced_tweets.idtweet.fields=referenced_Tweet字符串
不可用data.attachmentstweet.fields=attachments对象
源自 Twitter_entities.media.id_字符串data.attachments.media_密钥tweet.fields=attachments数组
不可用data.attachments.poll_idstweet.fields=attachments数组
Twitter_实体data.entitiestweet.fields=entities对象
不可用data.entities.annotationstweet.fields=entities对象的数组
不可用data.entities.annotations.starttweet.fields=entitiesInt（整型）
不可用data.entities.annotations.endtweet.fields=entitiesInt
不可用data.entities.annotations.probabilitytweet.fields=entities浮点型
不可用data.entities.annotations.typetweet.fields=entities字符串
不可用data.entities.annotations.normalized_文本tweet.fields=entities字符串
Twitter_entities.urlsdata.entities.urlstweet.fields=entities对象的数组
Twitter_entities.urls.indices[0]data.entities.urls.starttweet.fields=entities整型
Twitter_entities.urls.indices[1]data.entities.urls.endtweet.fields=entities整数
X（原名 Twitter）_entities.urls.urldata.entities.urls.urltweet.fields=entities字符串
Twitter_entities.urls.expanded_urldata.entities.urls.expanded_URLtweet.fields=entities字符串
Twitter_entities.urls.display_URLdata.entities.urls.display_URLtweet.fields=entities字符串
不可用data.entities.urls.imagestweet.fields=entities对象数组
暂无可用data.entities.urls.images.urltweet.fields=entities字符串
不可用data.entities.urls.images.widthtweet.fields=entitiesInt（整数）
不可用data.entities.urls.images.heighttweet.fields=entitiesInt（整数）
gnip.urls.expanded_状态data.entities.urls.statustweet.fields=entitiesInt（整型）
gnip.urls.expanded_url_标题data.entities.urls.titletweet.fields=entities字符串
gnip.urls.expanded_url_说明data.entities.urls.descriptiontweet.fields=entities字符串
gnip.urls.expanded_urldata.entities.urls.unwound_URLtweet.fields=entities字符串
Twitter_entities.symbolsdata.entities.cashtagstweet.fields=entities对象数组
Twitter_entities.symbols.indices[0]data.entities.cashtags.starttweet.fields=entities整数
Twitter_entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entitiesInt（整数）
Twitter_entities.symbols.textdata.entities.cashtags.tagtweet.fields=entities字符串
Twitter_entities.hashtagsdata.entities.hashtagstweet.fields=entities对象数组
Twitter_entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entitiesInt
Twitter_entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entitiesInt（整数）
Twitter_entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entities字符串
Twitter_entities.user_提及data.entities.mentionstweet.fields=entities对象的数组
Twitter_entities.user_mentions.indices[0]data.entities.mentions.starttweet.fields=entities整型
Twitter_entities.user_mentions.indices[1]data.entities.mentions.endtweet.fields=entitiesInt
Twitter_entities.user_mentions.screen_名称data.entities.mentions.tagtweet.fields=entities字符串
Twitter_entities.user_mentions.id_字符串（str）data.entities.mentions.idtweet.fields=entities字符串
Twitter_entities.user_mentions.id不可用不可用
不可用data.context_标注tweet.fields=context_标注对象数组
不可用data.context_annotations.domaintweet.fields=context_标注对象
不可用data.context_annotations.domain.idtweet.fields=context_标注字符串
不可用data.context_annotations.domain.nametweet.fields=context_标注字符串
不可用data.context_annotations.domain.descriptiontweet.fields=context_标注字符串
不可用data.context_annotations.entitytweet.fields=context_标注对象
不可用data.context_annotations.entity.idtweet.fields=context_标注字符串
不可用data.context_annotations.entity.nametweet.fields=context_标注字符串
不可用data.context_annotations.entity.descriptiontweet.fields=context_标注字符串
地理data.geotweet.fields=geo对象
来源：location.linkdata.geo.place_idtweet.fields=geo字符串
不可用data.public_度量tweet.fields=public_指标对象
收藏数data.public_metrics.like_计数tweet.fields=public_度量整型
转推数data.public_metrics.retweet_计数tweet.fields=public_指标Int（整数）
不可用data.public_metrics.quote_计数tweet.fields=public_度量Int（整型）
暂无可用data.public_metrics.reply_计数tweet.fields=public_指标Int（整数）
不可用data.non_无_公共_度量指标tweet.fields=none_public_度量对象
暂无可用data.non_公共_metrics.impression_计数tweet.fields=non_public_指标Int（整型）
不可用data.non_公共_metrics.url_链接_计数tweet.fields=none_公共_度量Int（整数）
不可用data.non_公共_metrics.user_个人资料_计数tweet.fields=none_公共_度量整型
不可用data.organic_度量指标tweet.fields=organic_度量指标对象
不可用data.organic_metrics.like_计数tweet.fields=organic_度量Int（整型）
不可用data.organic_metrics.retweet_计数tweet.fields=organic_度量Int（整数）
暂无可用data.organic_metrics.reply_计数tweet.fields=organic_指标整数
不可用data.organic_metrics.impression_计数tweet.fields=organic_指标Int（整型）
不可用data.organic_metrics.url_链接_计数tweet.fields=organic_指标Int（整型）
不可用data.organic_metrics.user_个人资料_计数值tweet.fields=organic_度量Int（整型）
不可用data.promoted_度量指标tweet.fields=promoted_指标对象
不可用data.promoted_metrics.like_计数值tweet.fields=promoted_度量Int（整型）
不可用data.promoted_metrics.retweet_计数tweet.fields=promoted_指标Int
不可用data.promoted_metrics.reply_计数tweet.fields=promoted_度量Int
不可用data.promoted_metrics.impression_计数tweet.fields=promoted_度量Int（整数）
不可用data.promoted_metrics.url_链接_计数tweet.fields=promoted_度量指标整数
不可用data.promoted_metrics.user_个人资料_计数tweet.fields=promoted_度量指标Int（整型）
gnip.profileLocations不可用不可用
gnip.profileLocations.address不可用不可用
gnip.profileLocations.address.country不可用不可用
gnip.profileLocations.address.countryCode暂无可用不可用
gnip.profileLocations.displayName不可用不可用
gnip.profileLocations.geo暂无可用不可用
gnip.profileLocations.geo.coordinates不可用不可用
gnip.profileLocations.geo.type不可用暂无可用
gnip.profileLocations.objectType不可用不可用

​
User 对象

Activity Streams 格式Twitter v2 格式必填的 v2 参数v2 中的类型
参与方includes.usersexpansions=author_id对象的数组
派生自 actor.idincludes.users.idexpansions=author_id字符串
actor.displayNameincludes.users.nameexpansions=author_id字符串
actor.preferredUsernameincludes.users.usernameexpansions=author_id字符串
actor.postedTimeincludes.users.created_在expansions=author_id&user.fields=created_在日期（ISO 8601）
actor.summaryincludes.users.descriptionexpansions=author_id&user.fields=description字符串
不可用includes.users.pinned_Tweet_idexpansions=author_id&user.fields=pinned_Tweet_id字符串
不可用includes.users.protectedexpansions=author_id&user.fields=protected布尔
actor.link不可用不可用 - 由 includes.users.username 构造
actor.twitterTimeZone不可用不可用 - 可根据 Tweet 的创建时间推断_于
actor.utcOffset不可用不可用—可根据 Tweet 的创建时间推断_在
actor.favoritesCount不可用不可用
actor.followersCountincludes.users.public_metrics.followers_计数expansions=author_id&user.fields=public_度量Int（整型）
actor.friendsCountincludes.users.public_metrics.following_计数值expansions=author_id&user.fields=public_度量Int
actor.listedCountincludes.users.public_metrics.listed_计数expansions=author_id&user.fields=public_度量Int
actor.statusesCountincludes.users.public_metrics.tweet_计数expansions=author_id&user.fields=public_度量指标Int
actor.languages[]暂无可用不可用 - 可根据 Tweet 的语言推断
actor.location.displayNameincludes.users.locationexpansions=author_id&user.fields=location字符串
actor.imageincludes.users.profile_图片_URLexpansions=author_id&user.fields=profile_图片_URL字符串
actor.linksincludes.users.urlexpansions=author_id&user.fields=url字符串
actor.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verified布尔
不可用includes.users.withheldexpansions=author_id&user.fields=withheld对象
不可用includes.users.entitiesexpansions=author_id&user.fields=entities对象
不可用includes.users.entities.urlexpansions=author_id&user.fields=entities对象
actor.linksincludes.users.entities.url.urlsexpansions=author_id&user.fields=entities对象的数组
不可用includes.users.entities.url.urls.startexpansions=author_id&user.fields=entitiesInt（整型）
不可用includes.users.entities.url.urls.endexpansions=author_id&user.fields=entitiesInt
不可用includes.users.entities.url.urls.urlexpansions=author_id&user.fields=entities字符串
actor.links.hrefincludes.users.entities.url.urls.expanded_URLexpansions=author_id&user.fields=entities字符串
暂无可用includes.users.entities.url.urls.display_urlexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.descriptionexpansions=author_id&user.fields=entities对象
不可用includes.users.entities.description.hashtagsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.description.hashtags.startexpansions=author_id&user.fields=entitiesInt（整数）
不可用includes.users.entities.description.hashtags.endexpansions=author_id&user.fields=entitiesInt 整数
暂无可用includes.users.entities.description.hashtags.tagexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.description.mentionsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.description.mentions.startexpansions=author_id&user.fields=entities整数
暂无可用includes.users.entities.description.mentions.endexpansions=author_id&user.fields=entitiesInt（整型）
不可用includes.users.entities.description.mentions.usernameexpansions=author_id&user.fields=entities字符串
不可用includes.users.entities.description.cashtagsexpansions=author_id&user.fields=entities对象数组
不可用includes.users.entities.description.cashtags.startexpansions=author_id&user.fields=entities整数
不可用includes.users.entities.description.cashtags.endexpansions=author_id&user.fields=entitiesInt（整数）
不可用includes.users.entities.description.cashtags.tagexpansions=author_id&user.fields=entities字符串

​
投票对象

Activity Streams 格式Twitter v2 格式v2 必需参数v2 类型
不适用includes.pollsexpansions=attachments.poll_ids对象数组
不适用includes.polls.idexpansions=attachments.poll_ids字符串
不适用includes.polls.optionsexpansions=attachments.poll_ids对象数组
不适用includes.polls.options.positionexpansions=attachments.poll_ids整数
不适用includes.polls.options.labelexpansions=attachments.poll_ids字符串
不适用includes.polls.options.votesexpansions=attachments.poll_ids整数
不适用includes.polls.voting_statusexpansions=attachments.poll_ids&poll.fields=voting_status字符串
不适用includes.polls.duration_minutesexpansions=attachments.poll_ids&poll.fields=duration_minutes整数
不适用includes.polls.end_datetimeexpansions=attachments.poll_ids&poll.fields=end_datetime日期（ISO 8601）

​
Place 对象

Activity Streams 格式X v2 格式所需 v2 参数v2 中的类型
locationincludes.placesexpansions=geo.place_id对象数组
location.displayNameincludes.places.full_nameexpansions=geo.place_id字符串
解析自 location.linkincludes.places.idexpansions=geo.place_id字符串
location.nameincludes.places.nameexpansions=geo.place_id&place.fields=name字符串
location.country_codeincludes.places.countryexpansions=geo.place_id&place.fields=country字符串
location.twitter_place_typeincludes.places.place_typeexpansions=geo.place_id&place.fields=place_type字符串
location.twitter_country_codeincludes.places.country_codeexpansions=geo.place_id&place.fields=country_code字符串
location.geoincludes.places.geoexpansions=geo.place_id&place.fields=geo对象
location.geo.typeincludes.places.geo.typeexpansions=geo.place_id&place.fields=geo字符串
location.geo.coordinatesincludes.places.geo.bboxexpansions=geo.place_id&place.fields=geo数组
不适用includes.places.geo.propertiesexpansions=geo.place_id&place.fields=geo对象

​
媒体对象

Activity Streams 格式Twitter v2 格式必填的 v2 参数v2 中的类型
Twitter_entities.media 或 twitter_扩展版_entities.mediaincludes.mediaexpansions=attachments.media_密钥对象数组
Twitter_entities.media.id_str OR Twitter_扩展版_entities.media.id_strincludes.media.media_密钥expansions=attachments.media_密钥字符串
Twitter_entities.media.id 或 Twitter_延长_entities.media.id不可用不可用
Twitter_entities.media.indices 或 Twitter_扩展版_entities.media.indices不可用不可用
Twitter_entities.media.additional_媒体_info 或 Twitter_扩展版_entities.media.additional_媒体_信息不可用不可用
Twitter_entities.media.additional_媒体_info.monetizable OR twitter_扩展_entities.media.additional_媒体_info.monetizable不可用不可用
Twitter_entities.media.media_URL 或 Twitter_已扩展_entities.media.media_URL暂无可用不可用
X（原 Twitter）_entities.media.media_URL_https 或 Twitter_延展_entities.media.media_url_httpsincludes.media.preview_图片_URLexpansions=attachments.media_密钥&media.fields=preview_图片_URL字符串
X_entities.media.url 或 twitter_扩展版_entities.media.url不可用不可用
Twitter_entities.media.display_URL 或 Twitter_扩展_entities.media.display_url不可用不可用
Twitter_entities.media.expanded_URL 或 Twitter_延长_entities.media.expanded_URL不可用不可用
Twitter_entities.media.type 或 twitter_延长_entities.media.typeincludes.media.typeexpansions=attachments.media_密钥字符串
Twitter_entities.media.sizes OR Twitter_扩展_entities.media.sizes不可用不可用
Twitter_entities.media.sizes.thumb 或 Twitter_扩展版_entities.media.sizes.thumb不可用不可用
X（原 Twitter）_entities.media.sizes.thumb.h 或 Twitter_扩展版_entities.media.sizes.thumb.h不可用不可用
Twitter_entities.media.sizes.thumb.w 或 Twitter_已扩展_entities.media.sizes.thumb.w暂不可用暂无可用内容
Twitter_entities.media.sizes.thumb.resize 或 Twitter_扩充_entities.media.sizes.thumb.resize暂无可用不可用
X（原 Twitter）_entities.media.sizes.small 或 Twitter_延长_entities.media.sizes.small不可用不可用
X（原 Twitter）_entities.media.sizes.small.h 或 Twitter_延长_entities.media.sizes.small.h不可用不可用
Twitter_entities.media.sizes.small.w 或 Twitter_扩展_entities.media.sizes.small.w不可用不可用
Twitter_entities.media.sizes.small.resize 或 Twitter_延长_entities.media.sizes.small.resize不可用不可用
Twitter_entities.media.sizes.medium 或 Twitter_延长版_entities.media.sizes.medium不可用不可用
Twitter_twitter_entities.media.sizes.medium.h 或 twitter_extended_entities.media.sizes.medium.h_扩展版_entities.media.sizes.medium.h不可用不可用
Twitter_entities.media.sizes.medium.w 或 Twitter_延长_entities.media.sizes.medium.w不可用不可用
X（原 Twitter）_entities.media.sizes.medium.resize 或 Twitter_扩展版_entities.media.sizes.medium.resize不可用不可用
Twitter_entities.media.sizes.large 或 Twitter_延长_entities.media.sizes.large不可用不可用
X（原 Twitter）_entities.media.sizes.large.h 或 Twitter_延长_entities.media.sizes.large.hincludes.media.heightexpansions=attachments.media_密钥&media.fields=heightInt（整型）
Twitter_entities.media.sizes.large.w 或 Twitter_扩展版_entities.media.sizes.large.wincludes.media.widthexpansions=attachments.media_密钥&media.fields=width整数
Twitter_entities.media.sizes.large.resize 或 Twitter_扩展版_entities.media.sizes.large.resize不可用不可用
Twitter_延展_entities.media.video_信息不可用不可用
X（原 Twitter）_扩展版_entities.media.video_info.aspect_比率不可用不可用
Twitter_已扩展_entities.media.video_info.duration_毫秒includes.media.duration_msexpansions=attachments.media_密钥&media.fields=duration_毫秒（ms）Int（整型）
Twitter_扩展_entities.media.video_info.variants不可用不可用
Twitter_已扩展_entities.media.video_info.variants.bitrate不可用不可用
X（原 Twitter）_扩展版_entities.media.video_info.variants.content_类型不可用不可用
Twitter_扩展版_entities.media.video_info.variants.url不可用不可用
不可用includes.media.alt_文本expansions=attachments.media_密钥&media.fields=alt_文本字符串
不可用includes.media.public_度量expansions=attachments.media_密钥&media.fields=public_度量指标对象
不可用includes.media.public_metrics.view_计数expansions=attachments.media_密钥&media.fields=public_指标整数
不可用includes.media.non_公共_指标expansions=attachments.media_密钥&media.fields=none_公共_度量指标对象
不可用includes.media.non_公共_metrics.playback_0_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int（整数）
不可用includes.media.none_公共_metrics.playback_25_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int
不可用includes.media.non_公共_metrics.playback_50_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int
不可用includes.media.non_公共_metrics.playback_75_计数expansions=attachments.media_密钥&media.fields=none_公共_度量Int（整数）
不可用includes.media.non_公共_metrics.playback_100_计数值expansions=attachments.media_密钥&media.fields=none_公共_度量Int（整型）
不可用includes.media.organic_指标expansions=attachments.media_密钥&media.fields=organic_指标对象
不可用includes.media.organic_metrics.playback_0_计数expansions=attachments.media_密钥&media.fields=organic_度量Int（整数）
不可用includes.media.organic_metrics.playback_25_计数值expansions=attachments.media_密钥&media.fields=organic_度量Int（整型）
不可用includes.media.organic_metrics.playback_50_计数expansions=attachments.media_密钥&media.fields=organic_指标整数
不可用includes.media.organic_metrics.playback_75_计数expansions=attachments.media_密钥&media.fields=organic_度量Int（整数）
不可用includes.media.organic_metrics.playback_100_计数expansions=attachments.media_密钥&media.fields=organic_度量Int
不可用includes.media.organic_metrics.view_计数expansions=attachments.media_密钥&media.fields=organic_度量Int（整型）
不可用includes.media.promoted_度量expansions=attachments.media_密钥&media.fields=promoted_度量对象
不可用includes.media.promoted_metrics.playback_0_计数expansions=attachments.media_密钥&media.fields=promoted_度量指标Int（整数）
不可用includes.media.promoted_metrics.playback_25_计数值expansions=attachments.media_密钥&media.fields=promoted_度量Int（整型）
不可用includes.media.promoted_metrics.playback_50_计数expansions=attachments.media_密钥&media.fields=promoted_指标Int（整型）
不可用includes.media.promoted_metrics.playback（播放次数）_75_计数expansions=attachments.media_密钥&media.fields=promoted_度量整数
不可用includes.media.promoted_metrics.playback（回放）_100_计数expansions=attachments.media_密钥&media.fields=promoted_度量指标Int（整型）
不可用includes.media.promoted_metrics.view_计数expansions=attachments.media_密钥&media.fields=promoted_度量Int（整型）

​
匹配规则对象

Activity Streams 格式Twitter v2 格式v2 必需参数v2 中的类型
gnip.matching_rulesmatching_rules过滤流中的默认项对象数组
gnip.matching_rules.tagmatching_rules.tag过滤流中的默认项字符串
gnip.matching_rules.tag.id不可用不可用
gnip.matching_rules.tag.id_strmatching_rules.id过滤流中的默认项字符串

​
可视化数据格式迁移工具

可视化数据格式迁移工具是一个 Web 应用，用于展示在给定的 Tweet 或用户对象中，从 X API v1.1 数据格式 映射到 X API v2 格式 的字段。你可以向该应用提供 Tweet ID 或用户 ID 以查看对应的映射关系。 请注意，你需要使用你的 Twitter 帐号登录才能使用该应用。