@apicity/tiktok-creative-center

TikTok Creative Center trending videos provider (unofficial, undocumented endpoints).

These are unofficial, undocumented endpoints behind TikTok Creative Center's Trending videos page (https://ads.tiktok.com/creative/creativeCenter/trends/video), and TikTok can change or remove them without notice. They need no key. Without a TikTok One session every list holds the top 4 rows of page 1, whatever page and limit ask, and the client does not support a session cookie. TikTok sends item, author and creator ids as JSON numbers above 2^53, so itemID, authorID and creatorID come back as strings with every digit. Creative Center reports a failure as HTTP 200 with a nonzero BaseResp.StatusCode, which rejects with TiktokCreativeCenterError (statusCode). The overview reports the latest daily, weekly and monthly period ends, the values a list's periodEndTimestamp takes. A row's video page is https://www.tiktok.com/@<handlerName>/video/<itemID>; videoURL is a signed CDN link that expires.

Runtime dependencies:

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

Installation

npm install @apicity/tiktok-creative-center
# or
pnpm add @apicity/tiktok-creative-center

Quick Start

import { createTiktokCreativeCenter } from "@apicity/tiktok-creative-center";

const tiktokCreativeCenter = createTiktokCreativeCenter();

API Reference

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

ads

const top = await tiktokCreativeCenter.ads.creativeOne.report.creativeCenterGetTopContentsList({
  countryCode: "TH",
  periodDimension: 3,
  periodEndTimestamp: 1792886400,
  orderByMetric: 1,
});

const overview = await tiktokCreativeCenter.ads.creativeOne.report.getTopContentsOverview();

Part of the apicity monorepo.

License

MIT — see LICENSE.