TikTok API

The unofficial TikTok library works until you try to run it as a service: sessions expire, endpoints throttle, and nobody wants to babysit it. This wraps trending, users, videos, hashtags, search, and sounds behind a FastAPI service that behaves like an API you could bill for.

For whom: people building on TikTok data without an official partner key. Constraints: API-key auth, per-endpoint rate limiting, automatic token rotation with health monitoring, and short-link resolution.

• FastAPI over Flask. Typed request models and OpenAPI for free.

• Playwright-backed sessions with rotation. A pool of tokens, each health-checked, rotated before it dies rather than after.

• Redis for rate limits and caches. Per-endpoint budgets, so a hashtag crawl cannot starve search.

• nginx in front, Docker around it. Deployable in one compose file.

635 image pulls on Docker Hub from an 11-commit project. Enough people had the same problem.

Nothing reported yet, which for an unofficial wrapper means it has not been running long enough. The first thing I would fix: token health is checked on a timer, so a token that dies between checks still serves a few failed requests before rotation kicks in. Rotating on the first upstream failure is the next change.