@apicity/tiktok-creative-center 0.0.0-stage → 0.20.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Justin Tanner
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,81 @@
-# Temporary Holding Version
+# @apicity/tiktok-creative-center
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[![npm](https://img.shields.io/npm/v/@apicity/tiktok-creative-center?color=cb0000)](https://www.npmjs.com/package/@apicity/tiktok-creative-center)
+[![dependencies](https://img.shields.io/badge/dependencies-1-blue)](package.json)
+[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue?logo=typescript&logoColor=white)](tsconfig.json)
+[![docs](https://img.shields.io/badge/docs-ads.tiktok.com-blue)](https://ads.tiktok.com/creative/creativeCenter/trends/video)
+
+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
+
+```bash
+npm install @apicity/tiktok-creative-center
+# or
+pnpm add @apicity/tiktok-creative-center
+```
+
+## Quick Start
+
+```typescript
+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
+
+<details>
+<summary><code>GET</code> <b><code>tiktok-creative-center.ads.creativeOne.report.creativeCenterGetTopContentsList</code></b></summary>
+
+<code>GET https://ads.tiktok.com/CreativeOne/Report/CreativeCenterGetTopContentsList{query}</code>
+
+Cost tier: <code>cheap</code>
+
+[Upstream docs ↗](https://ads.tiktok.com/creative/creativeCenter/trends/video)
+
+```typescript
+const top = await tiktokCreativeCenter.ads.creativeOne.report.creativeCenterGetTopContentsList({
+  countryCode: "TH",
+  periodDimension: 3,
+  periodEndTimestamp: 1792886400,
+  orderByMetric: 1,
+});
+```
+
+Source: [`packages/provider/tiktok-creative-center/src/tiktokCreativeCenter.ts`](src/tiktokCreativeCenter.ts)
+
+</details>
+
+<details>
+<summary><code>GET</code> <b><code>tiktok-creative-center.ads.creativeOne.report.getTopContentsOverview</code></b></summary>
+
+<code>GET https://ads.tiktok.com/CreativeOne/Report/GetTopContentsOverview</code>
+
+Cost tier: <code>cheap</code>
+
+[Upstream docs ↗](https://ads.tiktok.com/creative/creativeCenter/trends/video)
+
+```typescript
+const overview = await tiktokCreativeCenter.ads.creativeOne.report.getTopContentsOverview();
+```
+
+Source: [`packages/provider/tiktok-creative-center/src/tiktokCreativeCenter.ts`](src/tiktokCreativeCenter.ts)
+
+</details>
+
+Part of the [apicity](https://github.com/justintanner/apicity) monorepo.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

package/dist/src/example.d.ts

@@ -0,0 +1,12 @@
+export interface EndpointExample {
+    source: string;
+    payload: unknown;
+    /** Canonical cost tier of this endpoint (see @apicity/cost). */
+    tier: "cheap" | "expensive" | "prohibitive";
+    /** Whether an example runner may execute this by default (cheap only). */
+    runByDefault: boolean;
+}
+declare const EXAMPLES: Record<string, EndpointExample>;
+export default EXAMPLES;
+export declare function attachExamples<T>(provider: T): T;
+//# sourceMappingURL=example.d.ts.map

package/dist/src/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,gEAAgE;IAChE,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,CAAC;IAC5C,0EAA0E;IAC1E,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,QAAA,MAAM,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAsB7C,CAAC;AAEF,eAAe,QAAQ,CAAC;AAOxB,wBAAgB,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CA6ChD"}

package/dist/src/example.js

@@ -0,0 +1,108 @@
+// Auto-generated by `pnpm run gen:examples` — do not edit by hand.
+// Source: tests/recordings/<provider>_*/<test>_*/recording.har, plus static
+// examples for providers that intentionally avoid live-network recordings.
+//
+// Each entry is a green-path payload for one endpoint. `attachExamples`
+// walks the provider tree and hangs the matching entry off each endpoint
+// function as `.example`.
+const EXAMPLES = {
+    "GET ads.creativeOne.report.creativeCenterGetTopContentsList": {
+        "source": "tiktok-creative-center/top-contents-list-th-weekly-organic",
+        "payload": {
+            "countryCode": "TH",
+            "periodDimension": 3,
+            "periodEndTimestamp": 1792886400,
+            "orderByMetric": 1,
+            "organicOnly": true,
+            "contentLabelIDs": "",
+            "page": 1,
+            "limit": 20
+        },
+        "tier": "cheap",
+        "runByDefault": true
+    },
+    "GET ads.creativeOne.report.getTopContentsOverview": {
+        "source": "static:tiktok-creative-center-overview",
+        "payload": {},
+        "tier": "cheap",
+        "runByDefault": true
+    }
+};
+export default EXAMPLES;
+// Walks each "<METHOD> <dotPath>" key onto the provider's tree. Tries the
+// standard `provider.<method>.<dotPath>` shape first, then a few fallbacks
+// to cover providers with non-standard layouts (fal's `.run.` namespace,
+// kie's sub-providers, `free`'s flat root). Returns the same provider for
+// drop-in use as `return attachExamples({ ... });`.
+export function attachExamples(provider) {
+    const root = provider;
+    const HTTP_KEYS = new Set(["post", "get", "put", "delete", "patch", "head"]);
+    for (const [key, example] of Object.entries(EXAMPLES)) {
+        const sp = key.indexOf(" ");
+        if (sp < 0)
+            continue;
+        const method = key.slice(0, sp).toLowerCase();
+        const segs = key.slice(sp + 1).split(".");
+        const candidates = [
+            root[method],
+            root[method]?.run,
+            root,
+        ];
+        if (segs.length > 1) {
+            const sub = root[segs[0]];
+            if (sub && typeof sub === "object") {
+                const subMethod = sub[method];
+                if (subMethod)
+                    candidates.push({ __nested: subMethod, __segs: segs.slice(1) });
+            }
+        }
+        let attached = false;
+        for (const c of candidates) {
+            const fn = walkToFn(c, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                attached = true;
+                break;
+            }
+        }
+        if (attached)
+            continue;
+        for (const k of Object.keys(root)) {
+            if (HTTP_KEYS.has(k))
+                continue;
+            if (!segs.includes(k))
+                continue;
+            const sub = root[k];
+            if (!sub || typeof sub !== "object")
+                continue;
+            const subMethod = sub[method];
+            if (!subMethod)
+                continue;
+            const fn = walkToFn(subMethod, segs);
+            if (fn) {
+                Object.assign(fn, { example });
+                break;
+            }
+        }
+    }
+    return provider;
+}
+function walkToFn(start, segs) {
+    if (start && typeof start === "object" && "__nested" in start) {
+        const wrapper = start;
+        return walkToFn(wrapper.__nested, wrapper.__segs);
+    }
+    let cur = start;
+    for (const seg of segs) {
+        if (cur === null || cur === undefined)
+            return null;
+        const t = typeof cur;
+        if (t !== "object" && t !== "function")
+            return null;
+        cur = cur[seg];
+    }
+    return typeof cur === "function"
+        ? cur
+        : null;
+}
+//# sourceMappingURL=example.js.map

package/dist/src/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","sourceRoot":"","sources":["../../src/example.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,4EAA4E;AAC5E,2EAA2E;AAC3E,EAAE;AACF,wEAAwE;AACxE,yEAAyE;AACzE,0BAA0B;AAW1B,MAAM,QAAQ,GAAoC;IAChD,6DAA6D,EAAE;QAC7D,QAAQ,EAAE,4DAA4D;QACtE,SAAS,EAAE;YACT,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,CAAC;YACpB,oBAAoB,EAAE,UAAU;YAChC,eAAe,EAAE,CAAC;YAClB,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,EAAE;YACrB,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,EAAE;SACZ;QACD,MAAM,EAAE,OAAO;QACf,cAAc,EAAE,IAAI;KACrB;IACD,mDAAmD,EAAE;QACnD,QAAQ,EAAE,wCAAwC;QAClD,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,OAAO;QACf,cAAc,EAAE,IAAI;KACrB;CACF,CAAC;AAEF,eAAe,QAAQ,CAAC;AAExB,0EAA0E;AAC1E,2EAA2E;AAC3E,yEAAyE;AACzE,0EAA0E;AAC1E,oDAAoD;AACpD,MAAM,UAAU,cAAc,CAAI,QAAW;IAC3C,MAAM,IAAI,GAAG,QAAmC,CAAC;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACtD,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1C,MAAM,UAAU,GAAmB;YACjC,IAAI,CAAC,MAAM,CAAC;YACX,IAAI,CAAC,MAAM,CAAyC,EAAE,GAAG;YAC1D,IAAI;SACL,CAAC;QACF,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;gBACnC,MAAM,SAAS,GAAI,GAA+B,CAAC,MAAM,CAAC,CAAC;gBAC3D,IAAI,SAAS;oBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;QACH,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC;QACrB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC7B,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/B,QAAQ,GAAG,IAAI,CAAC;gBAChB,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,QAAQ;YAAE,SAAS;QACvB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;gBAAE,SAAS;YAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,SAAS;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,SAAS;YAC9C,MAAM,SAAS,GAAI,GAA+B,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,SAAS;gBAAE,SAAS;YACzB,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACrC,IAAI,EAAE,EAAE,CAAC;gBACP,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;gBAC/B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,IAAc;IAC9C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,UAAU,IAAK,KAAgB,EAAE,CAAC;QAC1E,MAAM,OAAO,GAAG,KAAgD,CAAC;QACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,GAAY,KAAK,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACnD,MAAM,CAAC,GAAG,OAAO,GAAG,CAAC;QACrB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,UAAU;YAAE,OAAO,IAAI,CAAC;QACpD,GAAG,GAAI,GAA+B,CAAC,GAAG,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,OAAO,GAAG,KAAK,UAAU;QAC9B,CAAC,CAAE,GAAuC;QAC1C,CAAC,CAAC,IAAI,CAAC;AACX,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,5 @@
+export { createTiktokCreativeCenter } from "./tiktokCreativeCenter.js";
+export { TiktokCreativeCenterError } from "./types.js";
+export type { TiktokCreativeCenterAdsNamespace, TiktokCreativeCenterAuthorInfo, TiktokCreativeCenterAuthorMetrics, TiktokCreativeCenterBaseResp, TiktokCreativeCenterCover, TiktokCreativeCenterCreativeOneNamespace, TiktokCreativeCenterEntity, TiktokCreativeCenterGetTopContentsListMethod, TiktokCreativeCenterGetTopContentsListRequest, TiktokCreativeCenterGetTopContentsListResponse, TiktokCreativeCenterGetTopContentsOverviewResponse, TiktokCreativeCenterItemInfo, TiktokCreativeCenterItemMetrics, TiktokCreativeCenterOptions, TiktokCreativeCenterOrderByMetric, TiktokCreativeCenterPagination, TiktokCreativeCenterPeriodDimension, TiktokCreativeCenterProvider, TiktokCreativeCenterReportNamespace, } from "./types.js";
+export { TiktokCreativeCenterGetTopContentsListRequestSchema, TiktokCreativeCenterOrderByMetricSchema, TiktokCreativeCenterPeriodDimensionSchema, } from "./zod.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AACpD,YAAY,EACV,gCAAgC,EAChC,8BAA8B,EAC9B,iCAAiC,EACjC,4BAA4B,EAC5B,yBAAyB,EACzB,wCAAwC,EACxC,0BAA0B,EAC1B,4CAA4C,EAC5C,6CAA6C,EAC7C,8CAA8C,EAC9C,kDAAkD,EAClD,4BAA4B,EAC5B,+BAA+B,EAC/B,2BAA2B,EAC3B,iCAAiC,EACjC,8BAA8B,EAC9B,mCAAmC,EACnC,4BAA4B,EAC5B,mCAAmC,GACpC,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,mDAAmD,EACnD,uCAAuC,EACvC,yCAAyC,GAC1C,MAAM,OAAO,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export { createTiktokCreativeCenter } from "./tiktokCreativeCenter.js";
+export { TiktokCreativeCenterError } from "./types.js";
+export { TiktokCreativeCenterGetTopContentsListRequestSchema, TiktokCreativeCenterOrderByMetricSchema, TiktokCreativeCenterPeriodDimensionSchema, } from "./zod.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAsBpD,OAAO,EACL,mDAAmD,EACnD,uCAAuC,EACvC,yCAAyC,GAC1C,MAAM,OAAO,CAAC"}

package/dist/src/tiktokCreativeCenter.d.ts

@@ -0,0 +1,3 @@
+import type { TiktokCreativeCenterOptions, TiktokCreativeCenterProvider } from "./types.js";
+export declare function createTiktokCreativeCenter(options?: TiktokCreativeCenterOptions): TiktokCreativeCenterProvider;
+//# sourceMappingURL=tiktokCreativeCenter.d.ts.map

package/dist/src/tiktokCreativeCenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktokCreativeCenter.d.ts","sourceRoot":"","sources":["../../src/tiktokCreativeCenter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,SAAS,CAAC;AAoDjB,wBAAgB,0BAA0B,CACxC,OAAO,GAAE,2BAAgC,GACxC,4BAA4B,CAgH9B"}

package/dist/src/tiktokCreativeCenter.js

@@ -0,0 +1,119 @@
+import { attachExamples } from "./example.js";
+import { TiktokCreativeCenterError } from "./types.js";
+import { TiktokCreativeCenterGetTopContentsListRequestSchema } from "./zod.js";
+const DEFAULT_USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/141.0.0.0 Safari/537.36";
+// The page whose data these endpoints serve; Creative Center expects the
+// browser headers that page sends.
+const TRENDS_PAGE = "https://ads.tiktok.com/creative/creativeCenter/trends/video";
+// TikTok sends these ids as JSON numbers above 2^53, which JSON.parse rounds.
+// Quoting them in the raw text keeps every digit. Inside a JSON string the
+// key's quotes are escaped, so only real keys match.
+const LARGE_ID_FIELDS = /"(itemID|authorID|creatorID)"(\s*):(\s*)(-?\d+)/g;
+// A fixed key order, so equal requests build equal URLs.
+const LIST_QUERY_KEYS = [
+    "countryCode",
+    "periodDimension",
+    "periodEndTimestamp",
+    "orderByMetric",
+    "organicOnly",
+    "contentLabelIDs",
+    "page",
+    "limit",
+];
+function isEnvelope(value) {
+    return typeof value === "object" && value !== null;
+}
+function parseKeepingIds(text) {
+    return JSON.parse(text.replace(LARGE_ID_FIELDS, '"$1"$2:$3"$4"'));
+}
+function listQuery(request) {
+    const params = new URLSearchParams();
+    for (const key of LIST_QUERY_KEYS) {
+        const value = request[key];
+        if (value !== undefined)
+            params.set(key, String(value));
+    }
+    const search = params.toString();
+    return search ? `?${search}` : "";
+}
+export function createTiktokCreativeCenter(options = {}) {
+    const baseURL = (options.baseURL ?? "https://ads.tiktok.com").replace(/\/+$/, "");
+    const doFetch = options.fetch ?? fetch;
+    const timeout = options.timeout ?? 30000;
+    const headers = {
+        "User-Agent": options.userAgent ?? DEFAULT_USER_AGENT,
+        Accept: "application/json, text/plain, */*",
+        "Accept-Language": "en-US,en;q=0.9",
+        Referer: TRENDS_PAGE,
+    };
+    async function getRequest(path, signal) {
+        const controller = new AbortController();
+        const relayAbort = () => controller.abort();
+        if (signal?.aborted)
+            controller.abort();
+        else
+            signal?.addEventListener("abort", relayAbort, { once: true });
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await doFetch(`${baseURL}${path}`, {
+                method: "GET",
+                headers,
+                signal: controller.signal,
+            });
+            const raw = await response.text();
+            let body = raw;
+            try {
+                body = parseKeepingIds(raw);
+            }
+            catch {
+                /* Keep non-JSON answers as text. */
+            }
+            if (!response.ok) {
+                throw new TiktokCreativeCenterError(`TikTok Creative Center error ${response.status}: ${raw.slice(0, 200)}`, response.status, body);
+            }
+            const base = isEnvelope(body) ? body.BaseResp : undefined;
+            if (typeof base?.StatusCode !== "number") {
+                throw new TiktokCreativeCenterError("TikTok Creative Center answered without BaseResp.StatusCode", response.status, body);
+            }
+            if (base.StatusCode !== 0) {
+                throw new TiktokCreativeCenterError(`TikTok Creative Center error ${base.StatusCode}: ${String(base.StatusMessage)}`, response.status, body, base.StatusCode);
+            }
+            return body;
+        }
+        catch (error) {
+            if (error instanceof TiktokCreativeCenterError)
+                throw error;
+            if (signal?.aborted)
+                throw new TiktokCreativeCenterError("TikTok Creative Center request aborted by caller", 499);
+            if (controller.signal.aborted)
+                throw new TiktokCreativeCenterError("TikTok Creative Center request timed out", 408);
+            throw new TiktokCreativeCenterError(`TikTok Creative Center request failed: ${error instanceof Error ? error.message : String(error)}`, 500);
+        }
+        finally {
+            clearTimeout(timer);
+            signal?.removeEventListener("abort", relayAbort);
+        }
+    }
+    return attachExamples({
+        ads: {
+            creativeOne: {
+                report: {
+                    // sig-ok: Creative Center's PascalCase path segments become camelCase keys.
+                    // GET https://ads.tiktok.com/CreativeOne/Report/CreativeCenterGetTopContentsList{query}
+                    // Docs: https://ads.tiktok.com/creative/creativeCenter/trends/video
+                    creativeCenterGetTopContentsList: Object.assign(async (request, signal) => {
+                        const query = listQuery(request);
+                        return getRequest(`/CreativeOne/Report/CreativeCenterGetTopContentsList${query}`, signal);
+                    }, { schema: TiktokCreativeCenterGetTopContentsListRequestSchema }),
+                    // sig-ok: Creative Center's PascalCase path segments become camelCase keys.
+                    // GET https://ads.tiktok.com/CreativeOne/Report/GetTopContentsOverview
+                    // Docs: https://ads.tiktok.com/creative/creativeCenter/trends/video
+                    getTopContentsOverview: async (signal) => {
+                        return getRequest("/CreativeOne/Report/GetTopContentsOverview", signal);
+                    },
+                },
+            },
+        },
+    });
+}
+//# sourceMappingURL=tiktokCreativeCenter.js.map

package/dist/src/tiktokCreativeCenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tiktokCreativeCenter.js","sourceRoot":"","sources":["../../src/tiktokCreativeCenter.ts"],"names":[],"mappings":"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"}

package/dist/src/types.d.ts

@@ -0,0 +1,132 @@
+import type { z } from "zod";
+import type { TiktokCreativeCenterGetTopContentsListRequestSchema, TiktokCreativeCenterOrderByMetricSchema, TiktokCreativeCenterPeriodDimensionSchema } from "./zod.js";
+/**
+ * `status` is the HTTP status, or 408 on timeout, 499 when the caller aborts
+ * and 500 when no response arrived. Creative Center also fails with HTTP 200
+ * and a nonzero `BaseResp.StatusCode`, which `statusCode` carries.
+ */
+export declare class TiktokCreativeCenterError extends Error {
+    readonly status: number;
+    readonly body?: unknown | undefined;
+    readonly statusCode?: number | undefined;
+    constructor(message: string, status: number, body?: unknown | undefined, statusCode?: number | undefined);
+}
+export interface TiktokCreativeCenterOptions {
+    baseURL?: string;
+    timeout?: number;
+    fetch?: typeof fetch;
+    /** Sent as `User-Agent`; defaults to a desktop Chrome string. */
+    userAgent?: string;
+}
+export type TiktokCreativeCenterPeriodDimension = z.infer<typeof TiktokCreativeCenterPeriodDimensionSchema>;
+export type TiktokCreativeCenterOrderByMetric = z.infer<typeof TiktokCreativeCenterOrderByMetricSchema>;
+export type TiktokCreativeCenterGetTopContentsListRequest = z.infer<typeof TiktokCreativeCenterGetTopContentsListRequestSchema>;
+/** `StatusCode` 0 is success; anything else rejects the call. */
+export interface TiktokCreativeCenterBaseResp {
+    StatusCode: number;
+    StatusMessage: string;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterCover {
+    format?: string;
+    imageUrl?: string;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterItemInfo {
+    /**
+     * A string: TikTok sends the id as a JSON number above 2^53, and the client
+     * quotes it before parsing so no digit is lost. The video page is
+     * `https://www.tiktok.com/@<handlerName>/video/<itemID>`.
+     */
+    itemID: string;
+    title?: string;
+    /** Unix seconds. */
+    createTime?: number;
+    coverURL?: string;
+    coverURLList?: TiktokCreativeCenterCover[];
+    /** A signed TikTok CDN MP4 link that expires. */
+    videoURL?: string;
+    /** A string, for the same reason as `itemID`. */
+    authorID?: string;
+    /** A string, for the same reason as `itemID`. */
+    creatorID?: string;
+    contentType?: number;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterItemMetrics {
+    videoViews?: number;
+    videoViewsLifeTime?: number;
+    organicVideoViews?: number;
+    organicVideoViewsLifeTime?: number;
+    engagementRate?: number;
+    engagementRateLifeTime?: number;
+    sixSecondsVTR?: number;
+    sixSecondsVTRLifeTime?: number;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterAuthorInfo {
+    handlerName?: string;
+    nickName?: string;
+    avatarURI?: string;
+    bio?: string;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterAuthorMetrics {
+    followers?: number;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterEntity {
+    itemInfo: TiktokCreativeCenterItemInfo;
+    itemMetrics?: TiktokCreativeCenterItemMetrics;
+    itemAuthorInfo?: TiktokCreativeCenterAuthorInfo;
+    itemAuthorMetrics?: TiktokCreativeCenterAuthorMetrics;
+    [key: string]: unknown;
+}
+/** Without a TikTok One session, `page` is 1 and `limit` 4 whatever was asked. */
+export interface TiktokCreativeCenterPagination {
+    limit: number;
+    page: number;
+    pageCount: number;
+    totalCount: number;
+    hasMore: boolean;
+    [key: string]: unknown;
+}
+/**
+ * A country or period without a list answers `StatusCode` 0 with neither
+ * `entityInfos` nor `pagination`.
+ */
+export interface TiktokCreativeCenterGetTopContentsListResponse {
+    BaseResp: TiktokCreativeCenterBaseResp;
+    entityInfos?: TiktokCreativeCenterEntity[];
+    pagination?: TiktokCreativeCenterPagination;
+    [key: string]: unknown;
+}
+/**
+ * Unix seconds that end the latest daily, weekly and monthly lists: the
+ * values `periodEndTimestamp` takes.
+ */
+export interface TiktokCreativeCenterGetTopContentsOverviewResponse {
+    BaseResp: TiktokCreativeCenterBaseResp;
+    lastDailyEndTimestamp?: number;
+    lastWeeklyEndTimestamp?: number;
+    lastMonthlyEndTimestamp?: number;
+    [key: string]: unknown;
+}
+export interface TiktokCreativeCenterGetTopContentsListMethod {
+    (request: TiktokCreativeCenterGetTopContentsListRequest, signal?: AbortSignal): Promise<TiktokCreativeCenterGetTopContentsListResponse>;
+    schema: typeof TiktokCreativeCenterGetTopContentsListRequestSchema;
+}
+export interface TiktokCreativeCenterReportNamespace {
+    creativeCenterGetTopContentsList: TiktokCreativeCenterGetTopContentsListMethod;
+    getTopContentsOverview(signal?: AbortSignal): Promise<TiktokCreativeCenterGetTopContentsOverviewResponse>;
+}
+export interface TiktokCreativeCenterCreativeOneNamespace {
+    report: TiktokCreativeCenterReportNamespace;
+}
+export interface TiktokCreativeCenterAdsNamespace {
+    creativeOne: TiktokCreativeCenterCreativeOneNamespace;
+}
+export interface TiktokCreativeCenterProvider {
+    ads: TiktokCreativeCenterAdsNamespace;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

@@ -0,0 +1,18 @@
+/**
+ * `status` is the HTTP status, or 408 on timeout, 499 when the caller aborts
+ * and 500 when no response arrived. Creative Center also fails with HTTP 200
+ * and a nonzero `BaseResp.StatusCode`, which `statusCode` carries.
+ */
+export class TiktokCreativeCenterError extends Error {
+    status;
+    body;
+    statusCode;
+    constructor(message, status, body, statusCode) {
+        super(message);
+        this.status = status;
+        this.body = body;
+        this.statusCode = statusCode;
+        this.name = "TiktokCreativeCenterError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAGhC;IACA;IACA;IAJlB,YACE,OAAe,EACC,MAAc,EACd,IAAc,EACd,UAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAC;QAJC,WAAM,GAAN,MAAM,CAAQ;QACd,SAAI,GAAJ,IAAI,CAAU;QACd,eAAU,GAAV,UAAU,CAAS;QAGnC,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF"}

package/dist/src/zod.d.ts

@@ -0,0 +1,14 @@
+import { z } from "zod";
+export declare const TiktokCreativeCenterPeriodDimensionSchema: z.ZodLiteral<3 | 1 | 2>;
+export declare const TiktokCreativeCenterOrderByMetricSchema: z.ZodLiteral<3 | 1 | 2>;
+export declare const TiktokCreativeCenterGetTopContentsListRequestSchema: z.ZodObject<{
+    countryCode: z.ZodString;
+    periodDimension: z.ZodLiteral<3 | 1 | 2>;
+    periodEndTimestamp: z.ZodNumber;
+    orderByMetric: z.ZodLiteral<3 | 1 | 2>;
+    organicOnly: z.ZodOptional<z.ZodBoolean>;
+    contentLabelIDs: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=zod.d.ts.map

package/dist/src/zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.d.ts","sourceRoot":"","sources":["../../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,yCAAyC,yBAInD,CAAC;AAEJ,eAAO,MAAM,uCAAuC,yBAIjD,CAAC;AAEJ,eAAO,MAAM,mDAAmD;;;;;;;;;iBAkC9D,CAAC"}

package/dist/src/zod.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+// Every value below was accepted by live calls on 2026-10-28. Creative Center
+// answers any other periodDimension or orderByMetric (0 and 4 were tried), or
+// a request without either, with BaseResp.StatusCode 38014004 "not supported
+// top contents setting".
+export const TiktokCreativeCenterPeriodDimensionSchema = z
+    .literal([1, 2, 3])
+    .describe("3 for the weekly list, 2 for the monthly list. 1 answered the weekly list on 2026-10-28.");
+export const TiktokCreativeCenterOrderByMetricSchema = z
+    .literal([1, 2, 3])
+    .describe("1 ranks by video views, 2 by engagement rate, 3 by six-second view-through rate.");
+export const TiktokCreativeCenterGetTopContentsListRequestSchema = z.object({
+    countryCode: z
+        .string()
+        .regex(/^[A-Z]{2}$/)
+        .describe("ISO 3166-1 alpha-2 country code, e.g. `TH`. A country without a list answers an empty one."),
+    periodDimension: TiktokCreativeCenterPeriodDimensionSchema,
+    periodEndTimestamp: z
+        .number()
+        .int()
+        .describe("Unix seconds that end the period, such as lastWeeklyEndTimestamp or lastMonthlyEndTimestamp from ads.creativeOne.report.getTopContentsOverview. A value Creative Center has no list for answers an empty one."),
+    orderByMetric: TiktokCreativeCenterOrderByMetricSchema,
+    organicOnly: z.boolean().optional().describe("true drops sponsored posts."),
+    contentLabelIDs: z
+        .string()
+        .optional()
+        .describe("Content category ids; empty or omitted for all categories."),
+    page: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Ignored without a TikTok One session: every answer is page 1."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .optional()
+        .describe("Ignored without a TikTok One session: every answer holds 4 rows."),
+});
+//# sourceMappingURL=zod.js.map

package/dist/src/zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zod.js","sourceRoot":"","sources":["../../src/zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,8EAA8E;AAC9E,6EAA6E;AAC7E,yBAAyB;AACzB,MAAM,CAAC,MAAM,yCAAyC,GAAG,CAAC;KACvD,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;KAClB,QAAQ,CACP,0FAA0F,CAC3F,CAAC;AAEJ,MAAM,CAAC,MAAM,uCAAuC,GAAG,CAAC;KACrD,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;KAClB,QAAQ,CACP,kFAAkF,CACnF,CAAC;AAEJ,MAAM,CAAC,MAAM,mDAAmD,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1E,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,KAAK,CAAC,YAAY,CAAC;SACnB,QAAQ,CACP,4FAA4F,CAC7F;IACH,eAAe,EAAE,yCAAyC;IAC1D,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,EAAE;SACL,QAAQ,CACP,+MAA+M,CAChN;IACH,aAAa,EAAE,uCAAuC;IACtD,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;IAC3E,eAAe,EAAE,CAAC;SACf,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,4DAA4D,CAAC;IACzE,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;IAC5E,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CACP,kEAAkE,CACnE;CACJ,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,54 @@
 {
   "name": "@apicity/tiktok-creative-center",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.20.0",
+  "description": "TikTok Creative Center trending videos provider (unofficial, undocumented endpoints).",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justintanner/apicity.git",
+    "directory": "provider/tiktok-creative-center"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/src/index.js",
+      "types": "./dist/src/index.d.ts"
+    },
+    "./zod": {
+      "import": "./dist/src/zod.js",
+      "types": "./dist/src/zod.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^4.6.6"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "keywords": [
+    "tiktok",
+    "creative-center",
+    "trends",
+    "social",
+    "apicity"
+  ],
+  "author": "Justin Tanner",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "homepage": "https://github.com/justintanner/apicity#readme",
+  "bugs": {
+    "url": "https://github.com/justintanner/apicity/issues"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/dist.mjs"
+  }
 }