Twitter トレンド API：WOEID で X のトレンドを取得

#Twitter トレンド API のしくみ

トレンド API は場所を指定すると、そこで今人気のトピックを X の順位付きで返します。ログアウト状態の人の「話題を検索」タブに表示されるのと同じリストです。場所は WOEID（Where On Earth ID）で指定します。これは Yahoo の昔の地理データベースにあった地域コードで、X がそのまま使い続けています。1は世界全体、23424977は米国、2459115はニューヨークです。

このガイドでは、X が対応する任意の場所を、任意の数だけ、コードで取得する方法を説明します。

X 自身のエンドポイント GET /2/trends/by/woeid/{woeid} は、2023年12月8日に公式 X API の v2 に加わり（X の変更履歴（新しいタブで開きます））、2026年11月時点でも応答します。従量課金では1リクエスト$0.010で、事前に購入したクレジットから支払います（X の料金表（新しいタブで開きます））。表は、X のリファレンス（新しいタブで開きます）の残りの内容を2026年11月2日に確認してまとめたものです。

• エンドポイント

  公式 X API

  GET /2/trends/by/woeid/{woeid}

• アクセス

  公式 X API

  承認済みの開発者アカウント、Project と App、App のベアラートークン

• 1回の呼び出しで取れるトレンド数

  公式 X API

  既定で20件、max_trends を指定すると最大50件

• フィールド

  公式 X API

  trend_name。指定すれば tweet_count も

• 料金

  公式 X API

  1リクエスト$0.010

• レート制限

  公式 X API

  1アプリにつき15分あたり75リクエスト

このエンドポイントにないものが2つあります。トレンドのある場所の一覧を返すエンドポイントは、X の現行ドキュメントにありません。旧 v1.1 の trends/available は、ドキュメントから消えました。また、過去のリストを返す呼び出しもないため、トレンドの履歴は、自分でスナップショットを保存しないかぎり存在しません。

#Sorsa API で任意の場所のトレンドを取得する

開発者アカウントなしで、トレンドのリストをコードで取得するなら、Twitter（X）API 兼スクレイピングツールである Sorsa API を使います。GET /trends は同じ WOEID を受け取り、その場所の X のリストを1リクエストで返します。料金は1,000リストあたり$1.40からで、公式 X API の$10.00より安く、全プランで毎秒20リクエストです。

1. キーを取得する。 サインアップして、ダッシュボードから API キーをコピーします。100回分の無料リクエストは最初から付いていて、カードは不要です。

2. 場所を選ぶ。 下のファインダーで WOEID を調べます。世界全体なら 1 です。

3. リクエストを送る。 クエリ文字列に woeid を、ApiKey ヘッダーにキーを入れて GET /trends（新しいタブで開きます） を呼び出します。

   curl "https://api.sorsa.io/v3/trends?woeid=23424900" \
     -H "ApiKey: YOUR_API_KEY"
   

   {
     "trends": [
       {
         "name": "#FelizLunes",
         "query": "%23FelizLunes",
         "url": "https://x.com/search?q=%23FelizLunes"
       },
       {
         "name": "Liga MX",
         "query": "%22Liga+MX%22",
         "url": "https://x.com/search?q=%22Liga+MX%22"
       },
       {
         "name": "Buenos días",
         "query": "%22Buenos+d%C3%ADas%22",
         "url": "https://x.com/search?q=%22Buenos+d%C3%ADas%22"
       }
     ]
   }
   

   レスポンス全体を表示

4. リストを読む。 各トレンドには、name（X に表示されるトピック名）、query（その背後にある検索）、url（X 上の検索ページ）があります。順序は X のランキングどおりなので、先頭が最上位のトレンドです。

403はキーがないか、リクエストを使い切ったことを、401はキーが誤っていることを示します。429は1秒間に20リクエストを超えたことを示すので、1秒待って再送してください。失敗したリクエストに課金されることはなく、呼び出しのたびに新しいデータが返るので、1時間おいて2回呼べば、2つの異なるスナップショットが得られます。

#国や都市の WOEID を調べる

X がトレンドリストを公開しているのは467か所で、世界全体、62の国、404の都市です。それぞれに WOEID があります（X のトレンド地域一覧（新しいタブで開きます）。2025年8月に X から再取得した時点で変更はありませんでした）。どれも GET /trends で使えます。リストにない町には独自のトレンドがないので、最寄りの掲載都市か国を使ってください。

表には、よく聞かれる国と、それぞれの主要都市を載せています。467か所すべては、表の下のファインダーで調べられます。

• 世界全体

  WOEID

  1

  主要都市

  なし

  都市の WOEID

  なし

• 米国

  WOEID

  23424977

  主要都市

  ニューヨーク

  都市の WOEID

  2459115

• メキシコ

  WOEID

  23424900

  主要都市

  メキシコシティ

  都市の WOEID

  116545

• インド

  WOEID

  23424848

  主要都市

  ムンバイ

  都市の WOEID

  2295411

• 日本

  WOEID

  23424856

  主要都市

  東京

  都市の WOEID

  1118370

• 英国

  WOEID

  23424975

  主要都市

  ロンドン

  都市の WOEID

  44418

• ブラジル

  WOEID

  23424768

  主要都市

  サンパウロ

  都市の WOEID

  455827

• インドネシア

  WOEID

  23424846

  主要都市

  ジャカルタ

  都市の WOEID

  1047378

• トルコ

  WOEID

  23424969

  主要都市

  イスタンブール

  都市の WOEID

  2344116

• スペイン

  WOEID

  23424950

  主要都市

  マドリード

  都市の WOEID

  766273

• オーストラリア

  WOEID

  23424748

  主要都市

  シドニー

  都市の WOEID

  1105779

• 韓国

  WOEID

  23424868

  主要都市

  ソウル

  都市の WOEID

  1132599

メキシコには、全国のリスト 23424900 のほかに、23のトレンド都市があります。メキシコシティは 116545、グアダラハラは 124162、モンテレイは 134047 です。場所の名前や、ほかで見つけた WOEID をファインダーに入力すると、確認とリクエストのコピーができます。

知っておきたいこと

ウェブ上で転載されている WOEID の表には、隣り合うコードの取り違えが混じっています。23424868は韓国であってメキシコ（23424900）ではなく、23424775はカナダであってオーストラリア（23424748）ではありません。455825はリオデジャネイロであってサンパウロ（455827）ではなく、1105779はシドニーであって東京（1118370）ではありません。間違ったコードでも有効なリストは返りますが、別の場所のものです。保存する前に、名前を確認してください。

都市の対応状況には偏りがあります。米国には63、英国には26、メキシコには23のトレンド都市がある一方、62か国のうち9か国（ベルギー、デンマーク、ポルトガルなど）は、全国のリストしかありません。州や地域のリストは、X にはありません。

#各トレンドの背後にある投稿を取得する

トレンドの query はそのまま使える検索です。POST /search-tweets（新しいタブで開きます） に送ると、Sorsa API がそのトレンドの背後にある投稿を、1リクエストあたり約20件、投稿者のプロフィール全体付きで返します。"order": "popular" なら X が「トップ」に並べる投稿、"latest" なら新しい順です。

次のスクリプトは、メキシコのリストを読み、上位5つのトレンドそれぞれについて、上位3件の投稿を出力します。検索に渡す前に、URL エンコードされた query をコードがデコードします。

import requests
from urllib.parse import unquote_plus

API = "https://api.sorsa.io/v3"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
MEXICO = 23424900

def get_trends(woeid):
    r = requests.get(f"{API}/trends", params={"woeid": woeid},
                     headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()["trends"]

def top_posts(query):
    body = {"query": query, "order": "popular"}
    r = requests.post(f"{API}/search-tweets", json=body,
                      headers=HEADERS, timeout=30)
    r.raise_for_status()
    return r.json()["tweets"]

for rank, trend in enumerate(get_trends(MEXICO)[:5], start=1):
    query = trend["query"]
    if "%" in query:  # decode a URL-encoded search
        query = unquote_plus(query)
    print(f"{rank}. {trend['name']}")
    for post in top_posts(query)[:3]:
        user = post["user"]["username"]
        print(f"   @{user}: {post['likes_count']} likes")

// Node.js 18+, saved as trends.mjs
const API = "https://api.sorsa.io/v3";
const HEADERS = { ApiKey: "YOUR_API_KEY" };

async function getTrends(woeid) {
  const url = `${API}/trends?woeid=${woeid}`;
  const res = await fetch(url, { headers: HEADERS });
  if (!res.ok) throw new Error(`trends: ${res.status}`);
  return (await res.json()).trends;
}

async function topPosts(query) {
  const res = await fetch(`${API}/search-tweets`, {
    method: "POST",
    headers: { ...HEADERS, "Content-Type": "application/json" },
    body: JSON.stringify({ query, order: "popular" }),
  });
  if (!res.ok) throw new Error(`search: ${res.status}`);
  return (await res.json()).tweets;
}

const trends = (await getTrends(23424900)).slice(0, 5);
for (const [i, trend] of trends.entries()) {
  const query = trend.query.includes("%")
    ? decodeURIComponent(trend.query.replace(/\+/g, " "))
    : trend.query;
  console.log(`${i + 1}. ${trend.name}`);
  for (const post of (await topPosts(query)).slice(0, 3)) {
    console.log(`   @${post.user.username}: ${post.likes_count} likes`);
  }
}

トレンド関連の作業で、公式 X API の費用がかさむのは投稿の取得です。投稿1件あたり$0.005に加えて、2026年11月22日からは各投稿の投稿者もユーザー読み取りとして$0.010が課金されます（X の告知（新しいタブで開きます））。そのため、投稿者付きの投稿1,000件は$15.00になります。トレンドの背後にある投稿には、Sorsa API をお使いください。結果1,000件あたり$0.07からで、投稿者のプロフィールも含まれます。

トレンドの投稿を言語、日付、いいね数で絞り込むには、クエリに X の検索コマンドを追加します。ページネーションは ツイート検索 API のガイドで、すべてのフィルターは Twitter 検索コマンドの一覧で説明しています。

#トレンドの履歴を保存する

過去のリストを返すトレンド用エンドポイントはなく、公式のものも同じです。呼び出しはその時点のスナップショットなので、トレンドの履歴とは、保存しておいたスナップショットのことです。追跡する場所を定期的にポーリングし、各リストを時刻と順位とともに保存します。

X は、リストを再計算する間隔を公表していません。ダッシュボードや調査なら1時間ごとのスナップショットで十分で、速報性の高いトピックを追う報道機関は5〜15分おきにポーリングします。次のスクリプトは、4か所のスナップショットを1回分、SQLite に保存します。

import sqlite3
import time
from datetime import datetime, timezone

import requests

API = "https://api.sorsa.io/v3/trends"
HEADERS = {"ApiKey": "YOUR_API_KEY"}
PLACES = {"Worldwide": 1, "United States": 23424977,
          "Mexico": 23424900, "Japan": 23424856}

db = sqlite3.connect("trends.db")
db.execute("""CREATE TABLE IF NOT EXISTS trends (
    taken_at TEXT, woeid INTEGER, place TEXT,
    rank INTEGER, name TEXT, query TEXT)""")

now = datetime.now(timezone.utc)
taken_at = now.strftime("%Y-%m-%d %H:%M:%S")
for place, woeid in PLACES.items():
    params = {"woeid": woeid}
    r = requests.get(API, params=params, headers=HEADERS, timeout=30)
    if r.status_code == 429:  # over 20 requests in one second
        time.sleep(1)
        r = requests.get(API, params=params, headers=HEADERS, timeout=30)
    r.raise_for_status()
    rows = [(taken_at, woeid, place, rank, t["name"], t["query"])
            for rank, t in enumerate(r.json()["trends"], start=1)]
    db.executemany("INSERT INTO trends VALUES (?, ?, ?, ?, ?, ?)", rows)
db.commit()

たとえば cron から 0 * * * * python3 save_trends.py のように、1時間ごとに実行します。毎秒20リクエストなら、キー1つで467か所すべてを約23秒で読めるので、全リストでも1時間ごとの実行に収まります。1日たてば、次のクエリ1つで、メキシコで最も長くトレンド入りしたものがわかります。

SELECT name, COUNT(DISTINCT taken_at) AS hours
FROM trends
WHERE woeid = 23424900
  AND taken_at >= datetime('now', '-1 day')
GROUP BY name
ORDER BY hours DESC
LIMIT 10;

スナップショットより前の投稿には、トレンドの query を、2006年までさかのぼる検索として使えます。方法は過去の Twitter データで説明しています。新しいトピックがリストに入った瞬間に通知を受け取りたいなら、Twitter リアルタイム監視のように、各スナップショットを直前のものと比較します。

#トレンドデータの月額コスト

どちらの API もトレンドデータはリスト単位で課金されるので、月額は場所の数と更新回数の積です。25か所を1時間ごとに取得すると、月に18Kリストになり、公式 X API では$180、Sorsa API では$25.20からです。下で、自分の数字を試せます。

トレンド関連の作業を左右する項目はどれも、Sorsa API のほうが公式 X API より有利です。

• トレンドリスト1,000件あたりの料金

  Sorsa API

  $1.40から

  公式 X API

  $10.00

• トレンドの背後にある投稿、1,000件あたり

  Sorsa API

  $0.07から、投稿者込み

  公式 X API

  $5.00。11月22日からは投稿者込みで$15.00

• レート制限

  Sorsa API

  毎秒20リクエスト

  公式 X API

  1アプリにつき15分あたり75リクエスト

• 467か所を1周するのにかかる時間

  Sorsa API

  約23秒

  公式 X API

  約90分

• セットアップ

  Sorsa API

  API キー1つ

  公式 X API

  承認済みの開発者アカウント、アプリ、ベアラートークン

• X アカウントの要否

  Sorsa API

  不要

  公式 X API

  必要

トレンドのダッシュボード、報道機関向けのフィード、調査用アーカイブには Sorsa API をお使いください。X と同じ WOEID で、リストあたりの料金は約7分の1、すべてのトレンドの背後にある投稿も1,000件あたり$0.07からです。Sorsa API が X のログイン情報を求めることはないので、自分のアカウントが危険にさらされることもありません。

#最初のトレンドリストを取得する

任意の場所のトレンドリストは、1リクエストで取得できます。WOEID を選んで GET /trends を呼び出し、上位のクエリを POST /search-tweets に送れば、その背後にある投稿も取得できます。Sorsa API ならキー1つでどちらも実行でき、料金はリスト1,000件あたり$1.40から、投稿1,000件あたり$0.07からです。新規アカウントに付く100回分の無料リクエストで、最初の100リストを取得できます。カードは不要で、有効期限もありません。

#よくある質問