Pricing

from $0.75 / 1,000 results

X Trending Topics Scraper

Scrape trending topics from X (formerly Twitter) by location. Extract trend names, tweet volumes, categories, and rankings. Supports location-specific trends using WOEID (Where On Earth ID) codes.

Pricing

from $0.75 / 1,000 results

Rating

0.0

(0)

Developer

Donny Nguyen

Actor stats

Bookmarked

Total users

Monthly active users

2 days ago

Last modified

Categories

Social media

News

You can access the X Trending Topics Scraper programmatically from your own applications by using the Apify API. You can also choose the language preference from below. To use the Apify API, you’ll need an Apify account and your API token, found in Integrations settings in Apify Console.

Python

JavaScript

CLI

OpenAPI

HTTP

MCP

{
  "openapi": "3.0.1",
  "info": {
    "version": "1.0",
    "x-build-id": "Iyzb30TjDYyNeTEnb"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/consummate_mandala~x-trending-topics-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-consummate_mandala-x-trending-topics-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/consummate_mandala~x-trending-topics-scraper/runs": {
      "post": {
        "operationId": "runs-sync-consummate_mandala-x-trending-topics-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/consummate_mandala~x-trending-topics-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-consummate_mandala-x-trending-topics-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "urls": {
            "title": "X Explore/Trending URLs",
            "type": "array",
            "description": "List of X/Twitter explore or trending page URLs to scrape. Defaults to the main X explore/trending page. You can also provide location-specific trending URLs.",
            "default": [
              {
                "url": "https://x.com/explore/tabs/trending"
              }
            ],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "locations": {
            "title": "Locations (WOEID)",
            "type": "array",
            "description": "List of Where On Earth IDs (WOEID) to get location-specific trends. Common WOEIDs: 1 (Worldwide), 23424977 (United States), 23424975 (United Kingdom), 23424856 (Japan), 23424829 (Germany), 23424848 (India), 23424950 (Spain), 23424833 (France), 23424768 (Brazil), 23424803 (Canada). Leave empty to use the default/global trends.",
            "items": {
              "type": "integer"
            },
            "default": [
              1
            ]
          },
          "maxResults": {
            "title": "Max Results",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of trending topics to extract. X typically shows 20-30 trends per location. Set to 0 for all available trends.",
            "default": 100
          },
          "waitForSelector": {
            "title": "Wait For Selector",
            "type": "string",
            "description": "CSS selector to wait for before extracting trends. Override only if the default selector does not work. Leave empty to use the built-in detection logic."
          },
          "useResidentialProxy": {
            "title": "Use Residential Proxy",
            "type": "boolean",
            "description": "Enable residential proxies to bypass X's anti-bot protections. Highly recommended for reliable scraping. Uses more compute units but significantly improves success rates.",
            "default": false
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

X/Twitter Trending Topics Scraper - Trends Data OpenAPI definition

OpenAPI is a standard for designing and describing RESTful APIs, allowing developers to define API structure, endpoints, and data formats in a machine-readable way. It simplifies API development, integration, and documentation.

OpenAPI is effective when used with AI agents and GPTs by standardizing how these systems interact with various APIs, for reliable integrations and efficient communication.

By defining machine-readable API specifications, OpenAPI allows AI models like GPTs to understand and use varied data sources, improving accuracy. This accelerates development, reduces errors, and provides context-aware responses, making OpenAPI a core component for AI applications.

You can download the OpenAPI definitions for X Trending Topics Scraper from the options below:

OpenAPI.json

If you’d like to learn more about how OpenAPI powers GPTs, read our blog post.

You can also check out our other API clients:

X Trending Topics Scraper API in Python

X Trending Topics Scraper API in JavaScript

X Trending Topics Scraper API through CLI

X Trending Topics Scraper API

X Trending Topics Scraper

tropical_quince/x-trending-topics-scraper

Scrape X/Twitter trending topics by location. Extract trend names, tweet volumes, categories, and rankings.

Donny Nguyen

Twitter Trends Scraper

scrapio/twitter-trends-scraper

Scrapes trending topics from Twitter X by region or worldwide, capturing trend names, tweet volumes, related hashtags, ranking positions, and trend URLs. Ideal for real-time monitoring, market research, content planning, and automated tracking of Twitter X trend insights.

Scrapio

Twitter(X) Trends Location Extractor (Rich Metadata) cookieless

patient_discovery/twitter-trends-by-location

Extract high-fidelity Twitter (X.com) trending topics with granular location-specific metadata. Captures hidden engagement metrics, timestamps, and comprehensive trend volumes for precise marketing and content strategy analysis.

Surge Street

Twitter-X Trends Scraper | Apify Actor

yasir-on-apify/twitter-x-trends-scraper-apify-actor

Just $0.0005/Trend. Scrape Twitter (X.com) trends & trending topics instantly with this powerful Apify actor. Get real-time hashtags, tweet volumes, ranks, & categories from 60+ countries. Perfect for social media, viral content strategy, SEO keyword research, market analysis, and trend forecasting.

Yasir

Twitter Trends Scraper

scrapier/getdaytrends-trending-scraper

Track and analyze Twitter trends with the Twitter Trends Scraper. Extract trending hashtags, topics, tweet volumes, and timestamps from any location. Ideal for social media monitoring, market research, and content strategy. Fast, reliable, and scalable for global or local trend tracking.

Scrapier

Twitter Trends Scraper

scraper-engine/twitter-trends-scraper

Twitter Trends Scraper extracts trending topics from Twitter worldwide or by region. Get trend names, tweet volumes, and links. Ideal for social listening, content strategy, and research. Export data in JSON, CSV, or Excel.

Scraper Engine

5.0

X (Twitter) Trending Topics Scraper

motivated_fellow/x-twitter-trending-topics-scraper

Scrape trending categories and topics from X.com for any country. Features advanced "Nuclear Click" technology for 100% accuracy, smart waiting for high speed, and clean JSON/CSV export.

Akhil

Twitter/X Scraper - Tweets, Profiles & Trends

viralanalyzer/twitter-scraper

Scrape Twitter/X: tweets, user profiles, followers, hashtags, and trending topics.

viralanalyzer

Twitter Trends Scraper (Cookieless)

mayank.chaba1996/twitter-trends-by-location

Scrape Twitter trends in bulk with zero-config API. Fast, automated export of location-specific trending topics and search volumes for targeted marketing pipelines.

Mayank Chaba

Twitter Trending Topics Scraper 🌎

easyapi/twitter-trending-topics-scraper

Monitor Twitter trending topics across 60+ countries worldwide. Get real-time insights into what's buzzing on Twitter with tweet volumes and timestamps. Perfect for social media analysts, marketers, and researchers tracking global social trends. 🌎