What format is the data returned in?

Responses are JSON. Each one contains the extracted data plus a _metadata block with the request ID and execution time.

What are the rate limits for the X (Twitter) Trends API?

Up to 60 requests per minute, 1,000 per hour and 10,000 per day. Contact us if you need higher limits.

Can I run long requests in the background?

Yes. Add ?async=true to receive a job_id immediately, then poll /api/v1/jobs/ / until the status is COMPLETED.

Do I need to manage proxies or browsers?

No. DataGuru runs the infrastructure, proxies and retries. You only send an HTTP request with your API key.

Social Media API · Live

X (Twitter) Trends API

Get trending hashtags, topics, and discussions on X (Twitter) by country or worldwide.

No credit card required · Pay only for what you use

Price: $0.02 / req
Rate limit: 60 req/min
Output: Structured JSON
Modes: Sync & async

POSThttps://api.dataguru.cc/api/v1/x/trends

curl -X POST "https://api.dataguru.cc/api/v1/x/trends" \
  -H "Authorization: Api-Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"include_tweets": "False", "limit": "50", "location": "worldwide", "tweets_limit": "3"}'

Response · 200 OK

{
  "x_trends": {
    "location": "string",
    "location_slug": "string",
    "source_url": "https://example.com/...",
    "scraped_at": "2026-01-01T12:00:00Z",
    "total_trends": 0,
    "total_hashtags": 0,
    "total_topics": 0,
    "top_hashtags": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ],
        "hashtag": "string",
        "overall_rank": 0
      }
    ],
    "popular_topics": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ],
        "topic": "string",
        "overall_rank": 0
      }
    ],
    "all_trends": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ]
      }
    ],
    "longest_trending": [
      {
        "rank": 0,
        "name": "string",
        "type": "hashtag",
        "clean_name": "string",
        "description": "string",
        "post_url": "https://example.com/...",
        "current_rank": 0,
        "peak_rank": 0,
        "hours_trending": 0,
        "rank_change": "string",
        "status": "NEW",
        "tweet_count": "string",
        "sample_tweets": [
          {
            "post_id": "1234567890",
            "post_url": "https://example.com/...",
            "author_username": "string",
            "author_name": "string",
            "author_id": "1234567890",
            "author_profile_image": "string",
            "text": "string",
            "embedded_hashtags": [
              "string"
            ],
            "create_time": "string",
            "reply_count": 0,
            "retweet_count": 0,
            "like_count": 0,
            "quote_count": 0,
            "view_count": 0,
            "save_count": 0,
            "is_retweet": false,
            "is_pinned": false
          }
        ]
      }
    ],
    "new_trends": [
      {
        "name": "string",
        "rank": 0,
        "type": "hashtag",
        "post_url": "https://example.com/..."
      }
    ],
    "hourly_timeline": [
      {
        "time": "string",
        "top_trends": [
          "string"
        ]
      }
    ]
  },
  "_metadata": {
    "request_id": "3f6c1a2e-8b4d-4c1e-9a7f-2d5e6b7c8d9e",
    "execution_time_ms": 842,
    "endpoint": "X (Twitter) Trends",
    "mode": "live",
    "format": "json",
    "timestamp": "2026-01-01T12:00:00+00:00"
  }
}

Data

X (Twitter) Trends API response (structured JSON)

Every response follows the same schema, so you can map it once and rely on it.

Response fields

locationlocation_slugsource_urlscraped_attotal_trendstotal_hashtagstotal_topicstop_hashtagspopular_topicsall_trendslongest_trendingnew_trendshourly_timeline

Features

X (Twitter) Trends API features that make scraping easy

No proxies or blocks to manage

DataGuru handles proxies, retries and anti-bot measures for you. You just send a request.

Clean, structured JSON

Every response uses the same 13 fields, so your parser never breaks.

One simple request

Call the endpoint and get results back. No browser automation or HTML parsing on your side.

Use cases

What you can build with the X (Twitter) Trends API

Influencer discovery

Find creators by audience, topic and engagement to build better campaigns.

Brand monitoring

Follow mentions and conversations about your brand as they happen.

Audience research

Understand who engages with you and your competitors.

Lead enrichment

Who it's for

Built for teams of every size and background

Social media managers
Influencer agencies
Brand teams
Sales & RevOps teams
Market researchers
Recruiters
Data engineers
Analytics startups

Get started

Start using the X (Twitter) Trends API in minutes

1
Create a free account
Sign up in seconds and get $1.00 of free balance to test with.
2
Copy your API key
Generate a key in the Developer Portal and send it in the Authorization header.
3
Send a request
Call POST /api/v1/x/trends with your parameters.

Pricing

Transparent & simple pricing

No subscription, no monthly minimum. Add funds to your balance and pay only for the requests you make.

Pay as you go

X (Twitter) Trends

$0.02 / req

$1.00 free balance on sign-up
60 requests per minute
10,000 requests per day
Sync and async requests

FAQ

Frequently asked questions

The X (Twitter) Trends API costs $0.02 per successful request, deducted from your prepaid balance. There is no subscription or monthly minimum. New accounts get $1.00 of free balance to try it.

More APIs

Other APIs you might need

Social Media

Try the X (Twitter) Trends API for free!

Create an account and get $1.00 of free balance to test it. No credit card required.

Name	Type	Description
include_tweets	boolean	Whether to include sample tweets for the top trends.
limit	integer	Maximum number of trending items to return (1-100).
location	string	Country name, country code, or "worldwide" (e.g. us, uk, worldwide).
tweets_limit	integer	Number of sample tweets per trend if include_tweets is true (1-10).

X (Twitter) Trends API

X (Twitter) Trends API response (structured JSON)

Response fields

X (Twitter) Trends API features that make scraping easy

No proxies or blocks to manage

Clean, structured JSON

One simple request

What you can build with the X (Twitter) Trends API

Influencer discovery

Brand monitoring

Audience research

Lead enrichment

Built for teams of every size and background

Start using the X (Twitter) Trends API in minutes

Create a free account

Copy your API key

Send a request

Transparent & simple pricing

Frequently asked questions

Other APIs you might need

Instagram Profile

Instagram Post

Instagram Comments

Try the X (Twitter) Trends API for free!

Request parameters

Sync or async

Built to scale

Pay only for what you use

Trend analysis

Competitor benchmarking

Get structured JSON

TikTok Profile

TikTok Post

Reddit Post