イントロダクション

パーソナライズされたトレンドのエンドポイントでは、認証されたユーザーアカウント向けのパーソナライズされたトレンドを取得できます。

注意： パーソナライズされたトレンドは、X Premium に加入しているユーザーアカウントに対してのみ、このエンドポイントによって返されます。

アカウント設定

このエンドポイントにアクセスするには、以下のものが必要です：

• 承認された 開発者アカウント。
• プロジェクト 内の 開発者アプリ のキーおよびトークンを使用して認証すること。 

X API v2 エンドポイントへのアクセス方法の詳細については、Getting Started ガイド を参照してください。

​

はじめに

​

認証

このエンドポイントは、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 認可コード（PKCE 対応） のいずれかを使用して認証できます。  

​

リクエストの送信

以下のように Personalized Trends エンドポイントを呼び出します:

curl 'https://api.x.com/2/users/personalized_trends' --header 'Authorization: ••••••'

リクエストが成功すると、次のような JSON レスポンスが返されます:

{
    "data": [
        {
            "category": "Bitcoin",
            "post_count": "42K件のポスト",
            "trend_name": "MicroStrategyの420億ドルのビットコイン投資",
            "trending_since": "5時間前"
        },
        {
            "category": "Music",
            "post_count": "2K件のポスト",
            "trend_name": "Drakeの「No Face」ミュージックビデオリリース",
            "trending_since": "トレンド中"
        },
        {
            "category": "Weather",
            "post_count": "1.2K件のポスト",
            "trend_name": "スーパー台風レオンが台湾とバタネス諸島に影響",
            "trending_since": "トレンド中"
        }
    ]
}

注意: リクエストの認証済みユーザーが X Premium を購読していない場合は、代わりに次のレスポンスが返されます。

{
    "data": [
        {
            "category": "不明",
            "post_count": "不明",
            "trending_since": ""
        }
    ]
}