Omar-Thing API
Public TikTok data as JSON: profiles, posts, comments, search, live chat and more. 43 endpoints, one base URL, one key.
https://dev.omar-thing.site/api/v1Pick a plan on Patreon. Your key arrives by email.
Send the key in the X-API-Key header with any endpoint.
dataEvery success has the same shape. Add format=clean for short answers.
Authentication
Every endpoint needs your key. The header is the safest place for it; the query string works too.
curl "https://dev.omar-thing.site/api/v1/profile?username=tiktok&format=clean" \ -H "X-API-Key: YOUR_API_KEY" # same call with the key in the URL https://dev.omar-thing.site/api/v1/profile?username=tiktok&key=YOUR_API_KEY
Response shape
Success and error bodies look like this on every endpoint.
{ "status": "success", "data": { … }, "request_id": "21fe4393…" }
{ "status": "error", "code": "NOT_FOUND", "message": "Video not found." }Rate limits
Each plan has a per-minute rate and a daily cap. There is no monthly cap. Going over returns 429 with a Retry-After header. Check where you stand with Key usage.
| Plan | Per minute | Per day | Per month |
|---|---|---|---|
| Lite | 10 | 3,000 | Unlimited |
| Basic | 40 | 10,000 | Unlimited |
| Pro | 70 | 25,000 | Unlimited |
| Premium + | 150 | 50,000 | Unlimited |
| Enterprise | 500 | 150,000 | Unlimited |
| Enterprise + | 1,250 | 1,000,000 | Unlimited |
Errors
Errors use the matching HTTP status, a stable code you can check in your program, and a readable message.
| HTTP | Code | What happened |
|---|---|---|
| 401 | MISSING_KEY | No API key was sent. |
| 403 | INVALID_KEY | The key does not exist. |
| 403 | KEY_DISABLED | The key has been turned off. |
| 403 | KEY_EXPIRED | The subscription has ended. |
| 403 | ENDPOINT_NOT_ALLOWED | Your plan does not include this endpoint. |
| 404 | NOT_FOUND | The account, video or item was not found. |
| 424 | FETCH_FAILED | TikTok did not answer. Retry the call. |
| 429 | RATE_LIMIT_EXCEEDED | You hit a limit. Wait for the Retry-After seconds. |
Libraries and help
Python: pip install omarthing · JavaScript: npm install omarthing · Source on GitHub. Questions go to [email protected] or Telegram @f1ifb2.