Account Activity API エンドポイントの提供開始
本日、新しい X API v2 の Account Activity API エンドポイントを提供開始しました。詳しくはこちらをご覧ください。Media Upload エンドポイントの改善
開発者エクスペリエンス向上のため、Media Upload エンドポイントをいくつか改善しました。分割アップロード専用のエンドポイントとして、Chunked Media Upload 用の Media Upload エンドポイントを導入しました。詳しくはこちらをご覧ください。Media Upload エンドポイントの提供開始
本日、新しい X API v2 の Media Upload エンドポイントを提供開始しました。詳しくはこちらをご覧ください。新しいドキュメントサイトの公開
本日、新しい X Developer Platform のドキュメントサイト https://docs.x.com を公開しました。Historical Powertrack エンドポイントの非推奨化
本日、エンタープライズ向け X API から Historical Powertrack および Insights track エンドポイントを非推奨とします。Basic および Pro ティアからの Follows エンドポイントの削除
本日、X API v2 の Basic ティアおよび Pro ティアから Follows および List Follows エンドポイントを削除します。ブックマーク数と長文ポストのサポート
本日、X API v2 でブックマーク数を取得する機能と、280 文字を超えるポストを取得する機能のサポートを追加しました。statuses/filter エンドポイントの非推奨化
本日、X API v1.1 における statuses/filter エンドポイントを非推奨とします。開発者は、X API v2 の filtered stream エンドポイントを利用できます。表示回数のサポート
本日、X API v2 に表示回数のサポートを追加しました。ポストのペイロード内の public_metrics にimpression_count という新しいフィールドが利用可能になります。Verified Type フィールドの追加
本日、ユーザーアカウントが受けている認証の種別 (青、ビジネス、政府、またはなし) を示すverified_type ユーザーフィールドを X API v2 に追加します。フィルタリングオペレーターエイリアスの追加
検索および filtered stream エンドポイント全般 (エンタープライズ、プレミアム、v2) に、フィルタリング／クエリオペレーターの「エイリアス」が追加されました。多くの場合、このオペレーターはステータスではなくポストを参照します。たとえば、in_reply_to_status_id に対するエイリアスとして in_reply_to_tweet_id が追加されました。別のケースでは、新しいオペレーターエイリアスによって、実行されるマッチングの内容がより明確になります。例えば、ポストには動画の添付が 1 件しか存在しないため、has:videos に対する新しいエイリアスとして has:video_link が提供されます。さらに多くの例については、v2 filtered stream オペレーターの表をご確認ください。逆時系列ホームタイムラインのアップデート
本日より、逆時系列ホームタイムラインの v2 エンドポイントは、直近 7 日間にタイムライン上で作成されたすべてのポストと、作成日時に関係なく最新の 800 件のポストを返せるようになりました。ストリーミングエンドポイントのレイテンシー更新
本日、X API v2 のストリーミングエンドポイントに対して、レイテンシーを 50% 削減するための更新を行いました。Essential アクセスでの v1.1 メディアエンドポイントの有効化
本日、X API v2 の Essential アクセスで v1.1 メディアエンドポイントを有効化しました。この更新の詳細については、フォーラムでのお知らせをご覧ください。逆時系列ホームタイムラインエンドポイントの提供開始
本日、フォローしているアカウントによる最新のポストやリポストの一覧を取得できる新しいエンドポイントを提供開始しました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。新しいエンドポイントとあわせて、media object でvariants フィールドが利用可能になりました。これにより、その URL に添付されているコンテンツの type を取得できます。ブックマークエンドポイントの提供開始
本日、X API v2 を使用してブックマークを管理およびルックアップできる新しいエンドポイントを提供開始しました。ブックマーク機能はこれまで X アプリで長らく提供されていましたが、API 経由でブックマークを取得・作成したり、管理するソリューションを構築したりできるエンドポイントは、これまで存在していませんでした。このリリースの詳細については、フォーラムでのお知らせをご覧ください。引用ポストのルックアップエンドポイントの提供開始
本日、ポスト ID に対する引用を取得できる quotes lookup endpoint を提供開始しました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。ドキュメントナビゲーションの更新
皆さまからのフィードバックを受け、ドキュメント内で目的のコンテンツを見つけづらく、リンクをクリックした際にまったく別のサイドナビゲーションに遷移してしまう点がわかりづらい、というご意見をいただいていました。本日、X Developer Platform の全コンテンツを単一のサイドナビゲーションから閲覧できるようにした、更新版のドキュメントナビゲーションをリリースしました。この更新により、重複するページを削除し、わかりづらいアイコンを取り除き、ナビゲーション内のさまざまな要素とのインタラクション方法を改善しました。フィードバックがありましたら、フィードバックチャネルからお知らせください。リポストおよびいいねのルックアップエンドポイントの改善
本日、reposts lookup および Likes lookup エンドポイントを改善し、直近 100 アカウントだけでなく、ポストにいいねまたはリポストしたアカウントの完全なリストを取得できるようにしました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。OAuth 2.0 認証のサポート
本日より、すべての開発者は、開発者コンソールで認証方法として OAuth 2.0 を選択することで、OAuth 2.0 を利用して認証できるようになりました。今回のリリースでは、機密クライアントおよびパブリッククライアントに対応し、関連するすべての v2 エンドポイントでこの認証方法を利用できるようにサポートを追加しました。OAuth 2.0 は業界標準の認可プロトコルであり、アプリケーションのスコープに対する開発者のコントロールを強化し、複数デバイス間の認可フローを改善します。つまり、X を利用する人々向けのアプリケーションを構築する開発者は、自身の App がユーザーから要求する情報をより細かく制御できるようになり、エンドユーザーには必要なデータと情報だけを求めればよくなります。この最新の認可プロトコルにより、App の認可に際して、リクエストした特定のスコープだけを表示する、よりシンプルな同意フローをエンドユーザーに提示できるようになります。このリリースの詳細については、フォーラムのお知らせをご覧ください。X API v2 における主要なプラットフォームアップデート
主要なプラットフォームアップデート: X API v2 がプライマリバージョンに、Essential アクセスと Elevated アクセスの新設、およびポリシー変更本日、X API v2 が X API のプライマリバージョンになったことをお知らせします。X API v2 には、X API 上で構築された既存の App の 90% のニーズを満たすのに十分な数のエンドポイントと機能が揃いました。X API v2 の開発者向けエクスペリエンスをさらに向上させるため、本日、以下の変更をリリースします。- API への高速かつ無料の Essential アクセスと、ユースケースが承認された開発者向けの無料の Elevated アクセスを提供します。これらのアクセスレベルの詳細については、「About the X API」ページで詳しく説明しています。
-
X のコア機能を使ってどのように構築できるかを制限し、App を通じてサポートできるユーザー数を制限していた開発者ポリシー上の文言を削除します。
- プラットフォームをオープンにし、X をより良く、より健全にし、パブリックな会話を拡張するツールやプロダクトの構築を促進します。私たちがぜひ構築してほしいと考えているソリューションの一覧をご覧ください。
- 特に、X のコア機能を含む X のエクスペリエンスの複製を制限していた条項や、多数のユーザートークンを保持する際に許可を必要としていた条項を削除しました。
- X 上の人々を支援するソリューションを構築するには、開発者が X 上で利用可能な機能の一部を構築 (あるいは複製) する必要がある場合が多いことを、私たちは理解しています。今回の開発者ポリシーの変更は、開発者エコシステムに明確性をもたらし、開発者がパブリックな会話の場で構築・イノベーション・価値創出をしやすくなる、オープンな API プラットフォームを提供することを目的としています。
List Lookup エンドポイントのリリース
本日、X API v2 に新しい List lookup エンドポイントをリリースします。これらのエンドポイントにより、フォロワー、メンバー、投稿など、指定したリストに関する詳細情報を取得できるようになります。取得したデータは、キュレーション、分析、発見性といったユースケースやニーズに対応するソリューションの構築に利用できます。新しいリストエンドポイントに加え、Academic Research アクセスレベルで新しい list: 演算子が利用可能になりました。これは投稿検索および投稿数の取得で利用できます。このリリースの詳細については、フォーラムのお知らせをご覧ください。Spaces エンドポイントの機能追加
Spaces エンドポイントに機能を追加し、特定の Space のチケットを購入したユーザーのリストを返せるようにするとともに、Topics のサポートも追加します。このリリースの詳細については、フォーラムのお知らせをご覧ください。Manage Posts エンドポイントの提供開始
本日、X API v2 に新しい Manage Posts エンドポイントを追加しました。ポストの作成および削除機能に加えて、投票付きポストの投稿、画像へのユーザータグ付け、返信設定付きポストの作成、Super Follower 向けのポストの投稿が可能になりました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。埋め込みボタンの変更
本日、X の埋め込みボタンにいくつかの変更を加えました。ボタンは X.com のボタンに合わせて、これまでよりも丸みを帯びた形状になり、カラーパレットも (ごくわずかに) 更新されています。このリリースの詳細については、フォーラムでのお知らせをご覧ください。リスト エンドポイントグループの提供開始
本日、X API v2 に新しい リスト エンドポイントグループを追加しました。これらのエンドポイントにより、好み、関心、グループ、トピックにもとづいて投稿をキュレーションおよび整理するソリューションを構築できるようになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Mutes ルックアップ エンドポイントの提供開始
本日、X API v2 に新しい mutes ルックアップ エンドポイントを追加しました。このエンドポイントにより、認証済みユーザーは自分がミュートしているアカウントを取得し、その情報を確認できるようになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。OAuth 2.0 ベータ版の提供開始
本日、X API v2 で OAuth 2.0 およびきめ細かなスコープのベータ版の提供を開始します。X Developer Platform 上での OAuth 2.0 の将来像の検討に関心のある開発者は、OAuth 2.0 ベータ版へのアクセスをリクエストできます。OAuth 2.0 は認証の業界標準であり、よりモダンな認可エクスペリエンスを提供します。OAuth 2.0 ベータ版では、v2 Project および関連する App においてこの新機能をテストし、一般提供 (GA) リリース前にフィードバックをお寄せいただけます。ただし、この OAuth 2.0 実装は現在開発中であるため、公開された本番環境や本番アプリでのテストは控えることを強く推奨します。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Batch Compliance エンドポイントの提供開始
本日、X API を利用する開発者が X データを当社の開発者契約およびポリシーに準拠させやすくするために、新しい batch compliance endpoints を X API v2 に追加しました。これらのエンドポイントにより、開発者や研究者は大量のポストまたは User の ID をバッチでアップロードし、ユーザーの意図および X 上のコンテンツの最新の状態をデータセットに反映させるために必要な対応を把握できます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Spaces エンドポイントの提供開始
本日、新しい Spaces エンドポイント と、新しい最上位の Spaces データディクショナリ を X API v2 に追加しました。Spaces エンドポイントを使用すると、Space ID または user ID、あるいはタイトル内で言及されている人のキーワード、ハッシュタグ、ユーザー名を使って Spaces を検索できます。新しいデータディクショナリには、その Space のtitle、チケット制かどうか、参加者メトリクスなど、Space に関する関連情報が含まれます。すべての user ID は完全なオブジェクトに展開することができます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。動画再生数の制限用の新しいオブジェクト
これまで、エンタープライズ版の Engagement API を使用して、投稿から 1,800 日を超えて経過した投稿の動画再生数メトリクスをリクエストした場合、十分なコンテキストがないまま 0 の値を返していました。本日より、これらのケースではunsupported_for_video_views_tweet_ids という新しいオブジェクトを返し、その中に投稿から 1,800 日を超えて経過した投稿 ID のカンマ区切りリストを含めます。これらの投稿について、リクエストされたその他のメトリクスは、引き続き別のオブジェクトで受け取ることができます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Alt Text フィールドの追加
本日、開発者がアクセシビリティに十分配慮した形でプロダクトを構築できるようにするため、X API v2 のメディアオブジェクトでalt_text フィールドを利用可能にしました。このフィールドをリクエストするには、expansions=attachments.media_keys パラメータに加えて、media.fields=alt_text パラメータを指定する必要があります。リクエストにこれらのパラメータが含まれている場合、このフィールドは代替テキスト付き画像を含む投稿について、その代替テキストを返します。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Reposts エンドポイントの提供開始
本日、新しい reposts エンドポイントを X API v2 に追加しました。開発者は、これらのエンドポイントを使用して認証済みユーザーに代わってリポストまたはリポストの取り消しを行ったり、特定の投稿をリポストしたユーザーを取得したりできるようになりました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Manage Mutes エンドポイントの提供開始
本日、新しい manage mutes エンドポイントを X API v2 に追加しました。これらのエンドポイントにより、認証済みユーザーはアカウントをミュートまたはミュート解除できるようになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。tweet.fields パラメータで context_annotations フィールドをリクエストしている場合に、full-archive search エンドポイントで返すことができる max_results の上限を 100 に引き下げました。これは、1 ページあたり、このフィールド付きで取得できる投稿が最大 100 件までになることを意味します。ストリーミングエンドポイント向けの信頼性機能
本日、X API v2 の filtered stream と sampled stream 向けに、バックフィルと冗長接続という 2 つのストリーミング向け信頼性機能を Academic Research プロダクトトラックで利用可能にしました。冗長接続機能により、特定のストリームに 2 回接続できるようになり、一方のストリームで切断が発生した場合でも、ストリーミングの稼働時間を最大化するのに役立ちます。バックフィルは、ストリーミングリクエストにbackfill_minutes パラメータと 1 から 5 までの整数を追加することで利用でき、ストリームの切断によって取り逃した可能性のあるデータを再取得することができます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。投稿数エンドポイントの提供開始
本日、新しい post counts endpoints を X API v2 向けに提供開始しました。これには 2 つの異なるエンドポイントが含まれます。すべてのプロダクトトラックで利用可能な Recent post counts と、現在は Academic Research プロダクトトラックのみで利用可能な full-archive post counts です。これらのエンドポイントを使用して、指定したクエリに一致する投稿数を取得できます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Teams の改善
本日、コミュニティから寄せられたフィードバックに基づき、Teams の機能に重要な改善を行いました。チームページのスタイルとデザインを更新しました。また、チームメンバーの招待や、招待が失敗した理由をより理解しやすくするため、招待フローにも変更を加えました。チームアカウントをお持ちの場合は、開発者コンソールの teams ページ を表示して、変更点を確認できます。Teams の詳細については、[関連ドキュメント](https://developer.x.com/en/docs/Developer Console/overview#team) および関連する [FAQ](https://developer.x.com/en/docs/Developer Console/faq#dev-portal-management-faq) をご覧ください。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Configuration エンドポイントの提供終了
本日、標準 v1.1 GET /help/configuration エンドポイントの提供を終了しました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。oEmbed エンドポイントの統合
本日、v1.1 oEmbed エンドポイントが 2021 年 11 月 23 日に提供終了および削除されることをお知らせします。これは、新機能を一貫した方法でサポートするためです。その日以降、X の oEmbed (埋め込み投稿およびタイムライン) のための唯一の公式かつサポート対象の API エンドポイントは、publish.x.com/oembed 経由のものになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Blocks および Likes ルックアップエンドポイントの提供開始
本日、新しい blocks および Likes ルックアップエンドポイントを X API v2 向けに提供開始しました。これらのエンドポイントを使用すると、v2 API を使用して、あるアカウントがどの投稿に「いいね」したか、どのユーザーがある投稿に「いいね」したか、そしてあなたまたは認証済みユーザーが誰をブロックしているかといった情報を取得できます。このリリースの詳細については、フォーラムでのお知らせをご覧ください。「いいね」管理エンドポイントの提供開始
本日、新しい 「いいね」を管理 するエンドポイントを X API v2 に追加しました。これらのエンドポイントにより、v2 API を使用して投稿に「いいね」したり、「いいね」を取り消したりできるようになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。ブロック管理エンドポイントの提供開始
本日、新しい ブロック管理 エンドポイントを X API v2 に追加しました。これらのエンドポイントにより、ユーザー ID を使用して、ユーザーに代わってアカウントをブロックまたはブロック解除できるようになります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。埋め込みタイムラインのサポート終了
本日、埋め込みタイムラインウィジェット の今後の対応方針をお知らせします。2021 年 6 月 23 日に、「いいね」、コレクション、モーメントのタイムラインを終了する予定です。代わりに、より高速で使いやすく、X の機能や特性により即した形に更新している プロフィール タイムラインおよび リスト タイムラインの利用をおすすめします。この変更の詳細については、フォーラムでのお知らせをご覧ください。フォロー管理エンドポイントの提供開始
本日、新しい フォロー管理 エンドポイントを X API v2 に追加しました。これらのエンドポイントにより、ユーザー ID を使用して、ユーザーに代わってアカウントをフォローまたはフォロー解除できるようになります。このリリースは、アカウントのフォロワーおよびフォロー先を取得できる follows lookup エンドポイントの提供開始から、数か月後のタイミングとなります。このリリースの詳細については、フォーラムでのお知らせをご覧ください。Academic Research プロダクトトラックの導入
本日、新しい Academic Research プロダクトトラック を X API v2 に導入しました。このアップデートにより Academic Researcher 向けの新しい申請プロセスが追加され、承認された方には Academic Research 用の Project が付与され、より広範なアクセスと高度な機能が利用できるようになります。新しい Academic Research プロダクトトラックにより、次の機能にアクセスできるようになります。- 現時点では Academic Research プロダクトトラックのみに提供されている、新しい X API v2 の full-archive search エンドポイント。
- Standard プロダクトトラック の Basic access level で利用可能な 50 万件から増加した、1,000 万件の投稿数上限。
-
recent search、full-archive search、および filtered stream で利用可能な新しいフィルター演算子。
$(別名 cashtag) 、bio(filtered stream のみで利用可能) 、bio_name(filtered stream のみで利用可能) 、bio_location(filtered stream のみで利用可能) 、place、place_country、point_radius、bounding_box、-is:nullcast、has:cashtags、has:geoなどが含まれます。 - filtered stream に設定できるルール数の上限を、Standard プロダクトトラックの Basic access level で利用可能な 25 から、1,000 個の同時ルールへと増加。
- クエリおよびルールの文字数上限を、Standard プロダクトトラックの Basic access level で利用可能な 512 文字から、1,024 文字へと増加。
Reply Settings フィールドの追加
本日、post オブジェクトにreply_settings という新しいフィールドを追加しました。このフィールドは、post lookup、hide replies、recent search、sampled stream、filtered stream、follows lookup、user post timeline、user mention timeline エンドポイントなど、投稿を返すすべての X API v2 エンドポイント、または任意のエンドポイントで post オブジェクトをexpanding することで利用できます。このフィールドは、投稿の作成者が、他のユーザーからその投稿へどのように返信できるように設定しているかを示します。すべてのユーザー、投稿内でメンションしているユーザーのみ、作成者がフォローしているユーザーのみ、のいずれかです。reply_settings フィールドによって返される値には、everyone、mentionedUsers、following が含まれます。投稿に会話コントロールが設定されていない場合でも、このフィールドは post オブジェクトに含まれ、値は everyone になります。User Post および Mention Timeline エンドポイントの提供開始
本日、新しい user post timeline および user mention timeline エンドポイント を X API v2 に追加しました。これらのエンドポイントを使用すると、指定した X 上のアカウントが投稿した、またはそのアカウントをメンションしている投稿を取得できます。詳細はフォーラムでのアナウンス投稿をご覧ください。Follows Lookup エンドポイントの提供開始
本日、新しい follows lookup エンドポイント を X API v2 に追加しました。これらのエンドポイントを使用すると、指定したユーザー ID を使って、そのアカウントのフォロワーおよびフォローしているアカウントを取得できます。詳細はフォーラムでのアナウンス投稿をご覧ください。Labs v2 エンドポイントの廃止
Labs v2 の recent search および hide replies エンドポイントを廃止しました以下のエンドポイントを廃止しました。これらの Labs 版エンドポイントを使用していた場合は、リンク先の移行ガイドを参照して統合を更新し、新しい X API v2 バージョンの利用を開始してください。新しい X API v2 への移行に関する詳細は、移行ハブにも用意しています。ご不明な点がある場合は、Labs フォーラムカテゴリまでお問い合わせください。Labs v1 エンドポイントの廃止
2020年8月12日に、新しい X API v2 (Early Access) をリリースしました。このリリースにより、複数のエンドポイントを Labs プログラムから X API v2 に昇格させるとともに、Labs 版エンドポイントは非推奨 (deprecated) の状態とし、60 日後に廃止することを発表しました。本日でローンチから 60 日が経過したため、以下のエンドポイントを廃止しました。これらの Labs 版エンドポイントを使用している場合は、リンク先の移行ガイドを参照して統合を更新し、新しい X API v2 バージョンの利用を開始してください。新しい X API v2 への移行に関する詳細は、移行ハブにも用意しています。ご不明な点がある場合は、Labs フォーラムカテゴリまでお問い合わせください。投稿使用状況ステータスバーの追加
新しい開発者コンソールのメインダッシュボードページで、1 か月あたり 500,000 件のポスト上限に対する使用量を確認できるようになりました。この上限は Project 単位で、Basic access の次の v2 エンドポイント全体に適用されます: filtered stream と recent search。この機能を表示し、新しい v2 エンドポイントを使用するには、新しい開発者コンソール エクスペリエンスを有効化する必要があります。Hide replies エンドポイントのリリース
本日、X API v2 に新しい hide replies エンドポイントをリリースしました。このエンドポイントにより、攻撃的、注意をそらす、または誤解を招く投稿への返信を非表示にすることができます。これはパブリックな会話の健全性を向上させるうえで重要な機能です。詳しくはフォーラムのアナウンス投稿をご覧ください。X Developer Labs にある同じエンドポイントは、現在非推奨となっており、90 日以内に廃止されます。v2 エンドポイントへ移行する方法をご確認ください。X API v2 エンドポイントへのアーリーアクセス
本日、新しい X API の最初のエンドポイントへのアーリーアクセス を発表しました。新しい X API には、新機能をより迅速に提供できる新しい API 基盤、受け取るフィールドをより細かく制御できる更新されたデータ形式と新機能、新しいポスト、ユーザー、メディアのフィールド、一連の更新されたエンドポイントが含まれており、これらにより、以下のエンドポイントを含むポストのリッスンおよび分析が可能になります。利用可能な新機能の一覧や移行用リソースについては、[X API v2: Early Access ドキュメントページ]https://developer.x.com/en/docs/x-api/early-access) を参照してください。今後の計画については、「[Guide to the future of the X API]https://developer.x.com/en/docs/x-api/early-access)」をご覧ください。Labs エンドポイントの廃止
本リリースで X API v2 の後継エンドポイントが公開されることに伴い、一部の Labs エンドポイントを廃止します。次の Labs v1 エンドポイントは、本日のリリースから 60 日後に廃止されます。- post metrics v1
- Filtered stream v1
- Sampled stream v1
- Recent search v2
返信を非表示にする機能の改善
返信を再表示できるようになりました。また、このエンドポイント経由で、以前に再表示した返信を再度非表示にできるようになりました。詳細は 返信を非表示にする機能のドキュメント を参照してください。Labs v1 エンドポイントの廃止
本日、Labs v1 の posts と users、返信の非表示、recent search の各エンドポイントを廃止します。Labs v1 に関する計画の詳細は、フォーラムでのお知らせ をご覧ください。新しいポスト指標の追加
本日、X Developer Labs の post lookup エンドポイントで返されるポストオブジェクトに、2 つの新しい非公開指標サブフィールドuser_profile_clicks と url_link_clicks を追加します。これらは、tweet.fields パラメータに non_public_metrics、organic_metrics、promoted_metrics のいずれかの値を指定した場合に返されます。詳細については、post lookup API リファレンス を参照してください。オーガニック指標とプロモーション指標のグループ分け
ポスト取得エンドポイント内のポストおよびメディアオブジェクトにorganic_metrics と promoted_metrics を追加します。COVID-19 エンドポイントの提供開始
本日、新しい COVID-19 ストリームエンドポイントと、それに付随するコンプライアンスエンドポイントを提供開始します。これらの変更の詳細は、フォーラムでのお知らせをご覧ください。Replay API のユーザープロフィールに関する更新
本日より、Replay API は、Replay API 実行時点の参照ユーザーを反映したユーザープロフィールオブジェクトを配信します。この現在のユーザープロフィールオブジェクトを配信する変更は、2019 年 11 月 25 日付で下記に記載している Historical PowerTrack の最近のアップデートと同様のものです。Developer Policy の更新
本日、重要な Developer Policy の更新を発表しました。詳しくは、フォーラムおよびブログの投稿をご覧になり、改訂されたポリシーを確認してください。Developer Policy は、X API の利用における基盤の一つであり、ご自身の義務を理解しておくことが重要です。Hide Replies エンドポイントの提供開始
X 上で安心して快適に会話できるように支援したいと考えています。その一環として、本日、ポストの作者が開始した会話をよりコントロールできるように、新しい エンドポイント による Hide Replies 機能のサポートを提供できることをうれしく思います。この新しいエンドポイントの詳細は、フォーラムでのお知らせをご覧ください。Labs エンドポイント v2 のリリース
本日、posts と Users、Recent Search、Hide Replies の各エンドポイントを Labs の v2 で利用可能にしました。Labs v1 エンドポイントは非推奨となり、この最初のリリースから 90 日後に完全に廃止されます。この期間中は v1 のドキュメントも引き続き参照可能です。このバージョン管理の方針については、フィードバック チャネル からご意見をお寄せいただけます。posts と Users に対して、次の変更を行いました。- クエリパラメータとして fields を導入
- クエリパラメータとしての formats を削除
- posts と Users における単一 ID の lookup 用のパス変数を追加
- GET /users の単一および複数ユーザー名 lookup に対するパスおよびクエリパラメータの調整
-
フィールド名
statsをpublic_metricsに変更
-
Users における
most_recent_tweet_idの展開を削除 -
フィールドを解析しやすくするため、posts の
sourceフィールドから HTML タグを削除
Access Token 管理の変更
本日、developer.x.com の applications Dashboard 内で Access Token と Access Token Secret が表示および管理される方法を変更しました。API 連携のセキュリティを強化するため、これらの値が最初に生成されたとき以降は、Dashboard 上に Access Token と Access Token Secret を表示しないようにします。初回以降、これらの認証情報は取得できません。Dashboard 上でトークンを再生成することはできますが、その場合は現在のトークンとシークレットが無効になります。この変更の詳細については、フォーラムでのお知らせをご覧ください。SPDY サポートの削除
2020 年 1 月 15 日以降、X API (およびその他すべての X ドメイン) へのすべての接続は、SPDY 接続をサポートしなくなります。この変更の詳細については、フォーラムでのお知らせをご覧ください。Labs における Recent Search エンドポイントの提供開始
本日、直近 7 日間に投稿されたポストを検索するための新しいエンドポイントをリリースしました。このリリースの詳細については、フォーラムでのお知らせをご覧ください。ストリームにおけるポストアノテーションの追加
本日、X Developer Labs において、デフォルトのポストペイロードに新しいメタデータ要素をリリースします。これらの新しいフィールドは、ポストペイロードの一部として付与され、ポストに関するより多くのコンテキスト情報を提供します。このリリースの詳細は、フォーラムでのお知らせをご覧ください。Historical PowerTrack のユーザープロフィールに関する更新
本日、「batch historical posts」エンドポイント (Historical PowerTrack) を更新し、ジョブ処理時点の値を反映したユーザープロフィールの位置情報、自己紹介文、表示名の情報を提供できるようにします。更新されたユーザーオブジェクトが配信される際、User/Actor オブジェクト内に新しい “updated” 文字列配列が含まれます。取りうる値は最大で name、description、location の 3 つです。"updated": ["name", "description", "location"]詳細については、Historical PowerTrack のデータ形式に関するドキュメントをご覧ください。Account Activity API への追加
本日、Account Activity API に新機能をリリースします。これにより、購読しているユーザーに言及しているアカウントがブロックされているかどうかを、開発者が確認できるようになります。user_has_blocked のデータオブジェクト構造の詳細や、その他の情報についてはフォーラムでのお知らせをご覧ください。Labs における Sampled Stream エンドポイントのローンチ
本日、すべての公開ポストのサンプルをストリーミングするための新しいエンドポイントをリリースします。ポストが投稿されると同時に、リアルタイムで取得できます。このリリースの詳細は、フォーラムでのお知らせをご覧ください。Labs における Filtered Stream エンドポイントのローンチ
本日、X Developer Labs において、ポストを取得するための新しいストリーミングエンドポイントと、フィルターを管理するためのエンドポイントをリリースします。これらのエンドポイントを使用すると、月あたり最大 500,000 件のポスト (最大 1 秒あたり 50 ポスト) を取得できます。また、ストリームには最大 10 個のフィルタールールを設定でき (同時に適用可能) 、柔軟に制御することができます。このリリースの詳細は、フォーラムでのお知らせをご覧ください。APIリファレンスのページに記載されているリクエストパラメーターには、必須か任意かが明確に示されるようになりました。加えて、リクエストで JSON ボディペイロードが許可されている場合は、その内容が APIリファレンスページで説明されます。Labs におけるポストメトリクスのローンチ
所有／認可されたアカウントの任意のポスト、またはポストのリストに対するエンゲージメントデータを取得できるようになりました。クエリ対象のポストは 30 日以内に投稿されたもので、かつ再投稿ではない必要があります。GET /tweets/metrics/private は次のメトリクスをサポートします:-
impressions -
reposts -
quotes -
likes -
replies -
video views -
video view quartiles(リクエストしたユーザーがメディアの投稿者である場合)
DM 権限の変更
本日以降、ダイレクトメッセージを作成する必要があるアプリケーションには「Read, Write, and Direct Messages」アプリ権限 (RW+DM) が必須となります。RW アプリ権限のみでダイレクトメッセージの作成を試みたアプリケーションは、次のエラーを受け取ります。{"code": 93,"message": "This application is not allowed to access or delete your direct messages."}この変更の詳細については、フォーラムでのお知らせをご覧ください。ピン留めポスト用 Expansion の追加
pinned_tweet_id は、ユーザーオブジェクトの expansion を通じて、ユーザーのピン留めされたポストを展開します。引用数メタデータの追加
開発者は、新しい Labs エンドポイントを使用して、引用数を取得できます。最新ポスト用 Expansion の追加
most_recent_tweet_id は、ユーザーオブジェクトの expansion を通じて、ユーザーの最新ポストを展開します。このリリースの詳細については、フォーラムでのお知らせをご覧ください。TLS 1.2 の必須化
本日より、X API (およびその他すべての X ドメイン) へのすべての接続には TLS 1.2 が必須となります。この変更の詳細については、フォーラムでのお知らせをご覧ください。新しい Account Activity API エンドポイント
本日より、アプリケーション専用 (App-only) OAuth を使用してユーザーサブスクリプションを無効化するための新しい Account Activity API エンドポイントを導入します。この新しいエンドポイントにより、サブスクライブしているユーザーのアクセストークンを必要とせずに、サブスクリプションを無効化するためのベアラートークンだけを提供すればよくなり、開発者にとって利便性が向上します。3-legged OAuth を使用してユーザーサブスクリプションを無効化する既存のエンタープライズ Account Activity API エンドポイントは、直ちに非推奨としてマークされます。このエンドポイントは 2020 年 1 月 15 日以降に廃止され、利用できなくなります。開発者は、この API の詳細をドキュメントで確認できます。Tweets エンドポイント向けの新しい Expansions
[GET /tweets]https://developer.x.com/en/docs/labs/tweets-and-users/api-reference/get-tweets.html) エンドポイントに 2 つの新しい expansions を追加しました:entities.mentions.username は、ポスト内で検出されたあらゆるユーザーメンションのユーザー名を、完全なユーザーオブジェクトに展開します。referenced_tweets.id.author_id は、要求されたポストのうちいずれかがリポスト、引用ポスト、返信である場合に、参照されているポストの投稿者の id を展開します。この expansion は、参照されているポストの id も完全なオブジェクトに展開します。Labs における Tweets および Users エンドポイントのサポート
最初の 2 つのエンドポイントが Labs ポータルで利用可能になりました。これらのエンドポイントを利用するには、承認済みの開発者アカウントを持ち、Labs アクセスを申請済みであることを確認してください。v1.1 の同等機能との主な違いには、次のものが含まれます。- 単一オブジェクトの「show」機能と一括「lookups」機能を兼ねる単一エンドポイント
- [Expansion parameters]) により、1 回のリクエストの一部として追加のオブジェクト (例: 言及されたユーザー、参照されているポストなど) を含めることが可能
- [Format parameters]) により、ペイロードの詳細度が異なるさまざまなデータ投影をサポート
- レート制限は、認証方法 (ユーザーコンテキストまたはベアラートークン) に関わらず App 単位で適用
利用規約およびプライバシーエンドポイントの廃止
利用規約およびプライバシーエンドポイントは完全に廃止されました。最新の プライバシーポリシー および 利用規約 については、常に最新の情報が掲載されているウェブページをご参照ください。この変更の詳細については、フォーラムでのお知らせをご覧ください。Account Activity Replay API の提供開始
本日より、Account Activity API のエンタープライズティアで利用できるデータ復旧ツールである Account Activity Replay API の提供を開始します。Account Activity Replay API を使用すると、最長 5 日前までさかのぼってイベントを取得できます。webhook サーバーがイベントを取り逃した場合など、データを復旧するシナリオで利用してください。開発者の方は、この API についてさらに詳しくドキュメントで学ぶことができます。is:reply 演算子の追加
本日より、演算子 is:reply が enterprise search APIs および有料版の premium search endpoints で利用可能になります。is:reply ブール演算子は、すべての投稿への返信を抽出したり、ルールに一致する明示的な返信のみを除外したりするために使用できます。この演算子は is:quote 演算子と同じ方法で動作します。Search API では、すべての ‘is:’ および ‘has:’ 演算子は、キーワードやハッシュタグなどの単独で使用できる演算子と組み合わせて使用する必要があることに注意してください。この演算子の詳細については、ドキュメントをご覧ください。Expanded URL Enrichment の変更
本日より、expanded URL enrichment には、投稿、Moments、またはプロフィールへのリンク URL について、unwound URL オブジェクトおよびメタデータ (title および description フィールドを含む) が含まれなくなります。その他の URL (Web サイトなど) については、引き続きこのメタデータで拡張され、url、expanded_url、display_url はこれまでどおり利用可能である点にご注意ください。この変更は、Decahose、PowerTrack、Historical PowerTrack、および Search APIs に適用されます。PowerTrack における is:reply オペレーターの追加
本日、新しいオペレーター is:reply を導入しました。これにより、最も関心のある会話に結果を絞り込むことができます。これまでのリポストを除外する機能 (is:retweet) や引用ポストを除外する機能 (is:quote) に加えて、検索結果から返信を除外できるようになりました。この新しいオペレーターは、PowerTrack、Historical PowerTrack、および Replay で本日より利用可能です。is:reply ブール型オペレーターは、すべての投稿への返信だけをフィルタリングしたり、ルールに一致する明示的な返信を除外したりする場合に使用できます。このオペレーターは is:quote オペレーターと同じように機能します。このオペレーターの詳細については、ドキュメントをご覧ください。開発者コンソールでの App へのアクセス
本日より、開発者は自分の既存の X apps を、X アカウントにログインしている限り、developer.x.com 上の X app ダッシュボード から表示および編集できるようになりました。以前は、開発者アカウント を申請済み、または承認済みである場合にのみ、developer.x.com 上で既存の X apps を表示および編集することができました。新しい X apps を作成するには、今後も承認された開発者アカウントが必要です。動画字幕のサポート
本日、広告主およびパブリッシャーが、ads.x.com、Media Studio、およびパブリッシャー向けアップロード API を通じて、動画に字幕ファイル (SRT) を追加できるようになったことをお知らせします。字幕は、Android および Web 上で、 (音声が利用できない) 自動再生動画に表示されます。iOS 向けの機能は、今後数週間以内に提供予定です。新しい字幕用エンドポイントの詳細については、それぞれの APIリファレンスページを確認してください。Account Activity API エンドポイントの更新
本日、Account Activity API のエンドポイントである GET subscriptions/count の更新をお知らせします。請求内容および API の利用状況をより明確に把握できるようにするため、本日より、ご利用の Account Activity API インスタンスに紐づくプロビジョニング済みサブスクリプション数を JSON 内からプログラムで取得できるようになりました。これは、GET subscriptions/count API エンドポイントを通じて、自分のプロビジョニング済みサブスクリプション数と、その上限にどれだけ近づいているかの両方を確認できるようになったことを意味します。この更新は、Account Activity API ドキュメント に反映済みです。POST エンドポイントにおける新しいレート制限
本日より、いくつかの標準 POST エンドポイントに対して、新しい App レベルのレート制限を適用します。- POST statuses/update
- POST statuses/retweet/:id
- POST favorites/create
- POST direct_messages/events/new
- POST friendships/create
twitter-text ライブラリのアップデート
本日、X における絵文字のカウント方法に関する最近の変更を反映するために、twitter-text ライブラリのアップデートを発表します。以前は 2 文字を超えてカウントされていた絵文字については、今後は 2 文字としてのみカウントされるようになり、ユーザーが 280 文字を最大限に活用できるようになります。この変更の詳細については、フォーラムでのお知らせをご覧ください。旧 DM エンドポイントの廃止
旧 Direct Message エンドポイントはすべて廃止されました。廃止された DM エンドポイントの一覧と、その代替エンドポイントについては このページ を参照してください。このアップデートの詳細については、フォーラムでのお知らせをご覧ください。DM メディアアクセスの変更
本日、Direct Message に添付されたメディアを取得する手順にいくつか変更を適用します。認証済みの www.x.com セッションを通じてmedia_url や media_url_https にアクセスすることは、今後サポートされません。media_url_https を取得するリクエストは、常にユーザーのアクセストークンを用い、OAuth 1.0a を使用して署名しなければなりません。このアップデートの詳細については、フォーラムでのお知らせをご覧ください。User Streams および Site Streams の廃止
User Streams と Site Streams は完全に廃止されました。このアップデートの詳細については、フォーラムでのお知らせをご覧ください。Usage API の新バージョン
本日、Usage API の新バージョンをリリースします。このアップデートにより、新しいシステムに移行することで API の安定性を向上させます。システムの更新に伴い、開発者が 2018 年 5 月 1 日までしかデータを取得できないため、ユーザー側ではデータの「空白期間」が発生します。そのため、今後 1 年間は、数か月分の過去データが欠落することになります (2019 年 6 月まで) 。Usage API 内の製品名が Historical PowerTrack Subscription から Historical PowerTrack 2.0 に変更され、他のユーザー向け文言との命名の一貫性が保たれるようになります。アップデート後も、顧客は同じ形式でまったく同じデータを受け取ります。この変更は products.type JSON オブジェクト内で確認できます。ご不明な点がありましたら、アカウントマネージャーまでお問い合わせください。API の廃止
Account Activity API DM Beta 製品は本日をもって完全に廃止されました。以下のサービスおよびエンドポイントは、本日よりサービス品質の低下が発生します。- User Streams
- Site Streams
- GET direct_messages
- GET direct_messages/sent
- GET direct_messages/show
- POST direct_messages/new
- POST direct_messages/destroy
App 作成とレート制限の変更
本日以降、新しい X apps を apps.x.com 経由で作成することはできなくなります。今後は、開発者コンソール アカウント、またはまだ開発者コンソールのアカウントをお持ちでない場合は 申請ページ にリダイレクトされます。また、2018 年 9 月 10 日より、以下の POST エンドポイントに対して新しい App レベルのレート制限を導入することもあわせて発表しました。- POST statuses/update
- POST statuses/retweet:id
- POST friendships/create
- POST favorites/create
- POST direct_messages/events/new
開発者コンソールでの App 管理
開発者コンソール アカウントをお持ちの場合、X apps を作成および管理できるようになりました。詳細については、[フォーラムの投稿](https://devcommunity.x.com/t/app-creation-and-management-now-available-in-the-Developer Console/107723) をお読みください。Sign in with X と Account Activity の変更
本日より、Sign in with X プロセスで使用する callback URLs を登録することが必須になりました。このアップデートの詳細についてはこちらをご覧ください。また、Account Activity API に tweet_delete_events アクティビティを追加したことも発表しました。この新しいアクティビティは、該当する削除イベントに対して送信され、開発者が顧客やアプリケーション利用者に対してコンプライアンス要件を満たしたエクスペリエンスをより容易に提供できるようにします。この新しいアクティビティの詳細については、フォーラムの投稿 またはドキュメントをご覧ください。規約とポリシーの更新
本日、利用規約、プライバシーポリシー、および [X 開発者規約]https://developer.x.com/en/developer-terms/agreement-and-policy を、プライバシー、セキュリティ、およびデータ保護に関する更新を含めて変更しました。詳細については、フォーラムの投稿 をお読みください。プロフィール背景と Account Activity の変更
本日、profile_background_image_url および profile_background_image_url_https のすべてのインスタンスを、それぞれのデフォルト値に変更しました。詳細については、フォーラムの投稿 をお読みください。上記の変更に加えて、どのサブスクリプションに対してアクティビティが配信されたかを参照するために、Account Activity API のペイロードに新しいフィールドを追加しました。この JSON オブジェクトは for_user_id と呼ばれ、そのアクティビティを生成した購読ユーザーの ID を値として含みます。この新しい JSON オブジェクトの例については、account activity objects のページをご覧ください。引用ペイロードでの URL レンダリングの変更
本日、引用ペイロード内での URL のレンダリング方法に変更を加えます。引用ポストを参照できるようにするため、新しいエンティティである “quoted_status_permalink” エンティティを追加し、引用ポストの “text” フィールドから t.co リンクを削除します。新しい形式では、t.co リンクは “quoted_status” オブジェクト内の引用ポストの “text” フィールドには付加されなくなります。さらに、引用ポストの t.co url、expanded_url、display_url を、今後は “urls” エンティティには含めません。代わりに、これらは “url”、“expanded”、“display” の URL 属性を持つ新しい “quoted_status_permalink” オブジェクトに追加されます。これは、“quoted_status_permalink” オブジェクトは引用ポストへの t.co リンク専用となり、一方で “entities.urls” 配列は元のポストまたは引用ポスト内で共有されたリンクを識別するために使用できることを意味します。詳細については、フォーラム投稿および更新されたドキュメントをお読みください。追加メディア情報 オブジェクトの追加
ポストのペイロードに新しい additional_media_info オブジェクトを追加するとともに、広告主から X 所有のクライアント上でのみ動画再生を制限するよう要請があったプロモーションポストについて、一部の動画詳細情報 (video_info) を制限します。この変更に関する追加情報は、次のリンク先で確認できます: Extended Entities Objects > post with native video。Premium フルアーカイブ検索の提供開始
premium full-archive search エンドポイントの提供を開始しました。Account Activity API の提供開始
(All Activities) と (ダイレクトメッセージ) の両方の Standard ベータ版 Account Activity API の提供を開始しました。このリリースの詳細はブログをご覧ください。あわせて、User streams および Site streams の廃止と、そのサンセット日を 2018 年 6 月 19 日火曜日とすることを発表しました。Premium API のリリース
Premium API をリリースしました。これらの新しい API は、当社エンタープライズデータプラットフォームの品質と安定性を基盤とし、それを段階的な料金モデルを通じて、より幅広く利用できるようにするものです。標準エンドポイントで提供されていた 7 日分という制限を超え、初めて 30 日分の投稿を検索できるようになりました。さらにオプションとして、プロフィールの位置情報、URL 展開、投票データについて、Premium 向けエンリッチメントにもアクセスできます。新機能の一部は次のとおりです。- 1 回のリクエストあたりに取得できる投稿数の増加 (Sandbox + Premium)
- より複雑なクエリを可能にする、はるかにリッチなクエリ言語 (Sandbox + Premium)
- 投稿の時系列カウントを返す counts エンドポイント (Premium)
- 展開された URL や Profile Geo などのメタデータエンリッチメント (Premium)
280 文字ポストのリリース
文字数の制約が問題となっていた言語において、280 文字ポストを正式にリリースしました。詳しくは、フォーラムでのお知らせ または公式の ブログ記事 を参照してください。追加メディア情報の追加
ポストのペイロード (additional_media_info object) に新しいデータを追加し、また、広告主からの要請により動画再生を X が所有するクライアントに限定しているプロモーション投稿については、一部の動画詳細情報 (video_info) を制限します。この変更に関する詳細情報は、次のリンクを参照してください: Extended Entities Objects > post with native video30日検索における url_contains オペレーターのサポート終了
30日検索およびフルアーカイブ検索では、url_contains: オペレーターのサポートが終了しました。このオペレーターの非推奨化は、2016年8月の Gnip 2.0 移行の一環として告知されていました。url_contains: オペレーターを使用するすべての検索クエリは、無効として拒否されます。検索 API における url_contains オペレーターの今後の削除
30日検索 API (30日およびフルアーカイブの両方) は、本日から30日後、つまり 2017年8月4日以降、url_contains: オペレーターをサポートしなくなります (実際の url_contains: のサポート終了は、その日以降に行われる最初のデプロイからとなります) 。このオペレーターの非推奨化は、2016年8月の Gnip 2.0 移行の一環として告知されていました。オペレーターのサポートが終了すると、url_contains: を使用するすべてのクエリは、無効として拒否されます。DM コマンド向けのオプションパラメーター
statuses/update のオプションパラメーター enable_dm_commands を使用すると、移行期間の終了前に、アプリケーション側で DM コマンドのサポートを早期に無効化できます。デフォルト値は true (すなわち現在のレガシー動作) ですが、false に設定することで、11月1日以降の新しい動作を適用できます。statuses/update のオプションパラメーター fail_dm_commands を true に設定すると、DM コマンドに対する API のレスポンスが HTTP 403 (エラーコード 151) を返すようになります。デフォルト値は false です。このアップデートの詳細はフォーラムをご覧ください。新しいエンリッチメントとペイロードの変更
新しいエンリッチメントとして、Poll メタデータが Enterprise API を通じて利用可能になりました。詳細についてはドキュメントをご覧ください。新しいペイロードフィールド: ユーザーがポストに写真を追加する際に「Add description」オプションを選択した場合、ペイロードのentities.media[] および extended_entities.media[] セクションに、画像の代替テキスト (説明) フィールドが含まれる場合があります。これはエンリッチされたネイティブ形式でのみ利用可能です。デフォルトのペイロード形式: Gnip 製品で新規に作成されるストリームのデフォルトは、オリジナル形式の JSON になります。Historical PowerTrack と Replay API のアップデート
Historical PowerTrack API と Replay API:- 引用ポストのフィルタリングがサポートされるようになりました
- 引用された投稿が、HPT と Replay の投稿ペイロード内で完全に再構築されるようになりました
カウント用の新しいペイロードフィールド
新しいペイロードフィールド: quote_count と reply_count が、Realtime API および Historical API 全体でネイティブ拡張形式のペイロードとして利用可能になりましたフルアーカイブ検索での Geo オペレーターのサポート
Full-Archive Search API (FAS):- 追加の geo オペレーターをサポートしました:
- place:
- place_country:
- has:profile_geo:
- profile_country:
- profile_region:
- profile_locality: