メインコンテンツへスキップ

​
はじめに

X API の v2 リリースに伴い、新しい data レスポンス形式と、各種オブジェクトや fields のリクエスト方法を採用しました。これを「X API v2 形式」と呼びます。  「一般的な相違点」セクションでは、Standard および Enterprise のユーザーに関連する変更点を確認できます。あわせて、standard v1.1 Native format、Enterprise 向けの Native Enriched format、および Enterprise 向けの Activity Streams format についての個別ガイドも用意しており、fields のマッピングや、新しい v2 の fields をリクエストする際に使用すべき fields と expansions を説明しています。  X API v1.1 data format と X API v2 format の違いを迅速に確認できる visual data format migration tool もご用意しています。

​
一般的な相違点

​
オブジェクトと fields のリクエスト

pre-v2 の endpoint と v2 の大きな違いのひとつは、新しいバージョンではデフォルトで返される fields がごく一部に限られるのに対し、standard、premium、enterprise の endpoint ではほとんどの fields がデフォルトで返される点です。新しいバージョンでは、デフォルトを超えて追加のデータを明示的に要求するために、fields と expansions というパラメータを使用します。これにより、不要な fields を取り込むことなく、必要な data だけをリクエストできます。 プライマリの data オブジェクトに関連する fields をリクエストした場合、それらはデフォルト値とともにそのプライマリの data オブジェクト内で返されます。なお、expansions パラメータで拡張オブジェクトを要求した場合、セカンダリのオブジェクトは新しい includes オブジェクト内で返されます。includes オブジェクト内の拡張オブジェクトは、両方に含まれる ID フィールドを用いてプライマリオブジェクトと突き合わせることができます。 たとえば、v2 の Post lookup endpoint を使用し、リクエストに expansions=author_id パラメータを含めた場合、プライマリの Post オブジェクト内に author_id フィールドが返されるとともに、includes オブジェクト内に Post ごとにユーザーオブジェクトが返されます。いずれにもデフォルトの id フィールドが含まれるため、ユーザーオブジェクトを Post オブジェクトに照合できます。以下はその例です: 
{
  "data": [
    {
      "author_id": "2244994945",
      "id": "1397568983931392004",
      "text": "X Developer Platform。おお、素晴らしい！ https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev"
      }
    ]
  }
}

​
更新された JSON 設計

特定の fields のリクエスト方法の変更に加え、X API v2 では API が返すオブジェクト（Post や user オブジェクトを含む）に対して新しい JSON 設計も導入しています。
  • JSON のルートレベルでは、標準の endpoint は Post オブジェクトを statuses 配列で返しますが、X API v2 では data 配列で返します。
  • リツイートおよび引用の「statuses」を参照する代わりに、X API v2 の JSON ではリツイートおよび引用の Tweet を参照します。contributors や user.translator_type など、多くのレガシーおよび非推奨の fields は削除されています。
  • favorites（Post オブジェクト内）と favourites（ユーザーオブジェクト内）の両方を用いる代わりに、X API v2 では用語 like を使用します。
  • X では、値が存在しない JSON 値（たとえば null）はペイロードに書き込まないという規約を採用しています。Post と user の属性は、非 null の値がある場合にのみ含まれます。   

​
新しい v2 fields

また、Post オブジェクト に、次の新しい fields のセットを追加しました。
  • conversation_id field
  • 新しい annotations fields を 2 つ（context と entities を含む）
  • 複数の新しい metrics fields
  • 新しい reply_setting field（特定の Post に返信できるユーザーを示す）

​
Standard v1.1 のデータ形式から v2 への移行

まだお読みでない場合は、まずデータ形式の移行のイントロダクションをご確認ください。X API v1.1 のデータ形式とX API v2 の形式の違いを迅速に把握できるビジュアルデータ形式移行ツールも併せてご覧になると便利です。 Standard v1.1 のデータ形式（ネイティブ形式とも呼ばれます）は、Standard v1.1 の endpoint で提供される主要な形式です。 Premium 製品をご利用の場合は、ネイティブ拡張ガイドを参照してください。Enterprise クライアントは、Gnip コンソールでの設定に応じて、ネイティブ拡張または activity streams を使用している可能性があります。 

​
Standard v1.1 と v2 のペイロード構造

以下の表は、v1.1 の形式と比較して v2 で受け取れる想定の高レベルなオブジェクトとフォーマットを示します。
v1.1 structurev2 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”: []
}
フィールドの対応 以下では、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
{
“created_at”: “Wed Feb 10 17:26:34 +0000 2021”,
“id”: 1359554366051504129,
“id_str”: “1359554366051504129”,
“text”: “どうぞ、別の子犬アカウントをフォローしてください。私たちは判断しません。\n\n新しい… https://t.co/3cBZKZUevFにフォロー管理endpointを導入します”,
“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”: “どうぞ、別の子犬アカウントをフォローしてください。私たちは判断しません。\n\n新しい#TwitterAPIにフォロー管理endpointを導入します。v2 APIを使用してアカウントのフォローとフォロー解除ができるようになりました。詳細はこちら 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”: “X API v2への新しいフォロー管理endpointの導入”,
“description”: “フォローするか、しないか？X API v2を使用して、その質問に自由に答えることができるようになりました。本日、新しいTwitter APIに新しいフォロー管理endpointのリリースを発表できることを嬉しく思います。1か月ほど前にフォロー検索endpointをローンチした際に予告していた通り、フォロー関係を管理する機能がついに登場しました。これらはv1.1 APIで最も人気のあるendpointの一部であるため、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”: “ブランドカテゴリ”,
“description”: “ブランドの範囲を絞り込むブランドバーティカル内のカテゴリ”
},
“entity”: {
“id”: “781974596752842752”,
“name”: “サービス”
}
},
{
“domain”: {
“id”: “47”,
“name”: “ブランド”,
“description”: “ブランドと企業”
},
“entity”: {
“id”: “10045225402”,
“name”: “Twitter”
}
}
]
}]
}

​
ユーザーオブジェクト

Twitter 1.1 形式Twitter v2 形式必須の v2 パラメーター
user_iddata.author_idtweet.fields=author_id
user.idN/A use 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のユーザーオブジェクト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 と 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_urlN/A のため includes.media.url を使用string
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のエンティティと拡張エンティティ（動画付き）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
”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”: “ユースケース、チュートリアル、ドキュメント”,
“description”: “X API、X Ads API、X for Websitesを使用してポストの公開・分析、広告の最適化、独自の顧客体験の創出を行いましょう。開発を始めましょう。”,
“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”: “#TwitterDevチームの公式アカウントです。#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 オブジェクト

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 データ形式は、当社のEnterprise製品で使用されています。 Native Enriched データ形式は、編集済み Tweet のメタデータを提供するよう更新されました。Edit Tweet のメタデータの詳細は、Edit Tweets の基礎ページをご覧ください。 Standard v1.1 の endpoint を使用している場合は、Standard v1.1 から v2 へのガイドを参照してください。Activity Streams を使用する Enterprise 製品をご利用の場合は、Activity Streams から v2へのガイドも用意しています。 X API v2 では、Tweet および user オブジェクト向けに新しい JSON 設計が導入されています。
  • JSON のルートレベルでは、Native Enriched 形式は Tweet オブジェクトを results 配列で返しますが、X API v2 は data 配列で返します。
  • favorites（Tweet オブジェクト内）と favourites（user オブジェクト内）を併用する代わりに、X API v2 では用語 like を使用します。
  • X では、値を持たない JSON 値（例: null）はペイロードに書き込まないという規約を採用しています。Tweet と user の属性は、null 以外の値がある場合にのみ含まれます。
  • v2 のすべての id フィールドは文字列形式になります  
新しい JSON 形式への変更に加えて、Tweet オブジェクトに以下を含む新しい fields セットを導入しました。
  • conversation_id
  • reply_settings
  • メディアの alt_text
  • 2 つの新しい annotations fields（context と entities を含む）
  • 複数の新しい metrics fields
  • 複数の新しい polls fields  
多くのレガシーおよび非推奨の fields は削除されます。
  • contributors
  • entities.media および extended_entities.media の一部の fields
  • 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 オブジェクト

Native Enriched形式Twitter v2形式必要なv2パラメータv2での型
created_atdata.created_attweet.fields=created_atString
idN/A - idを参照
id_strdata.idデフォルトString
textdata.textデフォルトString
edit_historydata.edit_history_tweet_idsデフォルトArray
edit_controlsdata.edit_controlstweet.fields=edit_controlsObject
editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controlsBoolean
display_text_rangeN/A - textには完全なテキストが含まれます
sourcedata.sourcetweet.fields=sourceString
truncatedN/A - textには完全なテキストが含まれます
利用不可data.conversation_idtweet.fields=conversation_idString
利用不可data.reply_settingstweet.fields=reply_settingsString
in_reply_to_status_idN/A - referenced_tweets.idを参照
in_reply_to_status_id_strdata.referenced_tweets.id (if type=replied_to)expansions=referenced_tweets.idString
in_reply_to_user_idN/A - in_reply_to_user_id_strを参照
in_reply_to_user_id_strdata.in_reply_to_user_idtweet.fields=in_reply_to_user_idString
in_reply_to_screen_nameincludes.users..usernametweet.fields=in_reply_to_user_id&expansions=entities.mentions.usernameString
userincludes.usersexpansions=author_idObject
user.id_strdata.author_idtweet.fields=author_idString
geodata.geo.place_idtweet.fields=geo
coordinatesdata.geo.place_idtweet.fields=geo
placedata.geo.place_idtweet.fields=geo
is_quoted_statusdata.referenced_tweets.id (if type=quoted)tweet.fields=referenced_tweetsString
extended_tweet.full_textN/A - textは完全なテキストです
利用不可data.public_metricstweet.fields=public_metricsObject
quote_countdata.public_metrics.quote_counttweet.fields=public_metricsInt
reply_countdata.public_metrics.reply_counttweet.fields=public_metricsInt
retweet_countdata.public_metrics.retweet_counttweet.fields=public_metricsInt
favorite_countdata.public_metrics.like_counttweet.fields=public_metricsInt
利用不可data.non_public_metricstweet.fields=non_public_metricsObject
利用不可data.non_public_metrics.impression_counttweet.fields=non_public_metricsInt
利用不可data.non_public_metrics.url_link_counttweet.fields=non_public_metricsInt
利用不可data.non_public_metrics.user_profile_counttweet.fields=non_public_metricsInt
利用不可data.organic_metricstweet.fields=organic_metricsObject
利用不可data.organic_metrics.like_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.retweet_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.reply_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.impression_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.url_link_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.user_profile_counttweet.fields=organic_metricsInt
利用不可data.promoted_metricstweet.fields=promoted_metricsObject
利用不可data.promoted_metrics.like_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.retweet_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.reply_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.impression_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.url_link_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.user_profile_counttweet.fields=promoted_metricsInt
contributors利用不可利用不可
entitiesdata.entitiestweet.fields=entitiesObject
entities.user_mentionsdata.entities.mentionstweet.fields=entitiesArray of objects
entities.symbolsdata.entities.cashtagstweet.fields=entitiesArray of objects
entities.hashtagsdata.entities.hashtagstweet.fields=entitiesArray of objects
entities.urlsdata.entities.urlstweet.fields=entitiesArray of objects
entities.mediaincludes.mediaexpansions=attachments.media_keysArray of objects
entities.annotationstweet.fields=entities,context_annotationsObject
entities.annotations.contextdata.context_annotationstweet.fields=entities,context_annotationsArray of objects
同等のものなしdata.context_annotations.domaintweet.fields=context_annotationsObject
entities.annotations.context.context_domain_id_strdata.context_annotations.domain.idtweet.fields=context_annotationsString
entities.annotations.context.context_domain_id利用不可利用不可 - 文字列形式についてはdata.context_annotations.domain.idを参照
entities.annotations.context.context_domain_namedata.context_annotations.domain.nametweet.fields=context_annotationsString
entities.annotations.context.context_domain_descriptiondata.context_annotations.domain.descriptiontweet.fields=context_annotationsString
同等のものなしdata.context_annotations.entitytweet.fields=context_annotationsObject
entities.annotations.context.context_entity_id_strdata.context_annotations.entity.idtweet.fields=context_annotationsString
entities.annotations.context.context_entity_id利用不可利用不可 - 文字列形式についてはdata.context_annotations.entity.idを参照
entities.annotations.context.context_entity_namedata.context_annotations.entity.nametweet.fields=context_annotationsString
entities.annotations.context.context_entity_descriptiondata.context_annotations.entity.descriptiontweet.fields=context_annotationsString
entities.annotations.entitydata.entities.annotationstweet.fields=entities,context_annotationsArray of objects
extended_entitiesdata.attachmentstweet_fields=attachmentsObject
favorited利用不可利用不可
retweeted利用不可利用不可
retweeted_status
possibly_sensitivedata.possibly_sensitivetweet.fields=possibly_sensitiveBoolean
langdata.langtweet.fields=langString
filter_level利用不可利用不可
scopes利用不可利用不可
timestamp_ms利用不可利用不可
withhelddata.withheldtweet.fields=withheldArray of objects
matching_rulesmatching_rulesArray of objects
matching_rules.id利用不可利用不可
matching_rules.id_strmatching_rules.idFiltered streamでのデフォルトString
matching_rules.tagmatching_rules.tagFiltered streamでのデフォルトString

​
ユーザーオブジェクト

Native Enriched形式X v2形式必要なv2パラメータv2での型
userincludes.usersexpansions=author_idArray of objects
user.id利用不可N/A - includes.users.idを参照String
user.id_strincludes.users.idexpansions=author_idString
user.nameincludes.users.nameexpansions=author_idString
user.screen_nameincludes.user.usernameexpansions=author_idString
user.locationincludes.users.locationexpansions=author_id&user.fields=locationObject
user.descriptionincludes.users.descriptionexpansions=author_id&user.fields=descriptionString
利用不可includes.users.urlexpansions=author_id&user.fields=urlString
user.followers_countincludes.users.public_metrics.followers_countexpansions=author_id&user.fields=public_metricsInt
user.friends_countincludes.users.public_metrics.following_countexpansions=author_id&user.fields=public_metricsInt
user.listed_countincludes.users.public_metrics.listed_countexpansions=author_id&user.fields=public_metricsInt
user.created_atincludes.users.created_atexpansions=author_id&user.fields=created_atString
user.favourites_countまだ利用不可
user.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verifiedBoolean
利用不可includes.users.pinned_tweet_idexpansions=author_id&user.fields=pinned_tweet_idString
user.statuses_countincludes.users.public_metrics.tweet_countexpansions=author_id&user.fields=public_metricsInt
user.profile_image_url_httpsincludes.users.profile_image_urlexpansions=author_id&user.fields=profile_image_urlString
user.translator_type利用不可利用不可
user.utc_offset利用不可利用不可
user.time_zone利用不可利用不可
user.geo_enabled利用不可利用不可
user.lang利用不可利用不可 - Tweetのlangから推測
user.contributors_enabled利用不可利用不可
user.is_translator利用不可利用不可
user.profile_background_color利用不可利用不可
user.profile_background_image_url利用不可利用不可
user.profile_background_image_url_https利用不可利用不可
user.profile_background_title利用不可利用不可
user.profile_sidebar_border_color利用不可利用不可
user.profile_sidebar_fill_color利用不可利用不可
user.profile_text_color利用不可利用不可
user.profile_user_background_image利用不可利用不可
user.profile_image_urlincludes.user.profile_image_urlを参照
user.default_profile利用不可利用不可
user.default_profile_image利用不可利用不可
user.following利用不可利用不可
user.follow_request_sent利用不可利用不可
user.notifications利用不可利用不可
user.withheld_in_countriesincludes.users.withheldexpansions=author_id&user.fields=withheldObject
user.protectedincludes.users.protectedexpansions=author_id&user.fields=protectedBoolean
利用不可includes.users.entitiesexpansions=author_id&user.fields=entitiesObject
利用不可includes.users.entities.urlexpansions=author_id&user.fields=entitiesObject
利用不可includes.users.entities.url.urlsexpansions=author_id&user.fields=entitiesArray of objects
利用不可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=entitiesString
user.urlincludes.users.entities.url.urls.expanded_urlexpansions=author_id&user.fields=entitiesString
利用不可includes.users.entities.url.urls.display_urlexpansions=author_id&user.fields=entitiesString
利用不可includes.users.entities.descriptionsexpansions=author_id&user.fields=entitiesObject
利用不可includes.users.entities.descriptions.hashtagsexpansions=author_id&user.fields=entitiesArray of objects
利用不可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=entitiesString
利用不可includes.users.entities.descriptions.mentionsexpansions=author_id&user.fields=entitiesArray of objects
利用不可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=entitiesString
利用不可includes.users.entities.descriptions.cashtagsexpansions=author_id&user.fields=entitiesArray of objects
利用不可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=entitiesString

​
entities オブジェクトと expanded_entities オブジェクト

Native Enriched形式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=entitiesInteger
entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entitiesInteger
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=entitiesInteger
entities.urls.indices[1]data.entities.urls.endtweet.fields=entitiesInteger
entities.urls.urldata.entities.urls.urltweet.fields=entitiesString
entities.urls.expanded_urldata.entities.urls.expanded_urltweet.fields=entitiesString
entities.urls.display_urldata.entities.urls.display_urltweet.fields=entitiesString
entities.urls.unwound.urldata.entities.urls.unwound_urltweet.fields=entitiesString
entities.urls.unwound.statusdata.entities.urls.statustweet.fields=entitiesString
entities.urls.unwound.titledata.entities.urls.titletweet.fields=entitiesString
entities.urls.unwound.descriptiondata.entities.urls.descriptiontweet.fields=entitiesString
利用不可data.entities.urls.imagestweet.fields=entitiesArray of objects
利用不可data.entities.urls.images.urltweet.fields=entitiesString
利用不可data.entities.urls.images.widthtweet.fields=entitiesInt
利用不可data.entities.urls.images.heighttweet.fields=entitiesInt
entities.user_mentionsdata.entities.mentionstweet.fields=entitiesArray of objects
entities.user_mentions.indicies[0]data.entities.mentions.starttweet.fields=entitiesInteger
entities.user_mentions.indicies[1]data.entities.mentions.endtweet.fields=entitiesInteger
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=entitiesInteger
entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entitiesInteger
entities.symbols.textdata.entities.cashtags.tagtweet.fields=entitiesString
entities.media OR extended_entities.mediaincludes.mediaexpansions=attachments.media_keysArray of objects
entities.media.id_str OR extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysString
entities.media.id OR extended_entities.media.id利用不可 - idは文字列です
entities.media.type OR extended_entities.media.typeincludes.media.media.typeexpansions=attachments.media_keysString
entities.media.indices OR extended_entities.media.indices利用不可利用不可
利用不可includes.media.alt_textexpansions=attachments.media_keys&media.fields=alt_textString
entities.media.additional_media_info OR extended_entities.media.additional_media_info利用不可利用不可
entities.media.additional_media_info.monetizable OR extended_entities.media.additional_media_info.monetizable利用不可利用不可
entities.media.media_url OR extended_entities.media.media_urlN/A - includes.media.urlを参照String
entities.media.media_url_https OR extended_entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_keys&media.fields=urlString
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_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
利用不可data.attachments.poll_idstweet.fields=attachmentsArray of objects
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.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlString
extended_entities.media.video_info.aspect_ratio利用不可利用不可
extended_entities.media.variants利用不可利用不可
extended_entities.media.variants.bitrate利用不可利用不可
extended_entities.media.variants.content_type利用不可利用不可
extended_entities.media.variants.url利用不可利用不可
extended_entities.media.video_info.duration_millisincludes.media.duration_msexpansions=attachments.media_keys&media.fields=duration_msInt
利用不可includes.media.public_metricsexpansions=attachments.media_keys&media.fields=public_metricsObject
利用不可includes.media.public_metrics.view_countexpansions=attachments.media_keys&media.fields=public_metricsInt
利用不可includes.media.non_public_metricsexpansions=attachments.media_keys&media.fields=non_public_metricsObject
利用不可includes.media.non_public_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.organic_metricsexpansions=attachments.media_keys&media.fields=organic_metricsObject
利用不可includes.media.organic_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.view_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.promoted_metricexpansions=attachments.media_keys&media.fields=promoted_metricsObject
利用不可includes.media.promoted_metric.playback_0_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metric.playback_25_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metric.playback_50_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metric.playback_75_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metric.playback_100_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.view_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt

​
Place オブジェクト

ネイティブ拡張形式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 データ形式は、当社の enterprise 製品で利用できます。 Activity Streams データ形式は、編集済み Tweet の metadata を提供できるよう更新されました。Edit Tweet の metadata の詳細は、Edit Tweets fundamentals ページをご覧ください。 Standard v1.1 の endpoint を使用している場合は、standard v1.1 to v2 guide を参照してください。premium の endpoint、または enterprise 向けの Native Enriched 形式を使用している場合は、Native Enriched to v2 guide を参照してください。 X API v2 では、Post および user オブジェクト向けに新しい JSON 設計が導入されています。
  • JSON のルートレベルでは、Activity Streams 形式は results 配列で Tweet オブジェクトを返しますが、X API v2 は data 配列を返します。
  • Retweeted および Quoted の「activities」と呼ぶ代わりに、X API v2 の JSON では Retweeted および Quoted Tweets と表現します。
  • Tweet オブジェクトでの favorites と user オブジェクトでの favourites の両方を使う代わりに、X API v2 では用語として like を使用します。
  • X は、値がない JSON 値（例: null）はペイロードに含めないという慣例を採用しています。Tweet および user の属性は、非 null の値がある場合にのみ含まれます。
  • v2 のすべての id フィールドは文字列形式になります。  
新しい JSON 形式への変更に加えて、Tweet オブジェクトに次の新しい fields も導入しました:
  • conversation_id
  • reply_settings
  • メディアの alt_text
  • 新しい 2 つの annotations fields（context および entities を含む）
  • 複数の新しい metrics fields
  • 複数の新しい polls fields  
多くのレガシー/非推奨の fields は削除または置換されます:
  • display_text_range
  • generator
  • gnip
  • link
  • objectType
  • provider
  • twitter_entities.symbols は data.entities.cashtags に置換
  • 一部の twitter_extended_entities.media および twitter_entities.media fields
  • twitter_filter_level
  • twitterTimeZone
  • verb

​
Tweet オブジェクト

Activity Streams 形式Twitter v2 形式必須の v2 パラメータv2 の型
postedTimedata.created_attweet.fields=created_at日付（ISO 8601）
generator利用不可利用不可
generator.link利用不可利用不可
generator.displayNamedata.sourcetweet.fields=source文字列
twitter_langdata.langtweet.fields=lang文字列
利用不可data.conversation_idtweet.fields=conversation_id文字列
利用不可data.reply_settingstweet.fields=reply_settings文字列
利用不可data.possibly_sensitivetweet.fields=possibly_sensitiveブール値
利用不可data.withheldtweet.fields=withheldオブジェクト
objectType利用不可利用不可
verb利用不可利用不可
provider利用不可利用不可
provider.objectType利用不可利用不可
provider.displayName利用不可利用不可
provider.link利用不可利用不可
link利用不可利用不可
display_text_range利用不可利用不可
object利用不可利用不可
object.objectType利用不可利用不可
object.id利用不可利用不可
object.summarydata.text既定文字列
object.edit_historydata.edit_history_tweet_ids既定配列
object.edit_controlsdata.edit_controlstweet.fields=edit_controlsオブジェクト
object.editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controlsブール値
object.link利用不可利用不可
object.postedTimedata.created_attweet.fields=created_at日付（ISO 8601）
Derived from actor.iddata.author_idtweet.fields=created_at
twitter_filter_level利用不可利用不可
Derived from username in inReplyTo.linkdata.in_reply_to_user_idtweet.fields=in_reply_to_user_id文字列
利用不可data.referenced_tweetstweet.fields=referenced_tweetsオブジェクトの配列
利用不可data.referenced_tweets.typetweet.fields=referenced_tweets文字列
Derived from inReplyTo.linkdata.referenced_tweets.idtweet.fields=referenced_tweets文字列
利用不可data.attachmentstweet.fields=attachmentsオブジェクト
Derived from twitter_entities.media.id_strdata.attachments.media_keystweet.fields=attachments配列
利用不可data.attachments.poll_idstweet.fields=attachments配列
twitter_entitiesdata.entitiestweet.fields=entitiesオブジェクト
利用不可data.entities.annotationstweet.fields=entitiesオブジェクトの配列
利用不可data.entities.annotations.starttweet.fields=entities整数
利用不可data.entities.annotations.endtweet.fields=entities整数
利用不可data.entities.annotations.probabilitytweet.fields=entities浮動小数点数
利用不可data.entities.annotations.typetweet.fields=entities文字列
利用不可data.entities.annotations.normalized_texttweet.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整数
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=entities整数
利用不可data.entities.urls.images.heighttweet.fields=entities整数
gnip.urls.expanded_statusdata.entities.urls.statustweet.fields=entities整数
gnip.urls.expanded_url_titledata.entities.urls.titletweet.fields=entities文字列
gnip.urls.expanded_url_descriptiondata.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=entities整数
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=entities整数
twitter_entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entities整数
twitter_entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entities文字列
twitter_entities.user_mentionsdata.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=entities整数
twitter_entities.user_mentions.screen_namedata.entities.mentions.tagtweet.fields=entities文字列
twitter_entities.user_mentions.id_strdata.entities.mentions.idtweet.fields=entities文字列
twitter_entities.user_mentions.id利用不可利用不可
利用不可data.context_annotationstweet.fields=context_annotationsオブジェクトの配列
利用不可data.context_annotations.domaintweet.fields=context_annotationsオブジェクト
利用不可data.context_annotations.domain.idtweet.fields=context_annotations文字列
利用不可data.context_annotations.domain.nametweet.fields=context_annotations文字列
利用不可data.context_annotations.domain.descriptiontweet.fields=context_annotations文字列
利用不可data.context_annotations.entitytweet.fields=context_annotationsオブジェクト
利用不可data.context_annotations.entity.idtweet.fields=context_annotations文字列
利用不可data.context_annotations.entity.nametweet.fields=context_annotations文字列
利用不可data.context_annotations.entity.descriptiontweet.fields=context_annotations文字列
geodata.geotweet.fields=geoオブジェクト
Derived from location.linkdata.geo.place_idtweet.fields=geo文字列
利用不可data.public_metricstweet.fields=public_metricsオブジェクト
favoritesCountdata.public_metrics.like_counttweet.fields=public_metrics整数
retweetCountdata.public_metrics.retweet_counttweet.fields=public_metrics整数
利用不可data.public_metrics.quote_counttweet.fields=public_metrics整数
利用不可data.public_metrics.reply_counttweet.fields=public_metrics整数
利用不可data.non_non_public_metricstweet.fields=non_public_metricsオブジェクト
利用不可data.non_public_metrics.impression_counttweet.fields=non_public_metrics整数
利用不可data.non_public_metrics.url_link_counttweet.fields=non_public_metrics整数
利用不可data.non_public_metrics.user_profile_counttweet.fields=non_public_metrics整数
利用不可data.organic_metricstweet.fields=organic_metricsオブジェクト
利用不可data.organic_metrics.like_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.retweet_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.reply_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.impression_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.url_link_counttweet.fields=organic_metricsInt
利用不可data.organic_metrics.user_profile_counttweet.fields=organic_metricsInt
利用不可data.promoted_metricstweet.fields=promoted_metricsObject
利用不可data.promoted_metrics.like_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.retweet_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.reply_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.impression_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.url_link_counttweet.fields=promoted_metricsInt
利用不可data.promoted_metrics.user_profile_counttweet.fields=promoted_metricsInt
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利用不可利用不可

​
ユーザーオブジェクト

Activity Streams形式X v2形式v2必須パラメータv2での型
actorincludes.usersexpansions=author_idオブジェクトの配列
actor.idから派生includes.users.idexpansions=author_id文字列
actor.displayNameincludes.users.nameexpansions=author_id文字列
actor.preferredUsernameincludes.users.usernameexpansions=author_id文字列
actor.postedTimeincludes.users.created_atexpansions=author_id&user.fields=created_at日付 (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利用不可利用不可 - Postのcreated_atから推測
actor.utcOffset利用不可利用不可 - Postのcreated_atから推測
actor.favoritesCount利用不可利用不可
actor.followersCountincludes.users.public_metrics.followers_countexpansions=author_id&user.fields=public_metrics整数
actor.friendsCountincludes.users.public_metrics.following_countexpansions=author_id&user.fields=public_metrics整数
actor.listedCountincludes.users.public_metrics.listed_countexpansions=author_id&user.fields=public_metrics整数
actor.statusesCountincludes.users.public_metrics.tweet_countexpansions=author_id&user.fields=public_metrics整数
actor.languages[]利用不可利用不可 - Postのlangから推測
actor.location.displayNameincludes.users.locationexpansions=author_id&user.fields=location文字列
actor.imageincludes.users.profile_image_urlexpansions=author_id&user.fields=profile_image_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=entities整数
利用不可includes.users.entities.url.urls.endexpansions=author_id&user.fields=entities整数
利用不可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=entities整数
利用不可includes.users.entities.description.hashtags.endexpansions=author_id&user.fields=entities整数
利用不可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=entities整数
利用不可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=entities整数
利用不可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 API v2 形式必須の v2 パラメータv2 における型
locationincludes.placesexpansions=geo.place_idオブジェクトの配列
location.displayNameincludes.places.full_nameexpansions=geo.place_id文字列
location.link から解析includes.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 OR twitter_extended_entities.mediaincludes.mediaexpansions=attachments.media_keysArray of objects
twitter_entities.media.id_str OR twitter_extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysString
twitter_entities.media.id OR twitter_extended_entities.media.id利用不可利用不可
twitter_entities.media.indices OR twitter_extended_entities.media.indices利用不可利用不可
twitter_entities.media.additional_media_info OR twitter_extended_entities.media.additional_media_info利用不可利用不可
twitter_entities.media.additional_media_info.monetizable OR twitter_extended_entities.media.additional_media_info.monetizable利用不可利用不可
twitter_entities.media.media_url OR twitter_extended_entities.media.media_url利用不可利用不可
twitter_entities.media.media_url_https OR twitter_extended_entities.media.media_url_httpsincludes.media.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlString
twitter_entities.media.url OR twitter_extended_entities.media.url利用不可利用不可
twitter_entities.media.display_url OR twitter_extended_entities.media.display_url利用不可利用不可
twitter_entities.media.expanded_url OR twitter_extended_entities.media.expanded_url利用不可利用不可
twitter_entities.media.type OR twitter_extended_entities.media.typeincludes.media.typeexpansions=attachments.media_keysString
twitter_entities.media.sizes OR twitter_extended_entities.media.sizes利用不可利用不可
twitter_entities.media.sizes.thumb OR twitter_extended_entities.media.sizes.thumb利用不可利用不可
twitter_entities.media.sizes.thumb.h OR twitter_extended_entities.media.sizes.thumb.h利用不可利用不可
twitter_entities.media.sizes.thumb.w OR twitter_extended_entities.media.sizes.thumb.w利用不可利用不可
twitter_entities.media.sizes.thumb.resize OR twitter_extended_entities.media.sizes.thumb.resize利用不可利用不可
twitter_entities.media.sizes.small OR twitter_extended_entities.media.sizes.small利用不可利用不可
twitter_entities.media.sizes.small.h OR twitter_extended_entities.media.sizes.small.h利用不可利用不可
twitter_entities.media.sizes.small.w OR twitter_extended_entities.media.sizes.small.w利用不可利用不可
twitter_entities.media.sizes.small.resize OR twitter_extended_entities.media.sizes.small.resize利用不可利用不可
twitter_entities.media.sizes.medium OR twitter_extended_entities.media.sizes.medium利用不可利用不可
twitter_entities.media.sizes.medium.h OR twitter_extended_entities.media.sizes.medium.h利用不可利用不可
twitter_entities.media.sizes.medium.w OR twitter_extended_entities.media.sizes.medium.w利用不可利用不可
twitter_entities.media.sizes.medium.resize OR twitter_extended_entities.media.sizes.medium.resize利用不可利用不可
twitter_entities.media.sizes.large OR twitter_extended_entities.media.sizes.large利用不可利用不可
twitter_entities.media.sizes.large.h OR twitter_extended_entities.media.sizes.large.hincludes.media.heightexpansions=attachments.media_keys&media.fields=heightInt
twitter_entities.media.sizes.large.w OR twitter_extended_entities.media.sizes.large.wincludes.media.widthexpansions=attachments.media_keys&media.fields=widthInt
twitter_entities.media.sizes.large.resize OR twitter_extended_entities.media.sizes.large.resize利用不可利用不可
twitter_extended_entities.media.video_info利用不可利用不可
twitter_extended_entities.media.video_info.aspect_ratio利用不可利用不可
twitter_extended_entities.media.video_info.duration_millisincludes.media.duration_msexpansions=attachments.media_keys&media.fields=duration_msInt
twitter_extended_entities.media.video_info.variants利用不可利用不可
twitter_extended_entities.media.video_info.variants.bitrate利用不可利用不可
twitter_extended_entities.media.video_info.variants.content_type利用不可利用不可
twitter_extended_entities.media.video_info.variants.url利用不可利用不可
利用不可includes.media.alt_textexpansions=attachments.media_keys&media.fields=alt_textString
利用不可includes.media.public_metricsexpansions=attachments.media_keys&media.fields=public_metricsObject
利用不可includes.media.public_metrics.view_countexpansions=attachments.media_keys&media.fields=public_metricsInt
利用不可includes.media.non_public_metricsexpansions=attachments.media_keys&media.fields=non_public_metricsObject
利用不可includes.media.non_public_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.non_public_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=non_public_metricsInt
利用不可includes.media.organic_metricsexpansions=attachments.media_keys&media.fields=organic_metricsObject
利用不可includes.media.organic_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.organic_metrics.view_countexpansions=attachments.media_keys&media.fields=organic_metricsInt
利用不可includes.media.promoted_metricsexpansions=attachments.media_keys&media.fields=promoted_metricsObject
利用不可includes.media.promoted_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt
利用不可includes.media.promoted_metrics.view_countexpansions=attachments.media_keys&media.fields=promoted_metricsInt

​
マッチングルールオブジェクト

Activity Streams 形式Twitter v2 形式必須の v2 パラメータv2 における型
gnip.matching_rulesmatching_rulesFiltered stream のデフォルトオブジェクトの配列
gnip.matching_rules.tagmatching_rules.tagFiltered stream のデフォルト文字列
gnip.matching_rules.tag.id利用不可利用不可
gnip.matching_rules.tag.id_strmatching_rules.idFiltered stream のデフォルト文字列

​
ビジュアルデータ形式移行ツール

ビジュアルデータ形式移行ツールは、指定した Tweet または ユーザーオブジェクトについて、X API v1.1 のデータ形式からX API v2 の形式への対応関係となる fields を表示するウェブアプリケーションです。Tweet の id または user の id を入力すると、このマッピングを確認できます。 アプリを利用するには、Twitter アカウントでのログインが必要です。
⌘I