はじめに

Personalized Trends endpoint は、認証中のユーザーアカウント向けのパーソナライズドトレンドを取得できます。

注: パーソナライズドトレンドは、X Premium を購読しているユーザーアカウントに対してのみ、この endpoint から返されます。

アカウントのセットアップ

この endpoint にアクセスするには、次が必要です:

• 承認済みの デベロッパーアカウント。
• Project 内にある 開発者用 App のキーおよびトークンを使用して認証すること。

X API v2 の endpoint へのアクセス方法については、スタートガイド をご覧ください。

​

はじめに

​

認証

この endpoint は、OAuth 1.0a ユーザーコンテキスト または OAuth 2.0 Authorization Code（PKCE 付き） のいずれかで認証できます。  

​

リクエストの送信

次のように Personalized Trends endpoint を呼び出します：

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

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

{
    "data": [
        {
            "category": "Bitcoin",
            "post_count": "42K Posts",
            "trend_name": "MicroStrategy's $42 Billion Bitcoin Investment",
            "trending_since": "5 hours ago"
        },
        {
            "category": "Music",
            "post_count": "2K Posts",
            "trend_name": "Drake's 'No Face' Music Video Release",
            "trending_since": "現在トレンド中",
        },
        {
            "category": "Weather",
            "post_count": "1.2K Posts",
            "trend_name": "Super Typhoon Leon Impacts Taiwan and Batanes",
            "trending_since": "現在トレンド中"
        }
    ]
}

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

{
    "data": [
        {
            "category": "Unknown",
            "post_count": "Unknown",
            "trending_since": ""
        }
    ]
}