Twitter-API-V2 /list/id/tweets の仕様について

Question

この質問はTwitter API の仕様に関する質問です。コーディングに関する質問ではありません。

前提

Twitter API V2の リストのツイートを取得 するエンドポイント　https://api.twitter.com/2/lists/:id/tweets について、公式ドキュメント ではクエリパラメータ media.fields が記載されておりません 。

media.fields はツイート検索やユーザー別のツイートを取得するエンドポイントで利用可能なパラメータ です。

しかし 公式ドキュメントに記載されていないにも関わらず、リストのツイートを取得する https://api.twitter.com/2/lists/:id/tweets でも media.fields を使用して メディアに関する追加の情報を 取得することができてしまいます 。

疑問

https://api.twitter.com/2/lists/:id/tweets に対する media.fields の使用は正式にサポートされていますか？ 公式ドキュメント や その他の公式の見解 を教えていただけると助かります。

また、サポートされていない場合、このパラメータを使用することによる問題は何が考えられるかについてもお答えいただきたいです。

なお趣味のプロジェクトで Twitter API を使うにあたって感じた疑問ですので、厳格に答えて頂く必要はありません。お気軽にお応えいただければと思います。

---

最後まで目を通して頂きありがとうございます。よろしくお願いします。

Answer 1

公式ドキュメント ではクエリパラメータ media.fields が記載されておりません 。

Twitter API v2は、expansions と fields という仕組みを使って、データ取得内容をカスタマイズすることが可能になっています。
このこと（概要）は
https://developer.twitter.com/en/docs/twitter-api/data-dictionary/using-fields-and-expansions
に書いてあります。

https://api.twitter.com/2/lists/:id/tweetsについていえば、[Query Parameters]の段落にattachments.media_keysという expansion が使用可能と明記されています。

そして、attachments.media_keysという expansion を使用するとき、
media:fieldsという field parameter を使用することが可能です。
（https://developer.twitter.com/en/docs/twitter-api/data-dictionary/using-fields-and-expansions
のチュートリアルの 4. ～ 5. を参照）

---

各エンドポイントに対してどのような、fields が使えるかについて、直接的に細かく記載されているわけではありません。
ただ、直接的に書かれていないからと言ってただちにサポートされていないということにはなりません。
上記のようにドキュメントには、いろいろな要素が集約的に記述されているので、総合的に読んで使い方を理解する必要があります。