Threads viewer: how to view Threads without an account

curl "https://api.toolzerhub.com/v1/threads/profile?username=mosseri" \
  -H "x-api-key: $TOOLZERHUB_API_KEY"

import csv
import os
import sys
import time
from datetime import datetime, timezone

import requests

API = "https://api.toolzerhub.com/v1/threads"
KEY = os.environ.get("TOOLZERHUB_API_KEY")
calls = 0


def cell(value):
    # A leading = + - or @ would run as a formula when the CSV opens in a spreadsheet.
    return "'" + value if isinstance(value, str) and value[:1] in ("=", "+", "-", "@") else value


def get(path, params, tries=4):
    global calls
    calls += 1
    # 429 and 503 are worth a retry; the body says how long to wait.
    for attempt in range(tries):
        r = requests.get(f"{API}/{path}", params=params, headers={"x-api-key": KEY}, timeout=90)
        if r.status_code in (429, 503) and attempt < tries - 1:
            wait = int(((r.json().get("error") or {}).get("details") or {}).get("retryAfter") or r.headers.get("Retry-After") or 5 * (attempt + 1))
            time.sleep(min(wait, 60))
            continue
        r.raise_for_status()
        return r.json()["data"]


def posts(user_id, max_pages):
    cursor = None
    for _ in range(max_pages):
        params = {"user_id": user_id}
        if cursor:
            params["end_cursor"] = cursor
        page = get("profile/posts", params)
        for edge in page["edges"]:
            for item in edge["node"].get("thread_items") or []:
                yield item["post"]
        info = page.get("page_info") or {}
        if not info.get("has_next_page"):
            break
        cursor = info["end_cursor"]


def row(post):
    info = post.get("text_post_app_info") or {}
    return {
        "posted_at": datetime.fromtimestamp(post["taken_at"], timezone.utc).isoformat(),
        "text": cell((post.get("caption") or {}).get("text", "")),
        "likes": post.get("like_count"),
        "replies": info.get("direct_reply_count"),
        "reposts": info.get("repost_count"),
        "url": f"https://www.threads.com/@{post['user']['username']}/post/{post['code']}",
    }


def main(username, max_pages="20", out=None):
    profile = get("profile", {"username": username})
    if not profile:
        sys.exit(f"no public Threads profile for {username}")
    seen, rows = set(), []
    for post in posts(profile["id"], int(max_pages)):
        if post["code"] not in seen and post["user"]["username"] == profile["username"]:
            seen.add(post["code"])
            rows.append(row(post))
    out = out or f"{profile['username']}.csv"
    with open(out, "w", newline="", encoding="utf-8") as f:
        writer = csv.DictWriter(f, fieldnames=list(rows[0]) if rows else ["url"])
        writer.writeheader()
        writer.writerows(rows)
    print(f"{profile['username']}: {profile.get('follower_count')} followers, {len(rows)} posts in {calls} calls, saved to {out}")


if __name__ == "__main__":
    if not KEY or len(sys.argv) < 2:
        sys.exit("usage: TOOLZERHUB_API_KEY=... python threads_posts.py USERNAME [max_pages] [file.csv]")
    main(*sys.argv[1:])

export TOOLZERHUB_API_KEY=your_key
python threads_posts.py mosseri 30