X Trends Lookup by Country, City & WOEID

What it returns

10 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

• type
• location
• rank
• trend
• trendType
• countryCode
• locationCount
• searchUrl
• asOf
• collectedAt

Not in the schema among the core X (Twitter) fields: post_id, text, author, posted_at, likes, reposts, url. The field matrix shows which other tools return them.

How it differs from the other X (Twitter) Actors

Among the 12 catalogue Actors for X (Twitter) with a published schema, only this one returns location, trend, locationCount, asOf.

Pick another Actor if you need

Input

Example input

Built from the input form's published example values and defaults.

{
  "mode": "trends",
  "locations": [
    "Worldwide"
  ],
  "allLocations": false,
  "maxTrendsPerLocation": 3,
  "excludeHashtags": false,
  "trendNameContains": [],
  "dedupeAcrossLocations": false,
  "includeSearchUrls": true,
  "placeTypeFilter": "all"
}

Run it from code or an AI agent

The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "trends",
    "locations": [
        "Worldwide"
    ],
    "allLocations": False,
    "maxTrendsPerLocation": 3,
    "excludeHashtags": False,
    "trendNameContains": [],
    "dedupeAcrossLocations": False,
    "includeSearchUrls": True,
    "placeTypeFilter": "all"
}

run = client.actor("nimbryxo-studio/x-trends-lookup-by-country-city-and-woeid").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "trends",
    "locations": [
        "Worldwide"
    ],
    "allLocations": false,
    "maxTrendsPerLocation": 3,
    "excludeHashtags": false,
    "trendNameContains": [],
    "dedupeAcrossLocations": false,
    "includeSearchUrls": true,
    "placeTypeFilter": "all"
};

const run = await client.actor("nimbryxo-studio/x-trends-lookup-by-country-city-and-woeid").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~x-trends-lookup-by-country-city-and-woeid/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"trends","locations":["Worldwide"],"allLocations":false,"maxTrendsPerLocation":3,"excludeHashtags":false,"trendNameContains":[],"dedupeAcrossLocations":false,"includeSearchUrls":true,"placeTypeFilter":"all"}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/x-trends-lookup-by-country-city-and-woeid",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

What a run costs

The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.

• Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
• The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
• Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
• Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.

Where it fits among X (Twitter) routes

It ranks 12 of 12 catalogue Actors for X (Twitter) on the published formula (fields, price, reliability, freshness). Its line is highlighted on the map.

What people use it for

• Track local trending topics
• Collect trend rankings
• Find supported trend locations

Other catalogue Actors for X (Twitter)

Similar Actors

Questions people ask

Sources

• X Trends Lookup by Country, City & WOEID on Apify Store
• Published build with input and output schema (JSON)
• X API v2 documentation