Reddit Scraper API just launched: posts, comments, subreddits, users & full search→
Twitter Scraper APIsTrends API
Twitter Trends API

Twitter (X) Trends Scraper API for Current Topics and Location-Based Trend Data

Retrieve current Twitter trends across news, sports, entertainment, personalized, and general categories, or get trending topics for a specific country or city using its WOEID.

2 Trends endpoints
1 base credit + 1 credit per trend returned
Failed requests cost 0 credits
1,000 free credits
No credit card required
Get Started FreeView Docs
GET /v1/twitter/trends/
TWITTER
{
  "data": [
    { "name": "#AI", "tweet_volume": 125000, "category": "Technology" },
    { "name": "#SuperBowl", "tweet_volume": 890000, "category": "Sports" },
    { "name": "Breaking News", "tweet_volume": 45000, "category": "News" }
  ]
}
Endpoints

2 Trends Endpoints

All endpoints return structured JSON and authenticate with your API key in the x-api-key header.

GETGet Trends

Access real-time trending topics on Twitter. Get trending hashtags, tweet volumes, and category breakdowns for global trend analysis.

/v1/twitter/trends/
GETGet Place Trends

Get trending topics for any city or country using WOEID codes. Perfect for local marketing, geo-targeted campaigns, and regional analysis.

/v1/twitter/trends/place/{woeid}
Cost Calculator

Estimate your trends scraping cost

Failed requests never consume credits, and the exact charge is returned in the X-Credits-Used response header.

Total credits for 1,000 trends requests21,000
Loading plans…
Pricing

Simple, transparent pricing

Start with pay-as-you-go credits (never expire) or save up to 64% with a monthly or annual subscription. No hidden fees, no lock-in.

See full pricing details
FAQ

Frequently asked questions

Everything you need to know about the Twitter Trends API.

What is a Twitter Trends Scraper API?

A Twitter Trends Scraper API turns current Twitter trend information into structured data an application can use. ScrapeBadger's two Trends endpoints retrieve current topics by category or return trends for a supported geographic location using its WOEID.

What data does the Twitter Trends API return?

Trend objects can include the trend name or hashtag, its Twitter search URL, the associated search query, tweet count when available, and domain context when available. Location-based responses also include the location's WOEID, name, and country.

Which trend categories can I retrieve?

Get Trending Topics supports trending, for-you, news, sports, and entertainment. The trending category is used by default when the category parameter is omitted.

What is a WOEID, and how do I find one?

WOEID means Where On Earth ID. It identifies a geographic location supported by Twitter trends. For example, 1 represents Worldwide, 23424977 represents the United States, and 23424975 represents the United Kingdom. ScrapeBadger's Geo Search endpoint can help identify WOEIDs for supported countries and cities.

Can I control how many trends are returned?

Yes. The Get Trending Topics endpoint accepts a count parameter from 1 to 100 and defaults to 20. The Get Trends by Location endpoint does not document a count parameter or cursor-based pagination.

How often should I retrieve Twitter trends?

Twitter's trending topics can change every few minutes. For a historical trend tracker, scheduled requests every 5 to 15 minutes can capture regular snapshots while keeping credit use predictable. More frequent requests may be appropriate for time-sensitive monitoring.

How much does the Twitter Trends API cost?

Every successful Trends request costs 1 base credit plus 1 credit for each trend returned. A response containing 20 trends uses 21 credits. Failed 4xx and 5xx requests use 0 credits, and the exact charge is returned in the X-Credits-Used response header.

Does the Twitter Trends API have rate limits?

Yes. Request-per-minute limits depend on the selected ScrapeBadger plan. See the pricing table for the current limits per plan tier.

More Twitter Data APIs

Tweets APIAdvanced Tweet Search APILists APICommunities APIGeo APILive Events APIUsers APITwitter StreamsAll Twitter APIs

Start building with the Trends API

Sign up free and get 1,000 API credits. No credit card required.

Start Free TrialView All Twitter APIs

Disclaimer: ScrapeBadger is not affiliated with, endorsed by, or in any way officially connected with X Corp. (formerly Twitter, Inc.) or any of its subsidiaries or affiliates. The names Twitter, X, and related trademarks are the property of their respective owners.