@zernio/node 0.2.836 → 0.2.837

package/dist/index.d.mts

@@ -3199,6 +3199,12 @@ type AnalyticsDeltaEntry = {
         audienceTypes: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`. Empty object elsewhere.
+         */
+        audienceCountries: {
+            [key: string]: (number);
+        };
     };
 };
 type AnalyticsDeltaResponse = {
@@ -8252,6 +8258,12 @@ type PostAnalytics = {
     audienceTypes?: {
         [key: string]: (number);
     };
+    /**
+     * TikTok accounts connected through the TikTok for Business app only: share of views by viewer country as fractions 0 to 1, keyed by upper-case ISO-3166 alpha-2 code (T+24-48h, only for posts active in the last 7 days). At most 20 country keys plus `other`: the catch-all bucket TikTok sends, any country below 0.001 and anything past the twentieth all sum into `other`, so the values still add up to 1. Empty object when TikTok reports nothing, and for other platforms. Views-weighted across accounts like impressionSources.
+     */
+    audienceCountries?: {
+        [key: string]: (number);
+    };
     /**
      * Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead.
      */
@@ -14301,6 +14313,12 @@ type GetPostTimelineResponse = ({
         audienceTypes?: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares on this date keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`; empty object elsewhere
+         */
+        audienceCountries?: {
+            [key: string]: (number);
+        };
     }>;
 });
 type GetPostTimelineError = ({

package/dist/index.d.ts

@@ -3199,6 +3199,12 @@ type AnalyticsDeltaEntry = {
         audienceTypes: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`. Empty object elsewhere.
+         */
+        audienceCountries: {
+            [key: string]: (number);
+        };
     };
 };
 type AnalyticsDeltaResponse = {
@@ -8252,6 +8258,12 @@ type PostAnalytics = {
     audienceTypes?: {
         [key: string]: (number);
     };
+    /**
+     * TikTok accounts connected through the TikTok for Business app only: share of views by viewer country as fractions 0 to 1, keyed by upper-case ISO-3166 alpha-2 code (T+24-48h, only for posts active in the last 7 days). At most 20 country keys plus `other`: the catch-all bucket TikTok sends, any country below 0.001 and anything past the twentieth all sum into `other`, so the values still add up to 1. Empty object when TikTok reports nothing, and for other platforms. Views-weighted across accounts like impressionSources.
+     */
+    audienceCountries?: {
+        [key: string]: (number);
+    };
     /**
      * Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead.
      */
@@ -14301,6 +14313,12 @@ type GetPostTimelineResponse = ({
         audienceTypes?: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares on this date keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`; empty object elsewhere
+         */
+        audienceCountries?: {
+            [key: string]: (number);
+        };
     }>;
 });
 type GetPostTimelineError = ({

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.836",
+  version: "0.2.837",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.836",
+  version: "0.2.837",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zernio/node",
-  "version": "0.2.836",
+  "version": "0.2.837",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -222,19 +222,23 @@ export const getLinkedInOrgAggregateAnalytics = <ThrowOnError extends boolean =
  * defaults to last 30 days. Requires the Analytics add-on and the user.info.stats
  * scope on the account (412 if missing).
  *
- * Scope intentionally narrow. TikTok's public API exposes only the four counter
- * metrics below. The deep metrics that live in TikTok Studio are NOT available on any
- * public TikTok API, even for Business accounts:
- * - profile_views
+ * Scope intentionally narrow: this ACCOUNT-level endpoint exposes only the four
+ * counter metrics below. These account-level figures are not on any public TikTok
+ * API, for any account type:
  * - account-level impressions / reach
  * - follower inflow / outflow breakdown
- * - video watch time, average watch time, full-watched rate
- * - impression_sources (FYP / Following / Hashtag / Search / Personal profile)
- *
- * TikTok's Research API doesn't expose those fields either, and is restricted to
- * non-commercial academic use per TikTok's eligibility policy. There is no public
- * API workaround. Post-level metrics (views, likes, comments, shares per video) are
- * available via /v1/analytics?postId=... from TikTok's /v2/video/query/.
+ * - account-level watch time and audience demographics
+ *
+ * TikTok's Research API doesn't expose them either, and is restricted to
+ * non-commercial academic use per TikTok's eligibility policy.
+ *
+ * PER-VIDEO is a different story on the Business lane. An account connected through
+ * the TikTok for Business app reports profile views, website clicks, follows,
+ * full-watched rate, watch time, impression sources, viewer types and viewer
+ * countries per video on GET /v1/analytics?postId=..., roughly 24-48h after
+ * publishing and only for posts active in the last 7 days. Accounts on the original
+ * TikTok integration get the basic counters there (views, likes, comments, shares)
+ * and zeros for the rest; they must reconnect through the Business app.
  *
  */
 export const getTikTokAccountInsights = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTikTokAccountInsightsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -1564,6 +1564,12 @@ export type AnalyticsDeltaEntry = {
         audienceTypes: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`. Empty object elsewhere.
+         */
+        audienceCountries: {
+            [key: string]: (number);
+        };
     };
 };
 
@@ -6844,6 +6850,12 @@ export type PostAnalytics = {
     audienceTypes?: {
         [key: string]: (number);
     };
+    /**
+     * TikTok accounts connected through the TikTok for Business app only: share of views by viewer country as fractions 0 to 1, keyed by upper-case ISO-3166 alpha-2 code (T+24-48h, only for posts active in the last 7 days). At most 20 country keys plus `other`: the catch-all bucket TikTok sends, any country below 0.001 and anything past the twentieth all sum into `other`, so the values still add up to 1. Empty object when TikTok reports nothing, and for other platforms. Views-weighted across accounts like impressionSources.
+     */
+    audienceCountries?: {
+        [key: string]: (number);
+    };
     /**
      * Instagram accounts connected with Facebook Login only: reposts of the media by other users, minus deleted reposts, on feed posts, reels and stories. Meta does not expose this metric for accounts connected with Instagram Login, so those always report 0. 0 for other platforms, including Threads, where reposts are counted in shares instead.
      */
@@ -13169,6 +13181,12 @@ export type GetPostTimelineResponse = ({
         audienceTypes?: {
             [key: string]: (number);
         };
+        /**
+         * TikTok business lane: viewer-country shares on this date keyed by ISO-3166 alpha-2, fractions 0 to 1, top 20 with the tail in `other`; empty object elsewhere
+         */
+        audienceCountries?: {
+            [key: string]: (number);
+        };
     }>;
 });