Introduction

The Omar-Thing API returns TikTok data over HTTPS. All endpoints live under a single base URL and respond with JSON.

Copyhttps://dev.omar-thing.site/api/v1

To obtain a key, subscribe to a plan on Patreon; the key is created and emailed to you. Your subscription tier maps to a plan by price.

Authentication

Every endpoint except /endpoints requires your API key. Provide it as a query parameter or a request header.

CopyGET /api/v1/profile?username=tiktok&key=YOUR_API_KEY
GET /api/v1/profile?username=tiktok&api_key=YOUR_API_KEY

X-API-Key: YOUR_API_KEY

Pagination

List endpoints return a single page per request. To fetch the next page, send the returned next_cursor value as the cursor parameter. Continue until has_more is false.

Copy{
  "next_cursor": "50",
  "has_more": true,
  "count": 50,
  "followers": [ ]
}

Clean format

By default, data endpoints return TikTok's complete response. Append format=clean to receive a reduced set of the most common fields. For comments, the clean format also includes nested replies.

CopyGET /api/v1/profile?username=tiktok&key=YOUR_API_KEY
GET /api/v1/profile?username=tiktok&format=clean&key=YOUR_API_KEY

Rate limits

Two limits apply, both set by your plan: a per-minute rate and a per-day cap. There is no overall (monthly/total) cap — that is unlimited. Exceeding either returns HTTP 429 with a Retry-After header indicating how many seconds to wait. Use /usage to view your current consumption.

Errors

Errors return the relevant HTTP status with a stable code and a human-readable message.

Support

Have a question or hit a problem? Reach out: