The Personalized Trends endpoint allows you to get personalized trends for an authenticating user account.

Note: Personalized trends will only be returned by the endpoint for user accounts that are subscribed to X Premium.

Account setup

To access this endpoint, you will need:

Learn more about getting access to the X API v2 endpoints in our getting started guide.

​
Getting started

​
Authentication

You can authenticate this endpoint with either OAuth 1.0a User Context, or OAuth 2.0 Authorization Code with PKCE.  

​
Making a request

You can call the Personalized Trends endpoint as shown below:

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

If the request is successful, you should see the JSON response as shown below:

{

    "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": "Trending now"

        },

        {

            "category": "Weather",

            "post_count": "1.2K posts",

            "trend_name": "Super Typhoon Leon Impacts Taiwan and Batanes",

            "trending_since": "Trending now"

        }

    ]

}

Note: If the authenticated user of the request is not subscribed to X Premium, they will receive the following response instead:

{

    "data": [

        {

            "category": "Unknown",

            "post_count": "Unknown",

            "trending_since": ""

        }

    ]

}
TrendsGet personalized Trends