# TikData

> One authenticated API for social post data across TikTok, Instagram, YouTube and X. Paste a post or profile URL, get the same normalized JSON back — every engagement stat each platform exposes, deleted content as a real 404, per-key cost attribution priced live against the provider's volume-discount tiers.

Base URL: https://tikdata.io — all endpoints live under /v1/ and need a bearer key of the form thr_live_… (see Authentication). Every document below is served as raw Markdown at its .md URL.

## Start here

- [Authentication](https://tikdata.io/docs/authentication.md): bearer keys, x-api-key, the admin token, scopes, and every 401/403 shape
- [Errors](https://tikdata.io/docs/errors.md): status codes, why deleted content is a 404 and never zeroes, per-item error codes for batch endpoints, what private-vs-deleted can and cannot be known

## Posts

- [GET /v1/post](https://tikdata.io/docs/post.md): one post from any platform, normalized — views, likes, comments, shares, saves, reposts, quotes, downloads, author, cover, created time
- [POST /v1/posts](https://tikdata.io/docs/posts.md): up to 500 URLs, fanned out server-side under the rate gate, per-item ok flags, same shape as /v1/post
- [POST /v1/videos/bulk_stats](https://tikdata.io/docs/videos-bulk-stats.md): up to 100 videos by {platform, id|url}, flattened to one row per video, per-item error codes

## Creators

- [GET /v1/profile](https://tikdata.io/docs/profile.md): a creator — handle, name, bio, avatar, verified, private, followers, following, posts, lifetime likes/views
- [GET /v1/creator/stats](https://tikdata.io/docs/creator-stats.md): followers plus everything a creator published in the last N days and how it performed; walks the feed with per-platform paging

## Pass-through

- [ANY /v1/raw/{path}](https://tikdata.io/docs/raw.md): verbatim proxy to any upstream endpoint, attributed to the caller's key; drop-in migration for existing consumers

## Keys and cost

- [GET /v1/whoami](https://tikdata.io/docs/whoami.md): which key and project am I; the health check
- [GET /v1/usage](https://tikdata.io/docs/usage.md): per-key calls and cost for a day, priced live at read time against account volume; admin sees every key
- [GET /v1/account](https://tikdata.io/docs/account.md): the provider's live account meter, price-table reconstruction ratio, live discount tiers (admin)
- [/v1/keys](https://tikdata.io/docs/keys.md): mint, list, disable and delete keys (admin); there is also a browser console at https://tikdata.io/admin

## Optional

- [README](https://github.com/Jkratz01/tikdata#readme): architecture, environment, the database split, why counts are stored but cost never is, and the verified provider quirks behind every field path