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

​
はじめに

X API v2 のリリースに伴い、異なるオブジェクトやフィールドをリクエストするための新しいデータレスポンス形式とリクエスト方法を採用しました。これを便宜上「X API v2 フォーマット」と呼びます。  「一般的な違い」のセクションでは、standard ユーザーおよび enterprise ユーザーに関連するいくつかの変更点について学ぶことができます。あわせて、standard v1.1 の Native フォーマット、enterprise 向けの Native Enriched フォーマット、および enterprise 向けの Activity Streams フォーマット それぞれに特化したガイドも用意しており、フィールドの対応関係を示すとともに、新しい v2 フィールドをリクエストする際に使用する必要があるフィールドと expansions を説明しています。  X API v1.1 データフォーマット と X API v2 フォーマット の違いをすばやく確認するのに役立つ、ビジュアルデータフォーマット移行ツール もあわせてご利用いただけます。

​
全般的な違い

​
オブジェクトとフィールドのリクエスト

pre-v2 エンドポイントと v2 の最大の違いの 1 つは、新しいバージョンではデフォルトで返されるフィールドがごく一部に限られているのに対し、Standard、Premium、Enterprise エンドポイントではほとんどのフィールドがデフォルトで返される点です。新しいバージョンでは、fields と expansions というパラメータを使用して、デフォルト以外の追加データを明示的にリクエストします。これにより、不要なフィールドを取り込まずに、必要なデータだけをリクエストできるようになります。  リクエストしたフィールドがプライマリのデータオブジェクトに関連するものであれば、それらはデフォルト値とともに、そのプライマリデータオブジェクト内に返されます。一方で、expansions パラメータを使用して展開対象のオブジェクトをリクエストした場合、セカンダリオブジェクトは新しい includes オブジェクト内に返されます。includes オブジェクト内の展開されたオブジェクトは、両方に含まれる id フィールドを使用することでプライマリオブジェクトと対応付けることができます。 たとえば、v2 の Post lookup エンドポイントを使用し、リクエストに expansions=author_id パラメータを含めた場合、プライマリのポストオブジェクト内に author_id フィールドが返されると同時に、includes オブジェクト内にポストごとに 1 つの user オブジェクトが返されます。それぞれの user オブジェクトにはデフォルトの id フィールドが含まれており、このフィールドを使って user オブジェクトをポストオブジェクトと対応付けることができます。以下はその例です。 
{
  "data": [
    {
      "author_id": "2244994945",
      "id": "1397568983931392004",
      "text": "The Twitter Developer Platform. Ooh la la! https://t.co/iGTdPXBfOv https://t.co/Ze8z8EODdg"
    }
  ],
  "includes": {
    "users": [
      {
        "id": "2244994945",
        "name": "Twitter Dev",
        "username": "TwitterDev"
      }
    ]
  }
}

​
更新された JSON 設計

特定のフィールドのリクエスト方法の変更に加えて、X API v2 では API から返されるオブジェクト、たとえば Post や user オブジェクトに対しても、新しい JSON 設計を導入しています。
  • JSON のルートレベルでは、従来の標準エンドポイントは Post オブジェクトを statuses 配列で返しますが、X API v2 は data 配列で返します。 
  • Retweeted や Quoted の「statuses」を参照する代わりに、X API v2 の JSON では Retweeted および Quoted ツイートを参照します。contributors や user.translator_type など、多くのレガシーおよび非推奨フィールドは削除されます。 
  • Post オブジェクトの favorites と user オブジェクトの favourites の両方を使用する代わりに、X API v2 では like という用語を使用します。 
  • X では、値を持たない JSON 値 (たとえば null) はペイロードに含めないという規約を採用しています。Post および user の属性は、null ではない値を持つ場合にのみ含められます。   

​
新しい v2 フィールド

また、Post オブジェクト に対して、次のような新しいフィールド群も導入しました。
  • conversation_id フィールド
  • context と entities を含む、2 つの新しい annotations フィールド
  • いくつかの新しい metrics フィールド
  • 新しい reply_setting フィールド。特定のポストに誰が返信できるかを示すフィールドです

​
standard v1.1 のデータフォーマットから v2 への移行

まだお読みでない場合は、まず データフォーマットの移行 のイントロダクションに目を通すことをおすすめします。X API v1.1 のデータフォーマット と X API v2 のフォーマット の違いをすばやく確認するには、ビジュアルデータフォーマット移行ツール も参考になるかもしれません。 standard v1.1 データフォーマットはネイティブフォーマットとも呼ばれ、standard v1.1 エンドポイントで提供される主要なフォーマットです。 Premium 製品をご利用の場合は、ネイティブ拡張データフォーマットガイド を参照してください。Enterprise のお客様は、Gnip コンソールでの設定方法に応じて、ネイティブ拡張データまたは activity streams を使用している可能性があります。 

​
標準 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 パラメータについて説明します。  

​
ツイートオブジェクト

Twitter 1.1 formatTwitter v2 の形式必須の v2 パラメータ
created_atdata.created_attweet.fields=created_at
idN/A id は文字列です
id_strdata.iddefault
textdata.textdefault
full_textN/A text フィールドにはツイート本文全体が含まれます
truncatedN/A text フィールドにはツイート本文全体が含まれます
display_text_rangeN/A text フィールドにはツイート本文全体が含まれます
edit_historydata.edit_history_tweet_idsdefault
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_idN/A referenced_tweets.id は文字列です
in_reply_to_status_id_strdata.referenced_tweets.id (if type=replied_to)expansions=referenced_tweets.id
in_reply_to_user_idN/A 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_idN/A 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 のツイートオブジェクト

パラメーター付き 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”,
“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”,
“テキスト”:“どうぞ、別の子犬アカウントをフォローしてください。私たちは批判しません。\n\n新しい#TwitterAPIにフォロー管理エンドポイントを導入します。v2 APIを使用してアカウントのフォローとフォロー解除ができるようになりました。詳細はこちら https://t.co/mtpd9VIMDa”,
“lang”:“ja”,
“スレッド_id”:“1359554366051504129”,
“possibly_sensitive”: false,
“リプライ_設定”:“everyone”,
“作成日時_at”:“2021-02-10T17:26:34.000Z”,
“著者_id”:“2244994945”,
“public_メトリック”:{
“リツイート_count”: 18,
“リプライ_count”: 11,
“like_count”: 98,
“引用ツイート_count”: 7
},
“entities”:{
“hashtags”: [{
“start”: 110,
“end”: 121,
“tag”:“TwitterAPI”
}],
“urls”: [{
“start”: 194,
“end”: 217,
“url”:“https://t.co/mtpd9VIMDa”,
“展開後_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の新しいフォロー管理エンドポイントのご紹介”,
“説明”:“フォローする、しない?X API v2を使えば、この質問に自由に答えることができます。本日、新しいTwitter APIに新しいフォロー管理エンドポイントをリリースすることを発表いたします。約1か月前にフォロー検索エンドポイントをリリースした際に予告したとおり、フォロー関係を管理する機能がついに登場しました。これらはv1.1 APIで最も人気のあるエンドポイントの一部であり、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”:“ブランドカテゴリー”,
“説明”:“ブランドバーティカル内でブランドの範囲を絞り込むカテゴリ”
},
“entity”:{
“id”:“781974596752842752”,
“name”:“サービス”
}
},
{
“domain”:{
“id”:“47”,
“name”:“ブランド”,
“説明”:“ブランドおよび企業”
},
“entity”:{
“id”:“10045225402”,
“name”:“X”
}
}
]
}]
}

​
User オブジェクト

Twitter 1.1 の形式Twitter v2 の形式必須の v2 パラメーター
user_iddata.author_idtweet.fields=author_id
user.idN/A。includes.users.id を使用
user.id_strincludes.users.idexpansions=author_id
user.nameincludes.users.nameexpansions=author_id
user.screen_nameincludes.user.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
例
v1.1 の User オブジェクトv2 の User オブジェクトとリクエスト
”user”:{
“id”: 2244994945,
“id_str”:“2244994945”,
“name”:“Twitter Dev”,
“screen_name”:“TwitterDev”,
“location”:“127.0.0.1”,
“description”:“#TwitterDevチームの声であり、#TwitterAPIに関する最新情報、ニュース、イベントの公式情報源です。”,
“url”:“https://t.co/3ZX3TNiZCY”,
“entities”:{
“url”:{
“urls”: [{
“url”:“https://t.co/3ZX3TNiZCY”,
“展開_url”:“https://developer.x.com/ja/community”,
“display_url”:“developer.x.com/ja/community”,
“indices”: [
0,
23
]
}]
},
“description”:{
“urls”: []
}
},
“protected”: false,
“フォロワー_count”: 517232,
“friends_count”: 2032,
“リストに登録された_count”: 1722,
“作成日時_at”:“Sat Dec 14 04:35:55 +0000 2013”,
“favourites_count”: 2134,
“utc_offset”: null,
“タイムゾーン_タイムゾーン”: null,
“geo_有効”: true,
“認証済み”: true,
“ステータス数_count”: 3677,
“lang”: null,
“コントリビューター_有効”: false,
“です_translator”: false,
“です_translation_有効”: false,
“profile_背景_color”:“FFFFFF”,
“profile_背景_image_url”:“http://abs.twimg.com/images/themes/theme1/bg.png”,
“profile_背景_画像_url_https”:“https://abs.twimg.com/images/themes/theme1/bg.png”,
“profile_背景_タイル”: 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_リンク_color”:“0084B4”,
“profile_サイドバー_ボーダー_color”:“FFFFFF”,
“profile_サイドバー_fill_color”:“DDEEF6”,
“profile_text_color”:“333333”,
“profile_使用_背景_image”: false,
“has_extended_profile”: true,
“default_profile”: false,
“default_profile_画像”: false,
“following”: null,
“follow_リクエスト_送信済み”: null,
“notifications”: null,
“translator_type”:“regular”
}		{
“data”: [{
“author_id”: “2244994945”,
“id”: “1362876655061073928”,
“text”: “私たちのリビングルームから皆さんのリビングルームへ 🐱‍💻🛋️ 新しい #TwitterAPI を使い始めるのに役立つ、デベロッパーアドボケートによるエキサイティングな Twitch 配信やオンラインイベントをいくつか予定しています。詳しくはスケジュールをご確認のうえ、もっと見たいという方はぜひお知らせください！\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”: “#TwitterDev チームの声であり、#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=entitiesオブジェクトの配列
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=entitiesオブジェクトの配列
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=entitiesオブジェクトの配列
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=entitiesオブジェクトの配列
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_keysオブジェクトの配列
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=attachmentsオブジェクトの配列
extended_entities.mediaincludes.mediaexpansions=attachments.media_keysオブジェクトの配列
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 の entities、attachments、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”: [],
“ユーザー_mentions”: [{
“screen_name”:“TwitterDev”,
“name”:“Twitter Dev”,
“id”: 2244994945,
“id_str”:“2244994945”,
“indices”: [
31,
42
]
}],
“urls”: [{
“url”:“https://t.co/XVLZ3uwikc”,
“展開_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”,
“展開_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”,
“展開_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”:{
“アスペクト比_アスペクト比”: [
9,
16
],
“duration_ミリ秒”: 5140,
“variants”: [{
“ビットレート”: 950000,
“content_type”:“video/mp4”,
“url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12”
},
{
“ビットレート”: 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”
},
{
“ビットレート”: 632000,
“content_type”:“video/mp4”,
“url”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12”
}
]
},
“追加の_media_info”:{
“収益化可能”: false
}
}]
}		{
“data”: [{
“entities”:{
“hashtags”: [{
“start”: 8,
“end”: 13,
“タグ”:“test”
}],
“mentions”: [{
“start”: 31,
“end”: 42,
“username”:“TwitterDev”
}],
“urls”: [{
“start”: 91,
“end”: 114,
“url”:“https://t.co/XVLZ3uwikc”,
“展開_url”:“https://developer.x.com/en”,
“display_url”:“developer.x.com/ja”,
“status”: 200,
“title”:“ユースケース、チュートリアル、&ドキュメント”,
“説明”:“投稿&ツイートを分析し、広告を最適化し、&Twitter API、Twitter Ads APIを使用して独自の顧客体験を創出し、&Twitter for Websites。‘s start building.”,
“unwound_url”:“https://developer.x.com/en”
},
{
“start”: 115,
“end”: 138,
“url”:“https://t.co/dz4oByygWA”,
“展開_url”:“https://x.com/furiouscamper/status/1370161532013735937/video/1”,
“display_url”:“pic.x.com/dz4oByygWA”
}
]
},
“id”:“1370161532013735937”,
“text”:“動画と@TwitterDevメンションを含む別の#test。新しいフォーマットの移行ドキュメントが楽しみです! https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”,
“添付ファイル”:{
“media_keys”: [
“7_1370161464028196868”
]
}
}],
“includes”:{
“media”: [{
“type”:“video”,
“height”: 1280,
“public_メトリック”:{
“閲覧_件数”: 37
},
“width”: 720,
“media_key”:“7_1370161464028196868”,
“duration_ms”: 5140,
“プレビュー_image_url”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”
}],
“users”: [{
“public_メトリック”:{
“フォロワー数_count”: 517233,
“following_count”: 2034,
“ツイート_件数”: 3677,
“リスト登録数_count”: 1727
},
“作成日時_at”:“2013-12-14T04:35:55.000Z”,
“profile_画像_url”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”,
“説明”:“#TwitterDevチームの声であり、#TwitterAPIに関するアップデート、ニュース、イベントの公式情報源です。”,
“認証済み”: true,
“id”:“2244994945”,
“username”:“TwitterDev”,
“protected”: false,
“entities”:{
“url”:{
“urls”: [{
“start”: 0,
“end”: 23,
“url”:“https://t.co/3ZX3TNiZCY”,
“展開_url”:“https://developer.x.com/en/community”,
“display_url”:“developer.x.com/ja/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 データ形式は、当社のエンタープライズ製品で使用されています。 Native Enriched データ形式は、編集済みツイートのメタデータを提供できるように更新されています。編集ツイートのメタデータの詳細については、Edit Tweets の基本ページを参照してください。 標準の v1.1 エンドポイントを使用している場合は、standard v1.1 から v2 へのガイドを参照してください。Activity Streams を使用するエンタープライズ製品をご利用の場合は、Activity Streams から v2 への移行ガイドも用意しています。 X API v2 では、ツイートオブジェクトとユーザーオブジェクトに対して新しい JSON 設計を導入しています。
  • JSON のルートレベルでは、Native Enriched 形式は results 配列でツイートオブジェクトを返しますが、X API v2 は data 配列を返します。
  • ツイートオブジェクト内の favorites とユーザーオブジェクト内の favourites の両方を使用する代わりに、X API v2 では like という用語を使用します。
  • X では、値を持たない JSON 値 (たとえば null) はペイロードに書き込まないという規約を採用しています。ツイートおよびユーザーの属性は、null 以外の値を持つ場合にのみ含まれます。
  • v2 のすべての id フィールドは文字列形式になります  
新しい JSON 形式に加え、ツイートオブジェクトに対して新しい一連のフィールドも導入しており、以下が含まれます。
  • conversation_id
  • reply_settings
  • メディアの alt_text
  • context と entities を含む 2 つの新しいアノテーションフィールド
  • 複数の新しいメトリクスフィールド
  • 複数の新しい投票フィールド  
多くのレガシーおよび非推奨フィールドは削除されます。
  • 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”
}]
}
フィールドと 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 の type
created_atdata.created_attweet.fields=created_at文字列
id該当なし (id を参照)
id_strdata.idデフォルト文字列
textdata.textデフォルト文字列
edit_historydata.edit_history_tweet_idsデフォルト配列
edit_controlsdata.edit_controlstweet.fields=edit_controlsオブジェクト
editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controlsブール値
display_text_range該当なし (text には常に完全なテキストが含まれます)
sourcedata.sourcetweet.fields=source文字列
truncated該当なし (text には常に完全なテキストが含まれます)
利用不可data.conversation_idtweet.fields=conversation_id文字列
利用不可data.reply_settingstweet.fields=reply_settings文字列
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_str を参照
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オブジェクト
user.id_strdata.author_idtweet.fields=author_id文字列
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_tweets文字列
extended_tweet.full_text該当なし (テキスト全体が本文です)
利用不可data.public_metricstweet.fields=public_metricsオブジェクト
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_metricsオブジェクト
利用不可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_metricsオブジェクト
利用不可data.organic_metrics.like_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.retweet_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.reply_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.impression_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.url_link_counttweet.fields=organic_metrics整数
利用不可data.organic_metrics.user_profile_counttweet.fields=organic_metrics整数
利用不可data.promoted_metricstweet.fields=promoted_metricsオブジェクト
利用不可data.promoted_metrics.like_counttweet.fields=promoted_metrics整数
利用不可data.promoted_metrics.retweet_counttweet.fields=promoted_metrics整数
利用不可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=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オブジェクトの配列
entities.annotationstweet.fields=entities,context_annotationsオブジェクト
entities.annotations.contextdata.context_annotationstweet.fields=entities,context_annotationsオブジェクトの配列
該当なしdata.context_annotations.domaintweet.fields=context_annotationsオブジェクト
entities.annotations.context.context_domain_id_strdata.context_annotations.domain.idtweet.fields=context_annotations文字列
entities.annotations.context.context_domain_id利用不可利用不可 - 文字列形式については data.context_annotations.domain.id を参照してください
entities.annotations.context.context_domain_namedata.context_annotations.domain.nametweet.fields=context_annotations文字列
entities.annotations.context.context_domain_descriptiondata.context_annotations.domain.descriptiontweet.fields=context_annotations文字列
該当なしdata.context_annotations.entitytweet.fields=context_annotationsオブジェクト
entities.annotations.context.context_entity_id_strdata.context_annotations.entity.idtweet.fields=context_annotations文字列
entities.annotations.context.context_entity_id利用不可利用不可 - 文字列形式については data.context_annotations.entity.id を参照してください
entities.annotations.context.context_entity_namedata.context_annotations.entity.nametweet.fields=context_annotations文字列
entities.annotations.context.context_entity_descriptiondata.context_annotations.entity.descriptiontweet.fields=context_annotations文字列
entities.annotations.entitydata.entities.annotationstweet.fields=entities,context_annotationsオブジェクトの配列
extended_entitiesdata.attachmentstweet.fields=attachmentsオブジェクト
favorited利用不可利用不可
retweeted利用不可利用不可
retweeted_status
possibly_sensitivedata.possibly_sensitivetweet.fields=possibly_sensitive真偽値
langdata.langtweet.fields=lang文字列
filter_level利用不可利用不可
scopes利用不可利用不可
timestamp_ms利用不可利用不可
withhelddata.withheldtweet.fields=withheldオブジェクトの配列
matching_rulesmatching_rulesオブジェクトの配列
matching_rules.id使用不可使用不可
matching_rules.id_strmatching_rules.idフィルタ済みストリームのデフォルト文字列
matching_rules.tagmatching_rules.tagフィルタ済みストリームのデフォルト文字列

​
User オブジェクト

Native Enriched データ形式Twitter v2 形式v2 で必須のパラメータv2 の type
userincludes.usersexpansions=author_idオブジェクトの配列
user.id利用不可該当なし (includes.users.id を参照)文字列
user.id_strincludes.users.idexpansions=author_id文字列
user.nameincludes.users.nameexpansions=author_id文字列
user.screen_nameincludes.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_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_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利用できません利用できません (ツイートの言語から推定)
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=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=entities整数
利用不可includes.users.entities.url.urls.endexpansions=author_id&user.fields=entities整数
利用不可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=entities整数
該当なしincludes.users.entities.descriptions.hashtags.endexpansions=author_id&user.fields=entities整数
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=entities整数
該当なしincludes.users.entities.descriptions.mentions.endexpansions=author_id&user.fields=entities整数
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=entities整数
利用不可includes.users.entities.descriptions.cashtags.endexpansions=author_id&user.fields=entities整数
user.description に含まれる値includes.users.entities.descriptions.cashtags.tagexpansions=author_id&user.fields=entities文字列

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

Native Enriched 形式Twitter v2 フォーマットv2 で必須のパラメーターv2 における type
entitiesdata.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=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=entitiesオブジェクトの配列
該当なし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=entitiesオブジェクトの配列
entities.user_mentions.indicies[0]data.entities.mentions.starttweet.fields=entities整数
entities.user_mentions.indicies[1]data.entities.mentions.endtweet.fields=entities整数
entities.user_mentions.screen_namedata.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 OR extended_entities.mediaincludes.mediaexpansions=attachments.media_keysオブジェクトの配列
entities.media.id_str OR extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keys文字列
entities.media.id OR extended_entities.media.id利用できません (id は文字列です)
entities.media.type OR extended_entities.media.typeincludes.media.media.typeexpansions=attachments.media_keys文字列
entities.media.indices OR extended_entities.media.indices利用不可利用不可
利用不可includes.media.alt_textexpansions=attachments.media_keys&media.fields=alt_text文字列
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_url該当なし (includes.media.url を参照)文字列
entities.media.media_url_https OR extended_entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_keys&media.fields=url文字列
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_url文字列
extended_entitiesdata.attachmentstweet_fields=attachmentsオブジェクト
extended_entitiesdata.attachments.media_keystweet.fields=attachmentsオブジェクトの配列
利用不可data.attachments.poll_idstweet.fields=attachmentsオブジェクトの配列
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_url文字列
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_metricsオブジェクト
該当なしincludes.media.promoted_metric.playback_0_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
該当なしincludes.media.promoted_metric.playback_25_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
該当なしincludes.media.promoted_metric.playback_50_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
該当なしincludes.media.promoted_metric.playback_75_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
該当なしincludes.media.promoted_metric.playback_100_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
該当なしincludes.media.promoted_metrics.view_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数

​
Place オブジェクト

Native 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オブジェクト

​
投票オブジェクト

ネイティブ Enriched 形式Twitter v2 形式必須の v2 パラメーターv2 における型
entities.pollsincludes.pollsexpansions=attachments.poll_idsオブジェクトの配列
なしincludes.polls.idexpansions=attachments.poll_idsString
entities.poll.optionsincludes.polls.optionsexpansions=attachments.poll_idsオブジェクトの配列
entities.polls.options.positionincludes.polls.options.positionexpansions=attachments.poll_idsInt
entities.polls.options.textincludes.polls.options.labelexpansions=attachments.poll_idsString
なしincludes.polls.options.votesexpansions=attachments.poll_idsInt
なしincludes.polls.voting_statusexpansions=attachments.poll_ids&poll.fields=voting_statusString
entities.polls.duration_minutesincludes.polls.duration_minutesexpansions=attachments.poll_ids&poll.fields=duration_minutesInt
entities.polls.end_datetimeincludes.polls.end_datetimeexpansions=attachments.poll_ids&poll.fields=end_datetime日付 (ISO 8601)

​
Activity Streams データフォーマットから v2 への移行

Activity Streams データフォーマットは、弊社の エンタープライズ製品で利用可能です。 Activity Streams データフォーマットは、編集されたツイートのメタデータを提供できるように更新されました。ツイート編集のメタデータの詳細については、Edit Tweets の基本ページを参照してください。 標準の v1.1 エンドポイントを使用している場合は、standard v1.1 から v2 へのガイドを参照してください。Premium エンドポイントやエンタープライズ向けの Native Enriched フォーマットを使用している場合は、Native Enriched から v2 へのガイドを参照してください。 X API v2 では、ポストおよびユーザーオブジェクトに対して新しい JSON 設計が導入されています。
  • JSON のルートレベルでは、Activity Streams フォーマットは results 配列内にツイートオブジェクトを返しますが、X API v2 は data 配列を返します。 
  • リツイートおよび引用の「activities」を参照する代わりに、X API v2 の JSON ではリツイートおよび引用ツイートを参照します。 
  • ツイートオブジェクト内の favorites とユーザーオブジェクト内の favourites を両方使用する代わりに、X API v2 では like という用語を使用します。 
  • Twitter では、値を持たない JSON 値 (たとえば null) はペイロードに書き出さないという規約を採用しています。ツイートおよびユーザー属性は、null 以外の値を持っている場合にのみ含まれます。 
  • v2 のすべての id フィールドは文字列形式になります。  
新しい JSON フォーマットへの変更に加えて、ツイートオブジェクトには次のような新しいフィールドセットも導入されています。
  • conversation_id
  • reply_settings
  • メディア上の alt_text
  • context と entities を含む 2 つの新しい annotations フィールド
  • 複数の新しい metrics フィールド
  • 複数の新しい polls フィールド  
多くのレガシーおよび非推奨フィールドは削除または置き換えられます。
  • 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

​
ツイートオブジェクト

Activity Streams フォーマットTwitter v2 形式必須の v2 パラメータv2 における type
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.objectType該当なし該当なし
provider.displayName該当なし該当なし
provider.link該当なし該当なし
リンク該当なし該当なし
display_text_range該当なし該当なし
オブジェクト該当なし該当なし
object.objectType該当なし該当なし
object.id該当なし該当なし
object.summarydata.text既定値String
object.edit_historydata.edit_history_tweet_ids既定値Array
object.edit_controlsdata.edit_controlstweet.fields=edit_controlsObject
object.editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controlsブール値
object.link利用不可利用不可
object.postedTimedata.created_attweet.fields=created_at日付 (ISO 8601)
actor.id から導出data.author_idtweet.fields=author_id
twitter_filter_level利用不可利用不可
inReplyTo.link 内のユーザー名から導出data.in_reply_to_user_idtweet.fields=in_reply_to_user_id文字列
利用不可data.referenced_tweetstweet.fields=referenced_tweetsオブジェクトの配列
利用不可data.referenced_tweets.typetweet.fields=referenced_tweets文字列
inReplyTo.link から導出data.referenced_tweets.idtweet.fields=referenced_tweets文字列
利用不可data.attachmentstweet.fields=attachmentsオブジェクト
twitter_entities.media.id_str から導出data.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=entitiesInt
該当なしdata.entities.annotations.endtweet.fields=entitiesInt
該当なしdata.entities.annotations.probabilitytweet.fields=entitiesFloat
該当なしdata.entities.annotations.typetweet.fields=entitiesString
該当なしdata.entities.annotations.normalized_texttweet.fields=entitiesString
twitter_entities.urlsdata.entities.urlstweet.fields=entitiesオブジェクトの配列
twitter_entities.urls.indices[0]data.entities.urls.starttweet.fields=entitiesInt
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整数 (Int)
twitter_entities.user_mentions.indices[1]data.entities.mentions.endtweet.fields=entities整数 (Int)
twitter_entities.user_mentions.screen_namedata.entities.mentions.tagtweet.fields=entities文字列 (String)
twitter_entities.user_mentions.id_strdata.entities.mentions.idtweet.fields=entities文字列 (String)
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文字列 (String)
利用不可data.context_annotations.domain.nametweet.fields=context_annotations文字列 (String)
利用不可data.context_annotations.domain.descriptiontweet.fields=context_annotationsString
利用不可data.context_annotations.entitytweet.fields=context_annotationsObject
利用不可data.context_annotations.entity.idtweet.fields=context_annotationsString
利用不可data.context_annotations.entity.nametweet.fields=context_annotationsString
利用不可data.context_annotations.entity.descriptiontweet.fields=context_annotationsString
geodata.geotweet.fields=geoObject
location.link から導出される値data.geo.place_idtweet.fields=geoString
利用不可data.public_metricstweet.fields=public_metricsObject
favoritesCountdata.public_metrics.like_counttweet.fields=public_metricsInt
retweetCountdata.public_metrics.retweet_counttweet.fields=public_metricsInt
利用不可data.public_metrics.quote_counttweet.fields=public_metricsInt
該当なしdata.public_metrics.reply_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
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 における type
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使用不可使用不可 - Tweet の created_at から推定
actor.utcOffset使用不可利用不可 (ツイートの created_at から推定)
actor.favoritesCount利用不可利用不可
actor.followersCountincludes.users.public_metrics.followers_countexpansions=author_id&user.fields=public_metricsInt
actor.friendsCountincludes.users.public_metrics.following_countexpansions=author_id&user.fields=public_metricsInt
actor.listedCountincludes.users.public_metrics.listed_countexpansions=author_id&user.fields=public_metricsInt
actor.statusesCountincludes.users.public_metrics.tweet_countexpansions=author_id&user.fields=public_metricsInt
actor.languages[]利用不可利用不可 (ツイートの lang から推定)
actor.location.displayNameincludes.users.locationexpansions=author_id&user.fields=locationString
actor.imageincludes.users.profile_image_urlexpansions=author_id&user.fields=profile_image_urlString
actor.linksincludes.users.urlexpansions=author_id&user.fields=urlString
actor.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verifiedBoolean
利用不可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=entitiesString
該当なしincludes.users.entities.description.mentionsexpansions=author_id&user.fields=entitiesオブジェクトの配列
該当なしincludes.users.entities.description.mentions.startexpansions=author_id&user.fields=entitiesInt
該当なしincludes.users.entities.description.mentions.endexpansions=author_id&user.fields=entitiesInt
該当なしincludes.users.entities.description.mentions.usernameexpansions=author_id&user.fields=entitiesString
該当なしincludes.users.entities.description.cashtagsexpansions=author_id&user.fields=entitiesオブジェクトの配列
該当なしincludes.users.entities.description.cashtags.startexpansions=author_id&user.fields=entitiesInt
該当なしincludes.users.entities.description.cashtags.endexpansions=author_id&user.fields=entitiesInt
利用不可includes.users.entities.description.cashtags.tagexpansions=author_id&user.fields=entitiesString

​
Poll オブジェクト

Activity Streams フォーマットTwitter v2 フォーマット必要な v2 パラメータv2 の型
利用不可includes.pollsexpansions=attachments.poll_idsオブジェクトの配列
利用不可includes.polls.idexpansions=attachments.poll_idsString
利用不可includes.polls.optionsexpansions=attachments.poll_idsオブジェクトの配列
利用不可includes.polls.options.positionexpansions=attachments.poll_idsInt
利用不可includes.polls.options.labelexpansions=attachments.poll_idsString
利用不可includes.polls.options.votesexpansions=attachments.poll_idsInt
利用不可includes.polls.voting_statusexpansions=attachments.poll_ids&poll.fields=voting_statusString
利用不可includes.polls.duration_minutesexpansions=attachments.poll_ids&poll.fields=duration_minutesInt
利用不可includes.polls.end_datetimeexpansions=attachments.poll_ids&poll.fields=end_datetime日付 (ISO 8601)

​
Place オブジェクト

Activity Streams 形式Twitter v2 形式必須の v2 パラメーターv2 における型
locationincludes.placesexpansions=geo.place_idオブジェクトの配列
location.displayNameincludes.places.full_nameexpansions=geo.place_idstring
Parsed from location.linkincludes.places.idexpansions=geo.place_idstring
location.nameincludes.places.nameexpansions=geo.place_id&place.fields=namestring
location.country_codeincludes.places.countryexpansions=geo.place_id&place.fields=countrystring
location.twitter_place_typeincludes.places.place_typeexpansions=geo.place_id&place.fields=place_typestring
location.twitter_country_codeincludes.places.country_codeexpansions=geo.place_id&place.fields=country_codestring
location.geoincludes.places.geoexpansions=geo.place_id&place.fields=geoobject
location.geo.typeincludes.places.geo.typeexpansions=geo.place_id&place.fields=geostring
location.geo.coordinatesincludes.places.geo.bboxexpansions=geo.place_id&place.fields=geoarray
利用不可includes.places.geo.propertiesexpansions=geo.place_id&place.fields=geoobject

​
メディアオブジェクト

Activity Streams データ形式Twitter API v2 フォーマットv2 の必須パラメータv2 での type
twitter_entities.media OR twitter_extended_entities.mediaincludes.mediaexpansions=attachments.media_keysオブジェクトの配列
twitter_entities.media.id_str OR twitter_extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keys文字列
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_url文字列
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_keys文字列
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_text文字列
利用不可includes.media.public_metricsexpansions=attachments.media_keys&media.fields=public_metricsオブジェクト
利用不可includes.media.public_metrics.view_countexpansions=attachments.media_keys&media.fields=public_metrics整数
利用不可includes.media.non_public_metricsexpansions=attachments.media_keys&media.fields=non_public_metricsオブジェクト
利用不可includes.media.non_public_metrics.playback_0_countexpansions=attachments.media_keys&media.fields=non_public_metrics整数
利用不可includes.media.non_public_metrics.playback_25_countexpansions=attachments.media_keys&media.fields=non_public_metrics整数
利用不可includes.media.non_public_metrics.playback_50_countexpansions=attachments.media_keys&media.fields=non_public_metrics整数
利用不可includes.media.non_public_metrics.playback_75_countexpansions=attachments.media_keys&media.fields=non_public_metrics整数
利用不可includes.media.non_public_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=non_public_metrics整数
利用不可includes.media.organic_metricsexpansions=attachments.media_keys&media.fields=organic_metricsオブジェクト
なし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_metrics整数
利用できませんincludes.media.promoted_metrics.playback_100_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数
利用できませんincludes.media.promoted_metrics.view_countexpansions=attachments.media_keys&media.fields=promoted_metrics整数

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

Activity Streams 形式Twitter v2 形式必須の v2 パラメータv2 における type
gnip.matching_rulesmatching_rulesフィルター済みストリームのデフォルト値オブジェクトの配列
gnip.matching_rules.tagmatching_rules.tagフィルター済みストリームのデフォルト値文字列
gnip.matching_rules.tag.id利用不可利用不可
gnip.matching_rules.tag.id_strmatching_rules.idフィルター済みストリームのデフォルト値文字列

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

ビジュアルデータ形式移行ツールは、指定したツイートまたはユーザーオブジェクトについて、X API v1.1 のデータ形式のフィールドが X API v2 形式のどのフィールドに対応するかを表示する Web アプリケーションです。ツールでこのマッピングを確認するには、ツイート ID またはユーザー ID のいずれかを入力します。 このアプリを利用するには、Twitter アカウントでログインする必要があります。