Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

The Personalized Trends endpoint returns trending topics tailored to the authenticated user, based on their location and interests.

​
Overview

Personalized

Trends tailored to the user

Location-aware

Based on user’s location

Real-time

Current trending topics

​
Endpoint

MethodEndpointDescription
GET/2/users/personalized_trendsGet personalized trends

​
Example request

curl "https://api.x.com/2/users/personalized_trends" \
  -H "Authorization: Bearer $USER_ACCESS_TOKEN"

​
Example response

{
  "data": [
    {
      "trend_name": "#AI",
      "tweet_count": 125000
    },
    {
      "trend_name": "Machine Learning",
      "tweet_count": 85000
    }
  ]
}

​
Getting started

Prerequisites

Trends by WOEID

Get trends for a specific location

API Reference

Full endpoint documentation