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

​
はじめに

X API v2 の提供開始に伴い、新しいデータレスポンス形式と、さまざまなオブジェクトや fields をリクエストする方法を採用しました。これを「X API v2 形式」と呼びます。  「全般的な相違点」のセクションでは、Standard とエンタープライズのユーザーに関連する変更点を確認できます。あわせて、standard v1.1 の Native 形式、エンタープライズ向けの Native Enriched 形式、およびエンタープライズ向けの Activity Streams 形式に特化したガイドも用意しており、fields のマッピングや、新しい v2 の fields をリクエストする際に使用すべき fields と expansions を説明しています。  また、X API v1.1 のデータ形式と X API v2 形式の違いを素早く確認できるビジュアルデータ形式移行ツールもご活用いただけます。

​
全般的な相違点

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

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

​
更新された JSON 設計

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

​
新しい v2 の fields

また、Post オブジェクト に、次の項目を含む新しい fields のセットを導入しました。
  • conversation_id フィールド
  • context と entities を含む 2 つの新しい annotations fields
  • 複数の新しい metrics fields
  • 特定の Post に誰が返信できるかを示す新しい reply_setting フィールド

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

まだであれば、まずはデータ形式の移行の紹介をご一読いただくことをおすすめします。あわせて、ビジュアルデータ形式移行ツールを使うと、X API v1.1 のデータ形式とX API v2 の形式の違いをすばやく確認できます。 標準 v1.1 のデータ形式（ネイティブ形式とも呼ばれます）は、standard v1.1 のエンドポイントで提供される主要な形式です。 プレミアム製品をご利用の場合は、ネイティブ拡張ガイドをご参照ください。エンタープライズのお客様は、Gnip コンソールでの設定に応じて、ネイティブ拡張またはアクティビティストリームを利用している場合があります。 

​
標準 v1.1 と v2 のペイロード構造の比較

以下の表は、v1.1 の形式と比較して、v2 で受け取れる想定の高レベルなオブジェクトおよびフォーマットを示します。
v1.1 の構造v2 の構造
デフォルト{
all tweet object fields,
“entities”: {
“hashtags”: [],
“symbols”: [],
“user_mentions”: [],
“urls”: [],
“media”: []
},
“extended_entities”: ,
“user”: ,
“place”: ,
“retweeted_status/quoted_status”
}		{
“data”: [{
“id”,
“text”,

“edit_history_tweet_ids”
}]
}
fields と expansions パラメータを指定した場合{
“data”: [{
tweet object fields,
“entities”: {
“hashtags”: [],
“cashtags”: [],
“mentions”: [],
“urls”: [],
},
“attachments”: {

“media_keys”: [],

“poll_ids”: []

}
}],
“includes”: [
“tweets”: [tweet objects],
“users”: [user objects],
“media”: [media objects],
“places”: [place object],

“polls”: [poll object]
],

“matching_rules”: []
}
フィールドのマッピング 以下のセクションでは、どの v1.1 のフィールドが v2 のフィールドに対応するか、また新しいフィールドを受け取るために必要な v2 パラメータについて説明します。  

​
Tweet オブジェクト

Twitter 1.1 形式Twitter v2 形式必須の v2 パラメータ
created_atdata.created_attweet.fields=created_at
id該当なし（id は文字列）
id_strdata.id既定
textdata.text既定
full_text該当なし（text に完全なテキストが含まれる）
truncated該当なし（text に完全なテキストが含まれる）
display_text_range該当なし（text に完全なテキストが含まれる）
edit_historydata.edit_history_tweet_ids既定
edit_controlsdata.edit_controlstweet.fields=edit_controls
editabledata.edit_controls.is_edit_eligibletweet.fields=edit_controls
entitiesdata.entitiestweet.fields=entities
entities.user_mentionsdata.entities.mentionstweet.fields=entities
entities.symbolsdata.entities.cashtagstweet.fields=entities
entities.hashtagsdata.entities.hashtagstweet.fields=entities
entities.urlsdata.entities.urlstweet.fields=entities
entities.mediaincludes.mediaexpansions=attachments.media_keys
extended_entitiesdata.attachmentstweet_fields=attachments
in_reply_to_status_id該当なし（referenced_tweets.id は文字列）
in_reply_to_status_id_strdata.referenced_tweets.id (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 (type=retweeted の場合)expansions=referenced_tweets.id
is_quoted_status提供なし
quoted_status_id該当なし（referenced_tweets.id は文字列）
quoted_status_id_strdata.referenced_tweets.id (type=quoted の場合)expansions=referenced_tweets.id
quoted_status_permalink提供なし
quoted_statusdata.referenced_tweets (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
{
“作成済み_で”:“水 2月 10 17:26:34 +0000 2021”,
“id”: 1359554366051504129,
“id_str”:“1359554366051504129”,
“テキスト”：“さあ、子犬アカウントをもう1つフォローしよう。誰も責めたりしません。 \n\n新しい…向けの「フォロー管理」エンドポイントを紹介します https://t.co/3cBZKZUevF”、
“切り詰め”: true,
“エンティティ”：{
“ハッシュタグ”: [],
“記号”: [],
“ユーザー_メンション”: [],
“URL”: [{
“URL”:“https://t.co/3cBZKZUevF”、
“拡張_URL”:“https://twitter.com/i/web/status/1359554366051504129”、
“ディスプレイ_URL”:“twitter.com/i/web/status/1…”,
“インデックス”: [
111、
134
]
}]
}、

“内で_返信_宛て_ステータス_id”: null,
“内で_返信_宛て_ステータス_id_str”: null,
“内_返信_宛て_ユーザー_id”: null,
“内で_返信_宛先_ユーザー_id_str”: null,
“内で_返信_to_スクリーン_名前”: null,
“ユーザー”：{
…
}、
“ジオ”: null,
“座標”: null,
“場所”: null,
“コントリビューター”: null,
“である_引用符_ステータス”: false,
“リツイート_件数”: 18,
“お気に入り_件数”: 98,
“いいね済み”: false,
“リポスト済み”: false,
“場合によっては_機微”: false,
“おそらく_センシティブ_不服申立て可能”: false,
“言語”:“英語（en）”
}		{
“data”: [{
“id”:“1359554366051504129”、
“テキスト”：“さあ、子犬アカウントをもうひとつフォローしましょう。私たちは責めたりしません。\n\n新しい #TwitterAPI に「フォロー管理」エンドポイントが追加されました。これで v2 API を使ってアカウントのフォローやフォロー解除が行えます。詳しくはこちらhttps://t.co/mtpd9VIMDa”、
“言語”:“英語（en）”、
“会話_id”:“1359554366051504129”、
“場合によっては_機微”: false,
“返信_設定”:“すべての方”、
“作成済み_で”:“2021-02-10T17:26:34.000Z”、
“作成者_id”:“2244994945”、
“public（パブリック）_指標”:{
“リツイート_件数”: 18,
“返信_件数”: 11,
“いいね_カウント”: 98,
“引用文_カウント”: 7
}、
“エンティティ”:{
“ハッシュタグ”: [{
“開始”: 110,
“終了”: 121,
“タグ”:“Twitter API”
}],
“URL”: [{
“開始”: 194,
“終了”: 217,
“URL”:“https://t.co/mtpd9VIMDa”、
“拡張_URL”:“https://devcommunity.x.com/t/Twitter-API-v2-に新しい-manage-follows-エンドポイントを導入/149465”、
“ディスプレイ_URL”:“devcommunity.com/t/introducing-…”,
“画像”: [{
“URL”:“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=orig”、
“幅”: 1200,
“高さ”: 630
}、
{
“URL”:“https://pbs.twimg.com/news_img/1359554367905427457/DczC72__?format=jpg&name=150x150”、
“幅”: 150,
“高さ”: 150
}
],
“ステータス”: 200,
“題名”:“X API v2 に新しいフォロー管理エンドポイントを導入”、
“概要”:“フォローするか、しないか？その問いには、X API v2 を使って自由に答えられるようになりました。本日、新しい Twitter API において、新たな manage follows エンドポイントのリリースを発表します。少し前に follows lookup エンドポイントを公開した際に予告したとおり、フォロー関係を管理する機能がついに利用可能になりました。これらは v1.1 API でも特に人気の高いエンドポイントであり、X API v2 で幅広いユースケースを解放できることを嬉しく思います。W…”、
“巻き戻し済み_URL”:“https://devcommunity.x.com/t/twitter-api-v2-に新たに追加された-manage-follows-エンドポイントの紹介/149465”
}]
},
“コンテキスト_アノテーション”: [{
“ドメイン”：{
“id”:“46”、
“名前”:“ブランドカテゴリー”、
“概要”:“ブランドのバーティカル内でブランドの対象範囲を絞り込むカテゴリ”
}、
“エンティティ”:{
“id”:“781974596752842752”,
“名前”:“サービス”
}
}、
{
“ドメイン”:{
“id”:“47”、
“名前”:“ブランド”、
“説明”：“ブランドと企業”
}、
“エンティティ”:{
“id”:“10045225402”、
“名前”:“X（旧Twitter）”
}
}
]
}]
}

​
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.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
例
v1.1 における User オブジェクトv2 におけるユーザーオブジェクトとリクエスト
”ユーザー”:{
“id”: 2244994945,
“id_str”:“2244994945”、
“名前”：“X（旧Twitter）開発者向け”、
“スクリーン_名前”:“TwitterDev”,
“場所”:“127.0.0.1”、
“説明”:“#TwitterDev チームの公式の声であり、#TwitterAPI に関するアップデート、ニュース、イベントの正規な情報源です。”,
“URL”:“https://t.co/3ZX3TNiZCY”,
“エンティティー”:{
“URL”:{
“URLs”: [{
“URL”:“https://t.co/3ZX3TNiZCY”、
“展開_URL”:“https://developer.x.com/en/community
https://developer.x.com/ja/community”、
“表示_URL”:“developer.x.com/en/community”、
“インデックス”: [
0、
23
]
}]
}、
“概要”:{
“URL”: []
}
},
“保護された”: false,
“フォロワー_count”: 517232,
“フォロー中_カウント数”: 2032,
“一覧表示_件数”: 1722,
“作成日時_で”:“土 12月 14 04:35:55 +0000 2013”、
“お気に入り_件数”: 2134,
“UTC_オフセット”: null,
“時間_ゾーン”: null,
“ジオ_有効化”: true,
“認証済み”: true,
“ステータス_件数”: 3677,
“言語”: null,
“共同編集者_有効化”: false,
“である_翻訳ツール”: false,
“です_翻訳_有効化”: false,
“プロフィール_背景_色”:“FFFFFF”,
“プロフィール_背景_画像_URL”:“http://abs.twimg.com/images/themes/theme1/bg.png”、
“プロフィール_概要_画像_URL_https”:“https://abs.twimg.com/images/themes/theme1/bg.png”、
“プロフィール_バックグラウンド_タイル”: false,
“プロフィール_画像_URL”:“http://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”、
“プロフィール_画像_URL_https”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”、
“プロフィール_バナー_URL”:“https://pbs.twimg.com/profile_banners/2244994945/1611792896”,
“プロフィール_リンク_色”:“0084B4”、
“プロフィール_サイドバー_境界線_カラー”:“FFFFFF”、
“プロフィール_サイドバー_入力_色”:“DDEEF6”、
“プロフィール_テキスト_色”:“333333”,
“プロフィール_使用_背景_イメージ”: false,
“ある_拡張版_プロフィール”: true,
“既定_プロフィール”: false,
“既定_プロフィール_画像”: false,
“フォロー中”: null,
“フォローする_リクエスト_送信済み”: null,
“通知”: null,
“翻訳ツール_型”:“標準”
}		{
“data”: [{
“作成者_id”:“2244994945”,
“id”:“1362876655061073928”、
“テキスト”:“私たちのリビングルームから皆さんのもとへ 🐱‍💻🛋️デベロッパー・アドボケイトが、新しい #TwitterAPI のスタートを後押しするワクワクするTwitch配信やオンラインイベントを予定しています。詳細はスケジュールをご確認ください。もっと見たい方はぜひお知らせください！\n👇\nhttps://t.co/cixDY9qkvH”
}],
“includes（拡張された関連リソース）”:{
“ユーザー”: [{
“公開_メトリクス”:{
“フォロワー_カウント”: 517233,
“フォロー中_件数”: 2034,
“ツイート_件数”: 3677,
“上場_件数”: 1727
}、
“ユーザー名”：“TwitterDev”,
“エンティティ”:{
“URL”：{
“URL”: [{
“開始”: 0,
“終了”: 23,
“URL”:“https://t.co/3ZX3TNiZCY”、
“拡張_URL”:“https://developer.x.com/en/community”,
“表示_URL”:“developer.x.com/ja/community”
}]
}、
“概要”:{
“ハッシュタグ”: [{
“開始”: 17,
“終了”: 28,
“タグ”:“TwitterDev”
}、
{
“開始する”: 105,
“終了”: 116,
“タグ”:“Twitter API”
}
]
}
},
“説明”:“#TwitterDev チームの公式な発信源であり、#TwitterAPI に関する最新情報・ニュース・イベントをお届けします。”、
“名前”:“X Dev”、
“認証済み”: true,
“場所”:“127.0.0.1”、
“id”:“2244994945”,
“保護対象”: false,
“URL”:“https://t.co/3ZX3TNiZCY”、
“プロフィール_画像_URL”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”、
“作成済み_にて”：“2013-12-14T04:35:55.000Z”
}]
}
}

​
Entities と expanded entities オブジェクト

Twitter 1.1 フォーマットTwitter v2 フォーマット必須の v2 パラメータv2 の型
entitiesdata.entitiestweet.fields=entitiesobject
entities.hashtagsdata.entities.hashtagstweet.fields=entitiesarray of objects
entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entitiesnumber
entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entitiesnumber
entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entitiesstring
entities.urlsdata.entities.urlstweet.fields=entitiesarray of objects
entities.urls.indices[0]data.entities.urls.starttweet.fields=entitiesnumber
entities.urls.indices[1]data.entities.urls.endtweet.fields=entitiesnumber
entities.urls.urldata.entities.urls.urltweet.fields=entitiesstring
entities.user_mentionsdata.entities.mentionstweet.fields=entitiesarray of objects
entities.user_mentions.indicies[0]data.entities.mentions.starttweet.fields=entitiesnumber
entities.user_mentions.indicies[1]data.entities.mentions.endtweet.fields=entitiesnumber
entities.user_mentions.screen_namedata.entities.mentions.usernametweet.fields=entitiesstring
entities.symbolsdata.entities.cashtagstweet.fields=entitiesarray of objects
entities.symbols.indices[0]data.entities.cashtags.starttweet.fields=entitiesnumber
entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entitiesnumber
entities.symbols.textdata.entities.cashtags.tagtweet.fields=entitiesstring
entities.mediaincludes.mediaexpansions=attachments.media_keysarray of objects
entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysstring
entities.media.typeincludes.media.media.typeexpansions=attachments.media_keysstring
entities.media.media_urlN/A（includes.media.url を使用）string
entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media.fields=url&attachments=media_keysstring
entities.media.url
entities.media.display_url
entities.media.expanded_url
entities.media.media_url_httpsincludes.media.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlstring
extended_entitiesdata.attachmentstweet.fields=attachmentsobject
extended_entitiesdata.attachments.media_keystweet.fields=attachmentsarray of objects
extended_entities.mediaincludes.mediaexpansions=attachments.media_keysarray of objects
extended_entities.media.id_strincludes.media.media_keyexpansions=attachments.media_keysstring
extended_entities.media.typeincludes.media.media.typeexpansions=attachments.media_keysstring
extended_entities.media.sizes.thumb.w利用不可
extended_entities.media.sizes.thumb.h利用不可
extended_entities.media.sizes.thumb.resize利用不可
extended_entities.media.sizes.large.wincludes.media.heightexpansions=attachments.media_keys&media.fields=height
extended_entities.media.sizes.large.hincludes.media.widthexpansions=attachments.media_keys&media.fields=width
extended_entities.media.sizes.large.resize利用不可
extended_entities.media.sizes.small.w利用不可
extended_entities.media.sizes.small.h利用不可
extended_entities.media.sizes.small.resize利用不可
extended_entities.media.sizes.medium.w利用不可
extended_entities.media.sizes.medium.h利用不可
extended_entities.media.sizes.medium.resize利用不可
extended_entities.media.media_url_httpsincludes.media.urlexpansions=attachments.media_keys&media.fields=urlstring
extended_entities.media.media_url_httpsincludes.media.preview_image_urlexpansions=attachments.media_keys&media.fields=preview_image_urlstring
extended_entities.media.video_info.duration_millisincludes.media.duration_msexpansions=attachments.media_keys&media.fields=duration_msnumber
例
v1.1 の entities と extended_entities（動画あり）v2 におけるエンティティ、アタッチメント、includes

https://api.x.com/2/tweets?ids=1370161532013735937&expansions=attachments.media_keys,entities.mentions.username&tweet.fields=entities&user.fields=created_at,description,entities,location,name,profile_image_url,protected,public_metrics,url,username,verified,withheld&media.fields=duration_ms,height,media_key,preview_image_url,public_metrics,type,url,width
”エンティティ”:{
“ハッシュタグ”: [{
“テキスト”:“テスト”、
“インデシス”: [
8、
13
]
}],
“シンボル”: [],
“ユーザー_メンション”: [{
“スクリーン_名前”:“TwitterDev”,
“氏名”:“X（旧Twitter）開発者向け”,
“id”: 2244994945,
“id_str”:“2244994945”,
“インデックス”: [
31、
42
]
}],
“URL”: [{
“URL”:“https://t.co/XVLZ3uwikc”、
“拡張_URL”:“https://developer.x.com/en”、
“表示_URL”:“developer.x.com/en”、
“インデックス”: [
91、
114
]
}],
“メディア”: [{
“id”: 1370161464028196868,
“id_str”:“1370161464028196868”,
“インデックス群”: [
115、
138
],
“メディア_url”:“http://pbs.twimg.com/ext_tw_動画_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”、
“メディア_URL_https”:“https://pbs.twimg.com/ext_tw_動画_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”,
“URL”:“https://t.co/dz4oByygWA”,
“ディスプレイ_URL”:“pic.x.com/dz4oByygWA”、
“展開_URL”:“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”、
“型”:“写真”、
“サイズ”:{
“親指”:{
“w”: 150,
“h”: 150,
“サイズ変更”:“トリミング”
},
“小さい”:{
“w”: 383,
“h”: 680,
“サイズを変更”:“フィット”
},
“大きい”:{
“w”: 720,
“h”: 1280,
“リサイズ”:“適合”
}、
“中程度”:{
“w”: 675,
“h”: 1200,
“サイズ変更”:“フィット”
}
}
}]
}、
“拡張版_エンティティ”:{
“メディア”: [{
“id”: 1370161464028196868,
“id_str”:“1370161464028196868”,
“インデックス”: [
115、
138
],
“メディア_URL”:“http://pbs.twimg.com/ext_tw_動画_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”、
“メディア_URL_https”:“https://pbs.twimg.com/ext_tw_動画_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”、
“URL”:“https://t.co/dz4oByygWA”,
“表示_URL”:“pic.x.com/dz4oByygWA”、
“拡張_URL”:“https://twitter.com/furiouscamper/status/1370161532013735937/video/1”,
“型”:“動画”、
“サイズ”:{
“サム”:{
“w”: 150,
“h”: 150,
“リサイズ”:“トリミング”
},
“小さい”:{
“w”: 383,
“h”: 680,
“サイズ変更”：“適合”
}、
“大きい”:{
“w”: 720,
“h”: 1280,
“サイズ変更”:“適合”
},
“中程度”:{
“w”: 675,
“h”: 1200,
“サイズ変更”:“適合”
}
},
“動画_情報”:{
“側面_比率”: [
9,
16
],
“継続時間_ミリ秒（ms）”: 5140,
“バリアント”: [{
“ビットレート”: 950000,
“コンテンツ_型”:“video/mp4”、
“URL”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/480x852/rAuFVMEqs0MeP4P4.mp4?tag=12”
},
{
“ビットレート”: 2176000,
“コンテンツ_型”:“video/mp4”,
“URL”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/720x1280/ZxVL5qYO-DNVuSyq.mp4?tag=12”
}、
{
“コンテンツ_型”:“application/x-mpegURL”、
“URL”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/pl/EGVpuZpo-wYxTNCq.m3u8?tag=12”
},
{
“ビットレート”: 632000,
“コンテンツ_型”:“video/mp4”、
“URL”:“https://video.twimg.com/ext_tw_video/1370161464028196868/pu/vid/320x568/M7VtocAwKPFdkqzF.mp4?tag=12”
}
]
}、
“追記事項_メディア_情報”:{
&収益化可能”: false
}
}]
}		{
“data”: [{
“エンティティ”:{
“ハッシュタグ”: [{
“開始”: 8,
“終了”: 13,
“タグ”:“テスト”
}],
“メンション”: [{
“開始”: 31,
“終了”: 42,
“ユーザー名”:“TwitterDev”
}],
“URL”: [{
“開始”: 91,
“終了”: 114,
“URL”:“https://t.co/XVLZ3uwikc”,
“拡張_URL”:“https://developer.x.com/en
https://developer.x.com/ja”、
“ディスプレイ_URL”:“developer.x.com/ja”、
“ステータス”: 200,
“タイトル”:“ユースケース、チュートリアル、&ドキュメンテーション”、
“概要”:“公開&Tweet を分析し、広告を最適化し、&Twitter API、Twitter Ads API を活用して、独自の顧客体験を創り出し、&Twitter for Websites。さあ、はじめましょう’さあ、開発を始めましょう。”,
“巻き戻し済み_URL”:“https://developer.x.com/en”
},
{
“開始”: 115,
“終了”: 138,
“URL”:“https://t.co/dz4oByygWA”,
“詳細表示_URL”:“https://x.com/furiouscamper/status/1370161532013735937/video/1”,
“ディスプレイ_url”:“pic.x.com/dz4oByygWA”
}
]
}、
“id”:“1370161532013735937”、
“テキスト”:“動画付きの別の #test。@TwitterDev にも言及。新しいフォーマット移行ドキュメントが待ちきれない！https://t.co/XVLZ3uwikc https://t.co/dz4oByygWA”,
“添付ファイル”:{
“メディア_キー”: [
“7_1370161464028196868”
]
}
}],
“includes”:{
“メディア”: [{
“型”:“ビデオ”,
“高さ”: 1280,
“パブリック_指標”：{
“表示_件数”: 37
}、
“幅”: 720,
“メディア_キー”:“7_1370161464028196868”,
“継続時間_ms”: 5140,
“プレビュー_画像_URL”:“https://pbs.twimg.com/ext_tw_video_thumb/1370161464028196868/pu/img/cGLCoXBHVktkwlC5.jpg”
}],
“ユーザー”: [{
“公開_指標”:{
“フォロワー_カウント”: 517233,
“以下の_件数”: 2034,
“Tweet_件数”: 3677,
“上場_件数”: 1727
}、
“作成済み_で”:“2013-12-14T04:35:55.000Z”、
“プロフィール_イメージ_URL”:“https://pbs.twimg.com/profile_images/1354494203451961345/d8HkZl6p_normal.jpg”、
“説明”:“#TwitterDev チームの声であり、#TwitterAPI に関するアップデート、ニュース、イベントの公式情報源です。”、
“認証済み”: true,
“id”:“2244994945”,
“ユーザー名”:“TwitterDev”,
“保護済み”: false,
“エンティティー”:{
“URL”:{
“URLs”: [{
“開始”: 0,
“終了”: 23,
“URL”:“https://t.co/3ZX3TNiZCY”、
“拡張_URL”:“https://developer.x.com/en/community”,
“表示_URL”:“developer.x.com/ja/community”
}]
},
“説明”:{
“ハッシュタグ”: [{
“開始”: 17,
“終了”: 28,
“タグ”:“TwitterDev”
},
{
“開始”: 105,
“終了”: 116,
“タグ”:“Twitter API”
}
]
}
},
“URL”:“https://t.co/3ZX3TNiZCY”,
“名前”:“X 開発者”、
“ロケーション”:“127.0.0.1”
}]
}
}

​
Place オブジェクト

Twitter 1.1 の形式Twitter v2 の形式必須の v2 パラメータ
placedata.geo.place_idtweet.fields=geo
place.idincludes.places.idexpansions=geo.place_id
place.id.place_typeincludes.places.place_typeexpansions=geo.place_id&place.fields=place_type
place.id.nameincludes.places.nameexpansions=geo.place_id&place.fields=name
place.id.full_nameincludes.places.full_nameexpansions=geo.place_id
place.id.country_codeincludes.places.country_codeexpansions=geo.place_id&place.fields=country_code
place.id.countryincludes.places.countryexpansions=geo.place_id&place.fields=country
place.id.contained_withinincludes.places.contained_withinexpansions=geo.place_id&place.fields=contained_within
place.id.bounding_box.typeincludes.places.geo.typeexpansions=geo.place_id&place.fields=place_type
place.id.bounding_box.coordinatesincludes.places.geo.bboxexpansions=geo.place_id&place.fields=geo
place.id.attributesincludes.places.propertiesexpansions=geo.place_id&place.fields=geo
例
v1.1 の Place オブジェクトv2 の Place オブジェクト

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

​
Native Enriched データ形式から v2 への移行

Native Enriched データ形式は、当社のエンタープライズ製品で使用されています。 Native Enriched データ形式は、編集済み Tweet メタデータを提供するように更新されました。Edit Tweet メタデータの詳細は、Edit Tweets の基礎ページをご覧ください。 標準の v1.1 エンドポイントを使用している場合は、standard v1.1 から v2 へのガイドを参照してください。Activity Streams を利用するエンタープライズ製品をご使用の場合は、Activity Streams から v2 への移行ガイドも用意しています。 X API v2 では、Tweetおよびユーザーオブジェクト向けに新しい JSON 設計を導入しています。
  • JSON のルートレベルでは、Native Enriched 形式は Tweet オブジェクトを results 配列で返しますが、X API v2 は data 配列で返します。
  • 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 は削除されます:
  • 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”
}]
}
field と 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 の fields に対応するか、また新しいフィールドを受け取るために必要な v2 のパラメータについて説明します。  

​
Tweet オブジェクト

ネイティブ拡張フォーマットTwitter v2 形式必須の v2 パラメーターv2 の型
作成_にてdata.created_でtweet.fields=created_で文字列
id該当なし — id を参照
id_strdata.id既定文字列
テキストdata.text既定String
編集_履歴data.edit_履歴_Tweet_ids既定配列
編集_コントロールdata.edit_コントロールtweet.fields=edit_コントロール群オブジェクト
編集可data.edit_controls.is_編集_対象tweet.fields=edit_コントロールブール型
表示_テキスト_レンジ該当なし - テキストは完全な本文を含みます
sourcedata.sourcetweet.fields=sourceString
切り捨て該当なし - テキストに完全な本文が含まれます
利用できませんdata.conversation_idtweet.fields=conversation_idString
利用できませんdata.reply_設定tweet.fields=reply_設定String
内で_返信_宛て_ステータス_id該当なし — 参照先を参照_tweets.id
内で_返信_宛て_ステータス_id_文字列data.referenced_tweets.id（type=replied_to の場合）_to)expansions=referenced_tweets.idString
内で_返信_宛て_ユーザー_id該当なし — in_reply_to_user_id_str を参照_返信_to_ユーザー_id_str
内で_返信_宛て_ユーザー_id_strdata.in_返信_宛て_ユーザー_idtweet.fields=in_返信_to_ユーザー_idString
内で_返信_宛て_画面_名前includes.users..usernametweet.fields=in_返信_宛て_利用者_id&expansions=entities.mentions.username文字列
ユーザincludes.usersexpansions=author_idオブジェクト
user.id_strdata.author_idtweet.fields=author_idString（文字列）
Geodata.geo.place_idtweet.fields=geo
座標data.geo.place_idtweet.fields=geo
場所data.geo.place_idtweet.fields=geo
である_引用済み_ステータスdata.referenced_tweets.id（type=quoted のとき）tweet.fields=referenced_TweetsString
延長_tweet.full_テキスト該当なし — テキストは完全な本文です
利用できませんdata.public_指標tweet.fields=public_指標オブジェクト
引用文_カウントdata.public_metrics.quote_カウントtweet.fields=public_指標Int（整数型）
返信_件数data.public_metrics.reply_カウントtweet.fields=public_指標Int（整数型）
リツイート_カウントdata.public_metrics.retweet_カウントtweet.fields=public_指標Int
お気に入り_カウントdata.public_metrics.like_カウントtweet.fields=public_metrics_指標整数型
利用できませんdata.non_公開_指標tweet.fields=none_公開_指標オブジェクト
利用できませんdata.non_公開_metrics.impression_件数tweet.fields=none_公開_指標Int（整数）
利用できませんdata.non_公開_metrics.url_リンク_件数tweet.fields=none_公開_メトリクスInt
利用できませんdata.non_公開_metrics.user_プロフィール_件数tweet.fields=none_公開_メトリクスInt（整数型）
利用できませんdata.organic_指標tweet.fields=organic_指標オブジェクト
利用できませんdata.organic_metrics.like_カウントtweet.fields=organic_指標Int
利用できませんdata.organic_metrics.retweet_カウントtweet.fields=organic_指標Int（整数型）
利用できませんdata.organic_metrics.reply_カウントtweet.fields=organic_指標Int（整数）
利用できませんdata.organic_metrics.impressions_カウントtweet.fields=organic_メトリクスInt（整数型）
利用できませんdata.organic_metrics.url_リンク_数tweet.fields=organic_メトリクスInt（整数型）
利用できませんdata.organic_metrics.user_プロフィール_カウントtweet.fields=organic_指標Int
利用できませんdata.promoted_メトリクスtweet.fields=promoted_メトリックオブジェクト
利用できませんdata.promoted_metrics.like_カウントtweet.fields=promoted_メトリックint
利用できませんdata.promoted_metrics.retweet_カウントtweet.fields=promoted_メトリクスInt
利用できませんdata.promoted_metrics.reply_counttweet.fields=promoted_指標Int
利用できませんdata.promoted_metrics.impression_カウントtweet.fields=promoted_指標Int（整数型）
利用できませんdata.promoted_metrics.url_リンク_カウントtweet.fields=promoted_指標Int
利用できませんdata.promoted_metrics.user_プロフィール_カウントtweet.fields=promoted_指標Int
貢献者利用できません利用できません
エンティティdata.entitiestweet.fields=entitiesオブジェクト
entities.user_メンションdata.entities.mentionstweet.fields=entitiesオブジェクト配列
entities.symbolsdata.entities.cashtagstweet.fields=entitiesオブジェクト配列
entities.hashtagsdata.entities.hashtagstweet.fields=entitiesオブジェクト配列
entities.urlsdata.entities.urlstweet.fields=entitiesオブジェクト配列
entities.mediaincludes.mediaexpansions=attachments.media_キーオブジェクト配列
entities.annotationstweet.fields=entities,context_アノテーションオブジェクト
entities.annotations.contextdata.context_アノテーションtweet.fields=entities,context_アノテーションオブジェクト配列
同等のものはありませんdata.context_annotations.domaintweet.fields=context_アノテーションオブジェクト
entities.annotations.context.context_ドメイン_id_strdata.context_annotations.domain.idtweet.fields=context_アノテーションString
entities.annotations.context.context_ドメイン_id利用できません利用不可 — data.context を参照_文字列形式については annotations.domain.id を参照
entities.annotations.context.context_ドメイン_名前data.context_annotations.domain.nametweet.fields=context_アノテーションString
entities.annotations.context.context_ドメイン_説明data.context_annotations.domain.descriptiontweet.fields=context_アノテーションString
同等品はありませんdata.context_annotations.entitytweet.fields=context_アノテーションオブジェクト
entities.annotations.context.context_エンティティ_id_strdata.context_annotations.entity.idtweet.fields=context_注釈String
entities.annotations.context.context_エンティティ_id利用できません利用できません - data.context を参照_文字列形式については annotations.entity.id を参照
entities.annotations.context.context_エンティティ_氏名data.context_annotations.entity.nametweet.fields=context_注釈String
entities.annotations.context.context_エンティティ_説明data.context_annotations.entity.descriptiontweet.fields=context_注釈String
entities.annotations.entitydata.entities.annotationstweet.fields=entities,context_注釈オブジェクトの配列
拡張された_エンティティdata.attachmentsTweet_fields=attachmentsオブジェクト
「いいね」済み利用できません利用できません
リポスト済み利用できません利用できません
リポスト済み_ステータス
場合によっては_機微情報data.possibly_機密tweet.fields=possibly_機微なブール型
言語data.langtweet.fields=langString
フィルタ_レベル利用できません利用できません
スコープ利用できません利用できません
タイムスタンプ_ms利用できません利用できません
保留data.withheldtweet.fields=withheldオブジェクト配列
マッチング_ルール照合_ルールオブジェクト配列
マッチング_rules.id利用できません利用できません
照合_rules.id_strマッチング_rules.idフィルタ済みストリームのデフォルトString
マッチング_rules.tagマッチング_rules.tagフィルタ済みストリームの既定String（文字列）

​
ユーザーオブジェクト

ネイティブ拡張フォーマットTwitter v2 形式必須の v2 パラメーターv2 の型
ユーザーincludes.usersexpansions=author_idオブジェクト配列
user.id利用できません該当なし — includes.users.id を参照String
user.id_strincludes.users.idexpansions=author_idString
user.nameincludes.users.nameexpansions=author_idString
user.screen_名前includes.user.usernameexpansions=author_id文字列
user.locationincludes.users.locationexpansions=author_id&user.fields=locationオブジェクト
user.descriptionincludes.users.descriptionexpansions=author_id&user.fields=descriptionString
利用できませんincludes.users.urlexpansions=author_id&user.fields=urlString
user.followers_カウントincludes.users.public_metrics.followers_カウントexpansions=author_id&user.fields=public_メトリクスInt（整数型）
user.friends_件数includes.users.public_metrics.following_カウントexpansions=author_id&user.fields=public_指標Int（整数型）
user.listed_カウントincludes.users.public_metrics.listed_カウントexpansions=author_id&user.fields=public_指標Int
user.created_でincludes.users.created_でexpansions=author_id&user.fields=created_でString
user.favorites_カウントまだご利用いただけません
user.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verifiedブール値
利用できませんincludes.users.pinned_Tweet_idexpansions=author_id&user.fields=pinned_Tweet_id文字列
user.statuses_カウントincludes.users.public_metrics.tweet_カウントexpansions=author_id&user.fields=public_メトリックInt型
user.profile_画像_URL_httpsincludes.users.profile_画像_URLexpansions=author_id&user.fields=profile_イメージ_URLString
user.translator_型利用不可利用できません
user.utc_オフセット利用できません利用できません
user.time_ゾーン利用できません利用できません
user.geo_有効化利用できません利用できません
user.lang利用できません利用不可 - Tweet の言語から推定
user.contributors_有効化利用不可利用できません
user.is_翻訳ツール利用できません利用できません
user.profile_背景_カラー利用できません利用できません
user.profile_背景_画像_URL利用できません利用できません
user.profile_背景_イメージ_URL_https利用できません利用できません
user.profile_背景_タイトル利用できません利用できません
user.profile_サイドバー_境界_色利用できません利用できません
user.profile_サイドバー_フィル_カラー利用できません利用できません
user.profile_テキスト_色利用できません利用できません
user.profile_利用者_背景_画像利用できません利用できません
user.profile_画像_URLincludes.user.profile を参照してください_イメージ_URL
ユーザー.デフォルト_プロフィール利用できません利用できません
ユーザー.デフォルト_プロフィール_イメージ利用できません利用できません
user.following利用できません利用できません
user.follow_要求_送信済み利用できません利用できません
user.notifications利用できません利用できません
user.withheld_内で_国・地域includes.users.withheldexpansions=author_id&user.fields=withheldオブジェクト
user.protectedincludes.users.protectedexpansions=author_id&user.fields=protectedブール
利用できませんincludes.users.entitiesexpansions=author_id&user.fields=entitiesオブジェクト
利用できませんincludes.users.entities.urlexpansions=author_id&user.fields=entitiesオブジェクト
利用できませんincludes.users.entities.url.urlsexpansions=author_id&user.fields=entitiesオブジェクト配列
利用できませんincludes.users.entities.url.urls.startexpansions=author_id&user.fields=entitiesInt（整数型）
利用できませんincludes.users.entities.url.urls.endexpansions=author_id&user.fields=entitiesInt（整数型）
利用できませんincludes.users.entities.url.urls.urlexpansions=author_id&user.fields=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=entitiesオブジェクト
利用できませんincludes.users.entities.descriptions.hashtagsexpansions=author_id&user.fields=entitiesオブジェクト配列
利用できませんincludes.users.entities.descriptions.hashtags.startexpansions=author_id&user.fields=entitiesInt（整数型）
利用できませんincludes.users.entities.descriptions.hashtags.endexpansions=author_id&user.fields=entitiesInt
user.description に含まれているincludes.users.entities.descriptions.hashtags.tagexpansions=author_id&user.fields=entitiesString
利用できませんincludes.users.entities.descriptions.mentionsexpansions=author_id&user.fields=entitiesオブジェクト配列
利用できませんincludes.users.entities.descriptions.mentions.startexpansions=author_id&user.fields=entitiesInt
利用できませんincludes.users.entities.descriptions.mentions.endexpansions=author_id&user.fields=entitiesInt（整数型）
user.description に含まれますincludes.users.entities.descriptions.mentions.usernameexpansions=author_id&user.fields=entitiesString
利用できませんincludes.users.entities.descriptions.cashtagsexpansions=author_id&user.fields=entitiesオブジェクト配列
利用できませんincludes.users.entities.descriptions.cashtags.startexpansions=author_id&user.fields=entitiesInt
利用できませんincludes.users.entities.descriptions.cashtags.endexpansions=author_id&user.fields=entitiesInt
user.description に含まれますincludes.users.entities.descriptions.cashtags.tagexpansions=author_id&user.fields=entitiesString

​
entities および expanded_entities オブジェクト

ネイティブ拡張リッチ形式Twitter v2 フォーマット必須の v2 パラメーターv2 の型
エンティティdata.entitiestweet.fields=entitiesオブジェクト
entities.hashtagsdata.entities.hashtagstweet.fields=entitiesオブジェクト配列
entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entities整数
entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entities整数
entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entitiesString
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=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=entitiesオブジェクト配列
利用できませんdata.entities.urls.images.urltweet.fields=entitiesString
利用できませんdata.entities.urls.images.widthtweet.fields=entitiesInt
利用できませんdata.entities.urls.images.heighttweet.fields=entitiesInt
entities.user_メンションdata.entities.mentionstweet.fields=entitiesオブジェクト配列
entities.user_mentions.indices[0]data.entities.mentions.starttweet.fields=entities整数
entities.user_mentions.indices[1]data.entities.mentions.endtweet.fields=entities整数
entities.user_mentions.screen_名前data.entities.mentions.usernametweet.fields=entitiesString
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=entitiesString
entities.media OR extended_entities.media_entities.mediaincludes.mediaexpansions=attachments.media_キーオブジェクト配列
entities.media.id_str または extended_entities.media.id_strincludes.media.media_キーexpansions=attachments.media_キーString
entities.media.id または extended_entities.media.id利用不可 - id は文字列です
entities.media.type または extended_entities.media.type_entities.media.typeincludes.media.media.typeexpansions=attachments.media_キーString
entities.media.indices または extended_entities.media.indices_entities.media.indices利用できません利用できません
利用できませんincludes.media.alt_テキストexpansions=attachments.media_キー&media.fields=alt_テキストString
entities.media.additional_メディア_info または extended_entities.media.additional_メディア_情報利用できません利用できません
entities.media.additional_メディア_info.monetizable OR extended_entities.media.additional_メディア_info.monetizable利用できません利用できません
entities.media.media_URL または extended_entities.media.media_URL該当なし — includes.media.url を参照String
entities.media.media_URL_https または拡張_entities.media.media_URL_httpsincludes.media.urlexpansions=attachments.media_キー&media.fields=urlString
entities.media.url OR extended_entities.media.url
entities.media.display_url または extended_entities.media.expanded_URL
entities.media.expanded_URL
entities.media.media_url_httpsincludes.media.preview_イメージ_URLexpansions=attachments.media_キー&media.fields=preview_画像_URLString
拡張済み_エンティティdata.attachmentsTweet_fields=attachmentsオブジェクト
拡張版_エンティティーdata.attachments.media_キーtweet.fields=attachmentsオブジェクトの配列
利用できませんdata.attachments.poll_idstweet.fields=attachmentsオブジェクト配列
拡張版_entities.media.sizes.thumb.w利用できません
拡張版_entities.media.sizes.thumb.h利用できません
拡張版_entities.media.sizes.thumb.resize利用できません
拡張版_entities.media.sizes.large.wincludes.media.heightexpansions=attachments.media_キー&media.fields=height
延長_entities.media.sizes.large.hincludes.media.widthexpansions=attachments.media_キー&media.fields=width
延長_entities.media.sizes.large.resize利用できません利用できません
拡張版_entities.media.sizes.small.w利用できません利用できません
拡張版_entities.media.sizes.small.h利用できません利用できません
拡張版_entities.media.sizes.small.resize利用できません利用できません
拡張版_entities.media.sizes.medium.w利用できません利用できません
延長_entities.media.sizes.medium.h利用できません利用できません
延長_entities.media.sizes.medium.resize利用できません利用できません
拡張版_entities.media.media_URL_httpsincludes.media.preview_画像_URLexpansions=attachments.media_キー&media.fields=preview_画像_URLString
拡張版_entities.media.video_info.aspect_比率利用できません利用できません
拡張版_entities.media.variants利用できません利用できません
拡張版_entities.media.variants.bitrate利用できません利用できません
拡張版_entities.media.variants.content_type利用できません利用できません
延長_entities.media.variants.url利用できません利用できません
拡張版_entities.media.video_info.duration_ミリ秒includes.media.duration_msexpansions=attachments.media_キー&media.fields=duration_msInt
利用できませんincludes.media.public_メトリクスexpansions=attachments.media_キー&media.fields=public_メトリックオブジェクト
利用できませんincludes.media.public_metrics.view_カウントexpansions=attachments.media_キー&media.fields=public_指標Int
利用できませんincludes.media.none_公開_指標expansions=attachments.media_キー&media.fields=none_公開_指標オブジェクト
利用できませんincludes.media.non_公開_metrics.playback_0_カウントexpansions=attachments.media_キー&media.fields=none_パブリック_指標Int型
利用できませんincludes.media.none_公開_metrics.playback_25_カウントexpansions=attachments.media_キー&media.fields=none_公開_指標Int
利用できませんincludes.media.none_公開_metrics.playback_50_件数expansions=attachments.media_キー&media.fields=none_公開_指標Int（整数型）
利用できませんincludes.media.none_公開_metrics.playback_75_件数expansions=attachments.media_キー&media.fields=none_公開_指標Int（整数型）
利用できませんincludes.media.non_公開_metrics.playback_100_カウントexpansions=attachments.media_キー&media.fields=none_公開_メトリクスInt（整数型）
利用できませんincludes.media.organic_指標expansions=attachments.media_キー&media.fields=organic_指標オブジェクト
利用できませんincludes.media.organic_metrics.playback_0_件数expansions=attachments.media_キー&media.fields=organic_指標Int
利用できませんincludes.media.organic_metrics.playback_25_カウントexpansions=attachments.media_キー&media.fields=organic_メトリクスInt（整数型）
利用できませんincludes.media.organic_metrics.playback_50_カウントexpansions=attachments.media_キー&media.fields=organic_指標Int
利用できませんincludes.media.organic_metrics.playback_75_件数expansions=attachments.media_キー&media.fields=organic_指標Int
利用できませんincludes.media.organic_metrics.playback_100_件数expansions=attachments.media_キー&media.fields=organic_メトリクスInt（整数型）
利用できませんincludes.media.organic_metrics.view_件数expansions=attachments.media_キー&media.fields=organic_指標Int型
利用できませんincludes.media.promoted_指標expansions=attachments.media_キー&media.fields=promoted_指標オブジェクト
利用できませんincludes.media.promoted_metric.playback_0_カウントexpansions=attachments.media_キー&media.fields=promoted_指標Int
利用できませんincludes.media.promoted_metric.playback_25_件数expansions=attachments.media_キー&media.fields=promoted_メトリクスInt（整数）
利用できませんincludes.media.promoted_metric.playback_50_カウントexpansions=attachments.media_キー&media.fields=promoted_メトリクスInt
利用できませんincludes.media.promoted_metric.playback_75_件数expansions=attachments.media_キー&media.fields=promoted_指標Int
利用できませんincludes.media.promoted_metric.playback_100_件数expansions=attachments.media_キー&media.fields=promoted_指標Int（整数型）
利用できませんincludes.media.promoted_metrics.view_カウントexpansions=attachments.media_キー&media.fields=promoted_メトリックInt

​
Place オブジェクト

ネイティブ拡張形式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オブジェクト

​
Poll オブジェクト

ネイティブ拡張形式Twitter v2 形式必須の v2 パラメータv2 の型
entities.pollsincludes.pollsexpansions=attachments.poll_idsオブジェクト配列
Not availableincludes.polls.idexpansions=attachments.poll_ids文字列
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_ids文字列
Not availableincludes.polls.options.votesexpansions=attachments.poll_idsInt
Not availableincludes.polls.voting_statusexpansions=attachments.poll_ids&poll.fields=voting_status文字列
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 データ形式は、編集済みの Tweet メタデータを提供できるよう更新されました。Edit Tweet メタデータの詳細は、Edit Tweets の基礎 をご覧ください。 標準の v1.1 エンドポイントをご利用の場合は、標準 v1.1 から v2 へのガイドを参照してください。プレミアム エンドポイント、またはエンタープライズ向けの Native Enriched 形式をご利用の場合は、Native Enriched から v2 へのガイドを参照してください。 X API v2 では、Post および user オブジェクトに対して新しい JSON 設計を導入しています。
  • JSON のルートレベルでは、Activity Streams 形式は Tweet オブジェクトを results 配列で返しますが、X API v2 は data 配列で返します。
  • Retweeted と Quoted を「アクティビティ」と呼ぶ代わりに、X API v2 の JSON では Retweeted および Quoted Tweets と表現します。
  • favorites（Tweet オブジェクト内）と favourites（user オブジェクト内）の両方を用いる代わりに、X API v2 では like を使用します。
  • X は、値が存在しない JSON 値（例: null）はペイロードに書き出さないという規約を採用しています。Tweet と user の属性は、非 null の値がある場合にのみ含まれます。
  • v2 におけるすべての id fields は文字列形式になります。  
新しい 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_でtweet.fields=created_にて日付（ISO 8601）
ジェネレータ利用できません利用できません
generator.link利用できません利用できません
generator.displayNamedata.sourcetweet.fields=sourceString
X（旧Twitter）_言語data.langtweet.fields=langString
利用できませんdata.conversation_idtweet.fields=conversation_idString
利用できませんdata.reply_設定tweet.fields=reply_設定String
利用できませんdata.possibly_機微に関わるtweet.fields=possibly_sensitive_機微ブール値
利用できませんdata.withheldtweet.fields=withheldオブジェクト
objectType利用不可利用不可
動詞利用できません利用できません
プロバイダ利用できません利用できません
provider.objectType利用できません利用できません
provider.displayName利用できません利用できません
provider.link利用できません利用できません
リンク利用できません利用できません
ディスプレイ_テキスト_レンジ利用できません利用できません
オブジェクト利用できません利用できません
object.objectType利用できません利用できません
object.id利用できません利用できません
object.summarydata.text既定String
object.edit_履歴data.edit_履歴_Tweet_ids既定配列
object.edit_コントロールdata.edit_コントロールtweet.fields=edit_コントロールオブジェクト
object.editabledata.edit_controls.is_編集_適格tweet.fields=edit_制御ブール型
object.link利用できません利用できません
object.postedTimedata.created_にてtweet.fields=created_にて日付（ISO 8601形式）
actor.id から派生data.author_idtweet.fields=created_at_で
X（旧Twitter）_フィルタ_レベル利用できません利用できません
inReplyTo.link のユーザー名に基づくdata.in_返信_to_ユーザー_idtweet.fields=in_返信_to_ユーザー_idString
利用できませんdata.referenced_Tweetstweet.fields=referenced_Tweetオブジェクト配列
利用できませんdata.referenced_tweets.typetweet.fields=referenced_TweetString
inReplyTo.link に由来data.referenced_tweets.idtweet.fields=referenced_TweetsString
利用できませんdata.attachmentstweet.fields=attachmentsオブジェクト
Twitter 由来_entities.media.id_strdata.attachments.media_キーtweet.fields=attachments配列
利用できませんdata.attachments.poll_idstweet.fields=attachments配列
Twitter_エンティティdata.entitiestweet.fields=entitiesオブジェクト
利用できませんdata.entities.annotationstweet.fields=entitiesオブジェクト配列
利用できませんdata.entities.annotations.starttweet.fields=entitiesInt（整数型）
利用できませんdata.entities.annotations.endtweet.fields=entitiesInt
利用できませんdata.entities.annotations.probabilitytweet.fields=entities浮動小数点数
利用できませんdata.entities.annotations.typetweet.fields=entitiesString
利用できませんdata.entities.annotations.normalized_テキストtweet.fields=entitiesString
Twitter_entities.urlsdata.entities.urlstweet.fields=entitiesオブジェクト配列
X（旧Twitter）_entities.urls.indices[0]data.entities.urls.starttweet.fields=entitiesInt（整数型）
X（旧Twitter）_entities.urls.indices[1]data.entities.urls.endtweet.fields=entitiesInt
Twitter_entities.urls.urldata.entities.urls.urltweet.fields=entities文字列
X（旧Twitter）_entities.urls.expanded_URLdata.entities.urls.expanded_URLtweet.fields=entitiesString
Twitter_entities.urls.display_URLdata.entities.urls.display_URLtweet.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型
gnip.urls.expanded_ステータスdata.entities.urls.statustweet.fields=entitiesInt
gnip.urls.expanded_URL_題名data.entities.urls.titletweet.fields=entitiesString
gnip.urls.expanded_URL_説明data.entities.urls.descriptiontweet.fields=entitiesString
gnip.urls.expanded_URLdata.entities.urls.unwound_URLtweet.fields=entitiesString
Twitter_entities.symbolsdata.entities.cashtagstweet.fields=entitiesオブジェクト配列
Twitter_entities.symbols.indices[0]data.entities.cashtags.starttweet.fields=entitiesInt（整数型）
X（旧Twitter）_entities.symbols.indices[1]data.entities.cashtags.endtweet.fields=entitiesInt
X（旧Twitter）_entities.symbols.textdata.entities.cashtags.tagtweet.fields=entitiesString
Twitter_entities.hashtagsdata.entities.hashtagstweet.fields=entitiesオブジェクト配列
X（旧Twitter）_entities.hashtags.indices[0]data.entities.hashtags.starttweet.fields=entities整数型
Twitter_entities.hashtags.indices[1]data.entities.hashtags.endtweet.fields=entitiesInt（整数型）
Twitter_entities.hashtags.textdata.entities.hashtags.tagtweet.fields=entitiesString
X（旧Twitter）_entities.user_言及data.entities.mentionstweet.fields=entitiesオブジェクト配列
Twitter_entities.user_mentions.indices[0]data.entities.mentions.starttweet.fields=entitiesInt（整数型）
Twitter_entities.user_mentions.indices[1]data.entities.mentions.endtweet.fields=entitiesInt（整数型）
X（旧Twitter）_entities.user_mentions.screen_名前data.entities.mentions.tagtweet.fields=entitiesString
Twitter_entities.user_mentions.id_strdata.entities.mentions.idtweet.fields=entities文字列
X（旧Twitter）_entities.user_mentions.id利用できません利用できません
利用できませんdata.context_注釈tweet.fields=context_アノテーションオブジェクト配列
利用できませんdata.context_annotations.domaintweet.fields=context_注釈オブジェクト
利用できませんdata.context_annotations.domain.idtweet.fields=context_アノテーションString
利用できませんdata.context_annotations.domain.nametweet.fields=context_アノテーションString（文字列）
利用できませんdata.context_annotations.domain.descriptiontweet.fields=context_アノテーション文字列
利用できませんdata.context_annotations.entitytweet.fields=context_注釈オブジェクト
利用できませんdata.context_annotations.entity.idtweet.fields=context_アノテーションString
利用できませんdata.context_annotations.entity.nametweet.fields=context_注釈String
利用できませんdata.context_annotations.entity.descriptiontweet.fields=context_アノテーションString
ジオdata.geotweet.fields=geoオブジェクト
location.link 由来data.geo.place_idtweet.fields=geoString
利用できませんdata.public_指標tweet.fields=public_メトリクスオブジェクト
お気に入り件数data.public_metrics.like_カウントtweet.fields=public_指標Int（整数）
リツイート数data.public_metrics.retweet_カウントtweet.fields=public_指標整数型（Int）
利用できませんdata.public_metrics.quote_カウントtweet.fields=public_指標Int
利用できませんdata.public_metrics.reply_カウントtweet.fields=public_指標Int
利用できませんdata.non_なし_公開_メトリクスtweet.fields=none_パブリック_メトリクスオブジェクト
利用できませんdata.non_公開_metrics.impression_counttweet.fields=non_パブリック_指標Int（整数型）
利用できませんdata.non_公開_metrics.url_リンク_カウントtweet.fields=none_公開_指標Int
利用できませんdata.non_public_metrics.user_プロフィール_カウントtweet.fields=none_公開_指標Int
利用できませんdata.organic_指標tweet.fields=organic_メトリクスオブジェクト
利用できませんdata.organic_metrics.like_カウントtweet.fields=organic_指標Int
利用できませんdata.organic_metrics.retweet_カウントtweet.fields=organic_メトリクスInt（整数型）
利用できませんdata.organic_metrics.reply_カウントtweet.fields=organic_メトリクスInt
利用できませんdata.organic_metrics.impression_カウントtweet.fields=organic_指標Int
利用できませんdata.organic_metrics.url_リンク_件数tweet.fields=organic_メトリクスInt（整数型）
利用できませんdata.organic_metrics.user_プロフィール_件数tweet.fields=organic_指標Int（整数型）
利用できませんdata.promoted_指標tweet.fields=promoted_指標オブジェクト
利用できませんdata.promoted_metrics.like_件数tweet.fields=promoted_指標Int
利用できませんdata.promoted_metrics.retweet_件数tweet.fields=promoted_メトリクスInt（整数）
利用できませんdata.promoted_metrics.reply_カウントtweet.fields=promoted_メトリクスInt
利用できませんdata.promoted_metrics.impression_カウント数tweet.fields=promoted_メトリクスInt（整数型）
利用できませんdata.promoted_metrics.url_リンク_カウントtweet.fields=promoted_メトリクスInt（整数）
利用できませんdata.promoted_metrics.user_プロフィール_カウントtweet.fields=promoted_メトリックInt（整数）
gnip.profileLocations利用できません利用できません
gnip.profileLocations.address利用できません利用できません
gnip.profileLocations.address.country利用できません利用できません
gnip.profileLocations.address.countryCode利用できません利用できません
gnip.profileLocations.displayName利用できません利用できません
gnip.profileLocations.geo利用できません利用できません
gnip.profileLocations.geo.coordinates利用できません利用できません
gnip.profileLocations.geo.type利用できません利用できません
gnip.profileLocations.objectType利用できません利用できません

​
ユーザーオブジェクト

Activity Streams フォーマットTwitter v2 形式必須の v2 パラメーターv2 の型
アクタincludes.usersexpansions=author_idオブジェクト配列
actor.id に由来しますincludes.users.idexpansions=author_idString
actor.displayNameincludes.users.nameexpansions=author_idString
actor.preferredUsernameincludes.users.usernameexpansions=author_idString
actor.postedTimeincludes.users.created_でexpansions=author_id&user.fields=created_にて日付（ISO 8601）
actor.summaryincludes.users.descriptionexpansions=author_id&user.fields=descriptionString
利用できませんincludes.users.pinned_Tweet_idexpansions=author_id&user.fields=pinned_Tweet_idString
利用できませんincludes.users.protectedexpansions=author_id&user.fields=protectedブール値
actor.link利用できません利用不可 - includes.users.username から生成
actor.twitterTimeZone利用できません利用不可 - Tweet の作成から推定_で
actor.utcOffset利用できません利用不可 - Tweet の作成日時から推定_で
actor.favoritesCount利用できません利用できません
actor.followersCountincludes.users.public_metrics.followers（フォロワー数）_カウントexpansions=author_id&user.fields=public_メトリクスInt（整数）
actor.friendsCountincludes.users.public_metrics.following_カウントexpansions=author_id&user.fields=public_指標Int型
actor.listedCountincludes.users.public_metrics.listed_カウントexpansions=author_id&user.fields=public_メトリクスInt
actor.statusesCountincludes.users.public_metrics.tweet_カウントexpansions=author_id&user.fields=public_指標Int型
actor.languages[]利用できません利用不可 - Tweet の言語から推定
actor.location.displayNameincludes.users.locationexpansions=author_id&user.fields=locationString
actor.imageincludes.users.profile_画像_URLexpansions=author_id&user.fields=profile_イメージ_URLString
actor.linksincludes.users.urlexpansions=author_id&user.fields=url文字列
actor.verifiedincludes.users.verifiedexpansions=author_id&user.fields=verifiedブール
利用できませんincludes.users.withheldexpansions=author_id&user.fields=withheldオブジェクト
利用できませんincludes.users.entitiesexpansions=author_id&user.fields=entitiesオブジェクト
利用できませんincludes.users.entities.urlexpansions=author_id&user.fields=entitiesオブジェクト
actor.linksincludes.users.entities.url.urlsexpansions=author_id&user.fields=entitiesオブジェクト配列
利用できませんincludes.users.entities.url.urls.startexpansions=author_id&user.fields=entitiesint
利用できませんincludes.users.entities.url.urls.endexpansions=author_id&user.fields=entities整数型
利用できませんincludes.users.entities.url.urls.urlexpansions=author_id&user.fields=entitiesString
actor.links.hrefincludes.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.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_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 形式Twitter 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 または twitter_拡張版_entities.mediaincludes.mediaexpansions=attachments.media_キーオブジェクト配列
Twitter_entities.media.id_str または Twitter_延長_entities.media.id_strincludes.media.media_キーexpansions=attachments.media_キーString
X（旧Twitter）_entities.media.id または Twitter_拡張版_entities.media.id利用できません利用できません
Twitter_entities.media.indices または Twitter_拡張版_entities.media.indices利用できません利用できません
Twitter_entities.media.additional_メディア_info または Twitter_拡張版_entities.media.additional_メディア_情報利用できません利用できません
Twitter_entities.media.additional_メディア_info.monetizable OR twitter_拡張版_entities.media.additional_メディア_info.monetizable利用できません利用できません
X（旧Twitter）_entities.media.media_URL または Twitter_拡張版_entities.media.media_URL利用できません利用できません
X（旧Twitter）_entities.media.media_URL_https または twitter_拡張版_entities.media.media_URL_httpsincludes.media.preview_イメージ_URLexpansions=attachments.media_キー&media.fields=preview_画像_URLString
X（旧Twitter）_entities.media.url または Twitter_拡張版_entities.media.url利用できません利用できません
X（旧Twitter）_entities.media.display_URL または Twitter_拡張版_entities.media.display_URL利用できません利用できません
X（旧Twitter）_entities.media.expanded_URL または Twitter_拡張版_entities.media.expanded_URL利用できません利用できません
Twitter_entities.media.type または Twitter_拡張版_entities.media.typeincludes.media.typeexpansions=attachments.media_キーString
Twitter_entities.media.sizes または twitter_拡張版_entities.media.sizes利用できません利用できません
Twitter_entities.media.sizes.thumb または Twitter_延長_entities.media.sizes.thumb利用できません利用できません
X（旧Twitter）_entities.media.sizes.thumb.h または Twitter_延長_entities.media.sizes.thumb.h利用できません利用できません
Twitter_entities.media.sizes.thumb.w または Twitter_拡張版_entities.media.sizes.thumb.w利用できません利用できません
Twitter_entities.media.sizes.thumb.resize または Twitter_拡張版_entities.media.sizes.thumb.resize利用できません利用できません
Twitter_entities.media.sizes.small または Twitter_拡張版_entities.media.sizes.small利用できませんご利用いただけません
Twitter_entities.media.sizes.small.h または Twitter_拡張版_entities.media.sizes.small.h利用できません利用できません
X（旧Twitter）_entities.media.sizes.small.w または Twitter_拡張された_entities.media.sizes.small.w利用できません利用できません
Twitter_entities.media.sizes.small.resize または Twitter_拡張版_entities.media.sizes.small.resize利用できません利用できません
Twitter_entities.media.sizes.medium または Twitter_拡張版_entities.media.sizes.medium利用できません利用できません
X（旧Twitter）_entities.media.sizes.medium.h または Twitter_拡張版_entities.media.sizes.medium.h利用できません利用できません
X（旧Twitter）_entities.media.sizes.medium.w または Twitter_拡張版_entities.media.sizes.medium.w利用できません利用できません
Twitter_entities.media.sizes.medium.resize OR twitter_拡張版_entities.media.sizes.medium.resize利用できません利用できません
Twitter_entities.media.sizes.large OR twitter_延長_entities.media.sizes.large利用できません利用できません
twitter_entities.media.sizes.large.h または Twitter_延長_entities.media.sizes.large.hincludes.media.heightexpansions=attachments.media_キー&media.fields=heightInt
Twitter_entities.media.sizes.large.w または Twitter_拡張版_entities.media.sizes.large.wincludes.media.widthexpansions=attachments.media_キー&media.fields=widthInt（整数型）
Twitter_entities.media.sizes.large.resize または Twitter_拡張版_entities.media.sizes.large.resize利用できません利用できません
X（旧Twitter）_拡張版_entities.media.video_情報利用できません利用できません
X（旧Twitter）_拡張版_entities.media.video_info.aspect_比率利用できません利用できません
X（旧Twitter）_拡張済み_entities.media.video_info.duration_ミリ秒includes.media.duration_ミリ秒expansions=attachments.media_キー&media.fields=duration_msInt型
X（旧Twitter）_拡張版_entities.media.video_info.variants利用できません利用できません
Twitter_拡張版_entities.media.video_info.variants.bitrate利用できません利用できません
Twitter_拡張版_entities.media.video_info.variants.content_型利用できません利用できません
Twitter_拡張版_entities.media.video_info.variants.url利用できません利用できません
利用できませんincludes.media.alt_テキストexpansions=attachments.media_キー&media.fields=alt_テキストString
利用できませんincludes.media.public_メトリクスexpansions=attachments.media_キー&media.fields=public_メトリクスオブジェクト
利用できませんincludes.media.public_metrics.view_カウントexpansions=attachments.media_キー&media.fields=public_指標Int
利用できませんincludes.media.none_公開_指標expansions=attachments.media_キー&media.fields=non_公開_指標オブジェクト
利用できませんincludes.media.none_公開_metrics.playback_0_カウントexpansions=attachments.media_キー&media.fields=none_公開_指標Int（整数）
利用できませんincludes.media.non_公開_metrics.playback_25_カウントexpansions=attachments.media_キー&media.fields=none_公開_指標int
利用できませんincludes.media.non_パブリック_metrics.playback_50_countexpansions=attachments.media_キー&media.fields=none_公開_メトリクスInt
利用できませんincludes.media.non_公開_metrics.playback_75_件数expansions=attachments.media_キー&media.fields=none_公開_指標Int型
利用できませんincludes.media.non_公開_metrics.playback_100_カウントexpansions=attachments.media_キー&media.fields=none_公開_メトリクスInt（整数型）
利用できませんincludes.media.organic_指標expansions=attachments.media_キー&media.fields=organic_指標オブジェクト
利用できませんincludes.media.organic_metrics.playback_0_カウントexpansions=attachments.media_キー&media.fields=organic_指標Int（整数型）
利用できませんincludes.media.organic_metrics.playback_25_件数expansions=attachments.media_キー&media.fields=organic_メトリクスint
利用できませんincludes.media.organic_metrics.playback_50_件数expansions=attachments.media_キー&media.fields=organic_指標Int
利用できませんincludes.media.organic_metrics.playback_75_カウントexpansions=attachments.media_キー&media.fields=organic_指標Int
ご利用いただけませんincludes.media.organic_metrics.playback_100_件数expansions=attachments.media_キー&media.fields=organic_メトリクスInt
利用できませんincludes.media.organic_metrics.view_カウントexpansions=attachments.media_キー&media.fields=organic_指標Int型
利用できませんincludes.media.promoted_メトリクスexpansions=attachments.media_鍵&media.fields=promoted_メトリクスオブジェクト
利用できませんincludes.media.promoted_metrics.playback_0_カウントexpansions=attachments.media_キー&media.fields=promoted_指標Int（整数型）
利用できませんincludes.media.promoted_metrics.playback_25_件数expansions=attachments.media_キー&media.fields=promoted_指標Int
利用できませんincludes.media.promoted_metrics.playback_50_件数expansions=attachments.media_キー&media.fields=promoted_メトリクスint
利用できませんincludes.media.promoted_metrics.playback_75_カウントexpansions=attachments.media_キー&media.fields=promoted_指標Int（整数型）
利用できませんincludes.media.promoted_metrics.playback_100_カウントexpansions=attachments.media_キー&media.fields=promoted_指標Int
利用できませんincludes.media.promoted_metrics.view_カウントexpansions=attachments.media_キー&media.fields=promoted_指標Int（整数）

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

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

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

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