Twitter (X) Hashtag Popularity Tracker — API Guide

import os, requests
from collections import Counter, defaultdict
from datetime import datetime, timedelta

HEADERS = {"X-API-Key": os.environ["TWITTERAPI_IO_KEY"]}
BASE = "https://api.twitterapi.io"

def snapshot(hashtag: str, since_days: int = 1) -> dict:
    since = (datetime.utcnow() - timedelta(days=since_days)).strftime("%Y-%m-%d")
    tweets, cursor = [], None
    for _ in range(50):
        params = {"query": f"#{hashtag} since:{since}"}
        if cursor: params["cursor"] = cursor
        r = requests.get(f"{BASE}/twitter/tweet/advanced_search", headers=HEADERS, params=params, timeout=15)
        r.raise_for_status()
        resp = r.json()
        tweets.extend(resp.get("tweets", []))
        cursor = resp.get("next_cursor")
        if not cursor: break

    volume = len(tweets)
    reach = sum((t.get("author", {}).get("followers_count") or 0) for t in tweets)
    engagement = sum((t.get("favorite_count", 0) + t.get("retweet_count", 0)) for t in tweets)
    authors = len(set(t.get("author", {}).get("userName") for t in tweets if t.get("author")))

    return {
        "hashtag": hashtag, "since_days": since_days,
        "volume": volume, "reach": reach, "engagement": engagement,
        "unique_authors": authors,
        "avg_engagement_per_tweet": engagement / max(volume, 1),
    }

snap = snapshot("OpenAI", since_days=1)
print(snap)
# Cost per twitterapi.io/pricing: volume × $0.00015

# 30-day historical hashtag popularity — one-shot pull.
import os, requests, csv
from datetime import date, timedelta
from pathlib import Path

HEADERS = {"X-API-Key": os.environ["TWITTERAPI_IO_KEY"]}
BASE = "https://api.twitterapi.io"

def pull_day(hashtag: str, d: date) -> tuple[int, int, int]:
    query = f"#{hashtag} since:{d} until:{d + timedelta(days=1)}"
    n, reach, engagement, cursor = 0, 0, 0, None
    for _ in range(50):
        params = {"query": query}
        if cursor: params["cursor"] = cursor
        r = requests.get(f"{BASE}/twitter/tweet/advanced_search", headers=HEADERS, params=params, timeout=15)
        r.raise_for_status()
        resp = r.json()
        for t in resp.get("tweets", []):
            n += 1
            reach += (t.get("author", {}).get("followers_count") or 0)
            engagement += t.get("favorite_count", 0) + t.get("retweet_count", 0)
        cursor = resp.get("next_cursor")
        if not cursor: break
    return n, reach, engagement

HASHTAG = "OpenAI"
END = date.today()
START = END - timedelta(days=30)

out = Path(f"{HASHTAG.lower()}_popularity_30d.csv")
with open(out, "w") as f:
    w = csv.writer(f)
    w.writerow(["date", "volume", "reach", "engagement"])
    d = START
    total = 0
    while d < END:
        n, r_, e = pull_day(HASHTAG, d)
        w.writerow([d.isoformat(), n, r_, e])
        total += n
        print(f"  {d}: {n:,} tweets, reach {r_:,}, engagement {e:,}")
        d += timedelta(days=1)

print(f"\n30-day total: {total:,} tweets")
print(f"Cost per twitterapi.io/pricing: {total} × $0.00015 = ${total * 0.00015:.2f}")