Introduction

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:

• An approved developer account.
• To authenticate using the keys and tokens from a developer App that is located within a Project. 

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": ""
        }
    ]
}