@zernio/node 0.2.962 → 0.2.963

package/dist/index.d.mts

@@ -38845,7 +38845,7 @@ type GenerateKeywordHistoricalMetricsError = (unknown | {
 type QueryAdInsightsData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract.
+         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta, Google or TikTok contract.
          */
         accountId: string;
         /**
@@ -38861,7 +38861,7 @@ type QueryAdInsightsData = {
          */
         actionReportTime?: string;
         /**
-         * Google only: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts.
+         * Google: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts. TikTok (required there): the advertiser id.
          */
         adAccountId?: string;
         /**
@@ -38877,20 +38877,28 @@ type QueryAdInsightsData = {
          * @deprecated
          */
         customerId?: string;
+        /**
+         * TikTok only (required there): data_level.
+         */
+        dataLevel?: 'AUCTION_ADVERTISER' | 'AUCTION_CAMPAIGN' | 'AUCTION_ADGROUP' | 'AUCTION_AD';
         /**
          * Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
          */
         datePreset?: string;
+        /**
+         * TikTok only (required there): 1-4 comma-separated TikTok dimensions (e.g. country_code, campaign_id, stat_time_day).
+         */
+        dimensions?: string;
         /**
          * Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
          */
         fields?: string;
         /**
-         * JSON array of Meta filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta.
+         * JSON array of filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta or TikTok (TikTok fields e.g. campaign_ids, adgroup_ids, ad_ids).
          */
         filtering?: string;
         /**
-         * Start of range (YYYY-MM-DD); requires toDate.
+         * Start of range (YYYY-MM-DD); requires toDate. Required on TikTok.
          */
         fromDate?: string;
         /**
@@ -38901,10 +38909,22 @@ type QueryAdInsightsData = {
          * Rows per page
          */
         limit?: number;
+        /**
+         * TikTok only (required there): comma-separated TikTok metrics (e.g. reach,impressions,frequency,spend).
+         */
+        metrics?: string;
         /**
          * Meta only (required there): insights node (act_<n>, campaign id, ad set id or ad id).
          */
         objectId?: string;
+        /**
+         * TikTok only: page number.
+         */
+        page?: number;
+        /**
+         * TikTok only: rows per page.
+         */
+        pageSize?: number;
         /**
          * Google only: cursor from paging.nextPageToken of the previous page.
          */
@@ -38913,6 +38933,10 @@ type QueryAdInsightsData = {
          * Google only (required there): the GAQL SELECT statement to run.
          */
         query?: string;
+        /**
+         * TikTok only: report_type.
+         */
+        reportType?: 'BASIC' | 'AUDIENCE';
         /**
          * Days per row (1-90), monthly, or all_days.
          */
@@ -38932,6 +38956,10 @@ type QueryAdInsightsResponse = ({
      * Meta responses only.
      */
     objectId?: string;
+    /**
+     * TikTok responses only: the advertiser queried.
+     */
+    adAccountId?: string;
     /**
      * Google responses only: the customer the query ran against.
      */
@@ -38952,6 +38980,22 @@ type QueryAdInsightsResponse = ({
          * Google cursor for the next page; null when exhausted.
          */
         nextPageToken?: (string) | null;
+        /**
+         * TikTok only: current page.
+         */
+        page?: number;
+        /**
+         * TikTok only.
+         */
+        pageSize?: number;
+        /**
+         * TikTok only.
+         */
+        totalRows?: number;
+        /**
+         * TikTok only.
+         */
+        totalPages?: number;
     };
 });
 type QueryAdInsightsError = (unknown | {

package/dist/index.d.ts

@@ -38845,7 +38845,7 @@ type GenerateKeywordHistoricalMetricsError = (unknown | {
 type QueryAdInsightsData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract.
+         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta, Google or TikTok contract.
          */
         accountId: string;
         /**
@@ -38861,7 +38861,7 @@ type QueryAdInsightsData = {
          */
         actionReportTime?: string;
         /**
-         * Google only: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts.
+         * Google: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts. TikTok (required there): the advertiser id.
          */
         adAccountId?: string;
         /**
@@ -38877,20 +38877,28 @@ type QueryAdInsightsData = {
          * @deprecated
          */
         customerId?: string;
+        /**
+         * TikTok only (required there): data_level.
+         */
+        dataLevel?: 'AUCTION_ADVERTISER' | 'AUCTION_CAMPAIGN' | 'AUCTION_ADGROUP' | 'AUCTION_AD';
         /**
          * Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
          */
         datePreset?: string;
+        /**
+         * TikTok only (required there): 1-4 comma-separated TikTok dimensions (e.g. country_code, campaign_id, stat_time_day).
+         */
+        dimensions?: string;
         /**
          * Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
          */
         fields?: string;
         /**
-         * JSON array of Meta filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta.
+         * JSON array of filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta or TikTok (TikTok fields e.g. campaign_ids, adgroup_ids, ad_ids).
          */
         filtering?: string;
         /**
-         * Start of range (YYYY-MM-DD); requires toDate.
+         * Start of range (YYYY-MM-DD); requires toDate. Required on TikTok.
          */
         fromDate?: string;
         /**
@@ -38901,10 +38909,22 @@ type QueryAdInsightsData = {
          * Rows per page
          */
         limit?: number;
+        /**
+         * TikTok only (required there): comma-separated TikTok metrics (e.g. reach,impressions,frequency,spend).
+         */
+        metrics?: string;
         /**
          * Meta only (required there): insights node (act_<n>, campaign id, ad set id or ad id).
          */
         objectId?: string;
+        /**
+         * TikTok only: page number.
+         */
+        page?: number;
+        /**
+         * TikTok only: rows per page.
+         */
+        pageSize?: number;
         /**
          * Google only: cursor from paging.nextPageToken of the previous page.
          */
@@ -38913,6 +38933,10 @@ type QueryAdInsightsData = {
          * Google only (required there): the GAQL SELECT statement to run.
          */
         query?: string;
+        /**
+         * TikTok only: report_type.
+         */
+        reportType?: 'BASIC' | 'AUDIENCE';
         /**
          * Days per row (1-90), monthly, or all_days.
          */
@@ -38932,6 +38956,10 @@ type QueryAdInsightsResponse = ({
      * Meta responses only.
      */
     objectId?: string;
+    /**
+     * TikTok responses only: the advertiser queried.
+     */
+    adAccountId?: string;
     /**
      * Google responses only: the customer the query ran against.
      */
@@ -38952,6 +38980,22 @@ type QueryAdInsightsResponse = ({
          * Google cursor for the next page; null when exhausted.
          */
         nextPageToken?: (string) | null;
+        /**
+         * TikTok only: current page.
+         */
+        page?: number;
+        /**
+         * TikTok only.
+         */
+        pageSize?: number;
+        /**
+         * TikTok only.
+         */
+        totalRows?: number;
+        /**
+         * TikTok only.
+         */
+        totalPages?: number;
     };
 });
 type QueryAdInsightsError = (unknown | {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@zernio/node",
-  version: "0.2.962",
+  version: "0.2.963",
   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.962",
+  version: "0.2.963",
   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.962",
+  "version": "0.2.963",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -9995,6 +9995,23 @@ export const generateKeywordHistoricalMetrics = <ThrowOnError extends boolean =
  * `'YYYY-MM-DD'` literal are translated; any other form returns Google's 400. New code should
  * select the `_date_time` fields directly.
  *
+ * **TikTok (tiktok/tiktokads)**: passthrough of TikTok's synchronous report
+ * (`/report/integrated/get/`). Send `adAccountId`, `dataLevel`, `dimensions`, `metrics`,
+ * `fromDate`/`toDate` (TikTok caps the span at 365 days) and optionally `filtering` in the same
+ * `[{"field", "operator", "value"}]` shape as Meta (operator is TikTok's `filter_type`, e.g. `IN`;
+ * array values are JSON-encoded for TikTok). Rows come back verbatim as
+ * `{ dimensions, metrics }` with page-number paging.
+ *
+ * *De-duplicated reach across a set of campaigns, ad groups or ads*: filter the set and group by
+ * `country_code` instead of the entity id. TikTok then counts each person once across the whole
+ * set and range, per country. Example, two campaigns for a month:
+ * `dataLevel=AUCTION_CAMPAIGN&dimensions=country_code&metrics=reach,impressions,frequency&fromDate=2026-09-01&toDate=2026-09-30&filtering=[{"field":"campaign_ids","operator":"IN","value":["1876574798182050","1876575504573650"]}]`.
+ * For a set of ads use `dataLevel=AUCTION_AD` with `ad_ids`. A filter on a finer entity than
+ * `dataLevel` (e.g. `ad_ids` at `AUCTION_CAMPAIGN`) returns 400: TikTok would otherwise widen it to
+ * every parent entity containing those ids. When the set delivers in several countries, reach is
+ * per country; summing the rows counts a person reached in two countries twice.
+ * `AUCTION_ADVERTISER` rejects entity filters.
+ *
  */
 export const queryAdInsights = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<QueryAdInsightsData, ThrowOnError>) => {
     return (options?.client ?? client).get<QueryAdInsightsResponse, QueryAdInsightsError, ThrowOnError>({

package/src/generated/types.gen.ts

@@ -39306,7 +39306,7 @@ export type GenerateKeywordHistoricalMetricsError = (unknown | {
 export type QueryAdInsightsData = {
     query: {
         /**
-         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta or Google contract.
+         * Zernio SocialAccount id (posting or ads variant); its platform selects the Meta, Google or TikTok contract.
          */
         accountId: string;
         /**
@@ -39322,7 +39322,7 @@ export type QueryAdInsightsData = {
          */
         actionReportTime?: string;
         /**
-         * Google only: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts.
+         * Google: platform ad account ID (Google customer ID, digits only) when the connection has several Google Ads accounts. TikTok (required there): the advertiser id.
          */
         adAccountId?: string;
         /**
@@ -39338,20 +39338,28 @@ export type QueryAdInsightsData = {
          * @deprecated
          */
         customerId?: string;
+        /**
+         * TikTok only (required there): data_level.
+         */
+        dataLevel?: 'AUCTION_ADVERTISER' | 'AUCTION_CAMPAIGN' | 'AUCTION_ADGROUP' | 'AUCTION_AD';
         /**
          * Meta date_preset (e.g. last_7d, last_30d, this_month). Mutually exclusive with fromDate/toDate.
          */
         datePreset?: string;
+        /**
+         * TikTok only (required there): 1-4 comma-separated TikTok dimensions (e.g. country_code, campaign_id, stat_time_day).
+         */
+        dimensions?: string;
         /**
          * Comma-separated Graph insights fields (e.g. spend,impressions,frequency,website_purchase_roas). Omitted = Meta's default set.
          */
         fields?: string;
         /**
-         * JSON array of Meta filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta.
+         * JSON array of filter objects: [{"field", "operator", "value"}]. Applied server-side by Meta or TikTok (TikTok fields e.g. campaign_ids, adgroup_ids, ad_ids).
          */
         filtering?: string;
         /**
-         * Start of range (YYYY-MM-DD); requires toDate.
+         * Start of range (YYYY-MM-DD); requires toDate. Required on TikTok.
          */
         fromDate?: string;
         /**
@@ -39362,10 +39370,22 @@ export type QueryAdInsightsData = {
          * Rows per page
          */
         limit?: number;
+        /**
+         * TikTok only (required there): comma-separated TikTok metrics (e.g. reach,impressions,frequency,spend).
+         */
+        metrics?: string;
         /**
          * Meta only (required there): insights node (act_<n>, campaign id, ad set id or ad id).
          */
         objectId?: string;
+        /**
+         * TikTok only: page number.
+         */
+        page?: number;
+        /**
+         * TikTok only: rows per page.
+         */
+        pageSize?: number;
         /**
          * Google only: cursor from paging.nextPageToken of the previous page.
          */
@@ -39374,6 +39394,10 @@ export type QueryAdInsightsData = {
          * Google only (required there): the GAQL SELECT statement to run.
          */
         query?: string;
+        /**
+         * TikTok only: report_type.
+         */
+        reportType?: 'BASIC' | 'AUDIENCE';
         /**
          * Days per row (1-90), monthly, or all_days.
          */
@@ -39394,6 +39418,10 @@ export type QueryAdInsightsResponse = ({
      * Meta responses only.
      */
     objectId?: string;
+    /**
+     * TikTok responses only: the advertiser queried.
+     */
+    adAccountId?: string;
     /**
      * Google responses only: the customer the query ran against.
      */
@@ -39414,6 +39442,22 @@ export type QueryAdInsightsResponse = ({
          * Google cursor for the next page; null when exhausted.
          */
         nextPageToken?: (string) | null;
+        /**
+         * TikTok only: current page.
+         */
+        page?: number;
+        /**
+         * TikTok only.
+         */
+        pageSize?: number;
+        /**
+         * TikTok only.
+         */
+        totalRows?: number;
+        /**
+         * TikTok only.
+         */
+        totalPages?: number;
     };
 });