@apicity/omkar

Omkar Cloud TikTok Scraper provider: trending and Explore feeds by country.

Omkar Cloud's TikTok Scraper scrapes TikTok live on every call, so a feed call returns a fresh batch each time. The key goes in the API-Key header. The free plan allows 1,000 successful (HTTP 200) requests a month; errors are not charged, and GET https://tiktok-scraper.omkar.cloud/account/usage reports usage without spending a request. Every gateway error is JSON with a stable code (missing_api_key, invalid_api_key, quota_exceeded, rate_limited, ...), which rejects with OmkarError (code). Media and subtitle links are signed TikTok CDN URLs that expire.

Runtime dependencies:

• zod@^4.6.6 — request schemas attached to endpoint methods as .schema

Installation

npm install @apicity/omkar
# or
pnpm add @apicity/omkar

Quick Start

import { createOmkar } from "@apicity/omkar";

const omkar = createOmkar({ apiKey: process.env.OMKAR_API_KEY! });

API Reference

3 endpoints across 1 group. Each method mirrors an upstream URL path.

feed

const feed = await omkar.feed.explore({ country: "TH", category: "all" });

const categories = await omkar.feed.explore.categories();

const feed = await omkar.feed.trending({ country: "TH" });

Part of the apicity monorepo.

License

MIT — see LICENSE.