Personalized Trends

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:

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