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.

Can I send a large list of requests at once?

Yes. Upload a CSV file with one request per row and the X (Twitter) Trends API runs them in the background within 24 hours, at 50% of the normal price for each successful row. Use "Upload file" in the Playground or add ?batch=true to the API call.

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.003 / 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

Request parameters

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).

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.

Sync or async

Get the data in the response, or add ?async=true and poll the job for long-running requests.

Built to scale

Up to 60 requests per minute and 10,000 per day on this endpoint.

Pay only for what you use

No subscription or monthly minimum. Usage is deducted from your prepaid balance.

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

Add public profile details to the leads already in your CRM.

Trend analysis

Spot rising topics and formats before they peak.

Competitor benchmarking

Compare follower growth and engagement against competitors.

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.
4
Get structured JSON
Use the response straight away in your app, spreadsheet or pipeline.

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.003 / 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.003 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.