@getlatedev/node 0.2.1189 → 0.2.1191

package/dist/index.d.mts

@@ -2540,12 +2540,54 @@ type AdAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 /**
@@ -5062,12 +5104,54 @@ type CampaignAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 /**
@@ -9291,23 +9375,44 @@ type InstagramBusinessDiscovery = {
      * Most recent media first, up to `limit`.
      */
     media: Array<{
-        id?: string;
-        caption?: (string) | null;
+        id: string;
+        caption: (string) | null;
         /**
          * IMAGE, VIDEO or CAROUSEL_ALBUM
          */
-        mediaType?: (string) | null;
+        mediaType: (string) | null;
         /**
          * FEED or REELS
          */
-        mediaProductType?: (string) | null;
-        timestamp?: (string) | null;
-        permalink?: (string) | null;
+        mediaProductType: (string) | null;
+        timestamp: (string) | null;
+        permalink: (string) | null;
         /**
          * Null when the owner hides like counts
          */
-        likeCount?: (number) | null;
-        commentsCount?: (number) | null;
+        likeCount: (number) | null;
+        commentsCount: (number) | null;
+        /**
+         * Temporary CDN URL that expires; download the file rather than storing the link. Null on videos whose audio is licensed music, use thumbnailUrl for the cover.
+         */
+        mediaUrl: (string) | null;
+        /**
+         * Video cover frame, VIDEO only. Temporary CDN URL.
+         */
+        thumbnailUrl: (string) | null;
+        /**
+         * Reels only. Null on images and carousels.
+         */
+        viewCount: (number) | null;
+        /**
+         * Carousel slides in order. Null unless mediaType is CAROUSEL_ALBUM.
+         */
+        children: Array<{
+            id: string;
+            mediaType: (string) | null;
+            mediaUrl: (string) | null;
+            thumbnailUrl: (string) | null;
+        }> | null;
     }>;
 };
 type InstagramDemographicsResponse = {
@@ -42983,11 +43088,23 @@ type GetCampaignAnalyticsData = {
          * **Meta**: age, gender, country, publisher_platform, device_platform, region,
          * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
+         *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**
@@ -43353,7 +43470,7 @@ type QueryAdInsightsData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+         * Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType=AUDIENCE, e.g. dimensions=campaign_id,placement) and on Google (select segments.* in the query).
          */
         breakdowns?: string;
         /**
@@ -43581,15 +43698,26 @@ type GetAdAnalyticsData = {
         /**
          * Comma-separated breakdown dimensions.
          *
-         * **Meta**: age, gender, country, publisher_platform, device_platform, region.
+         * **Meta**: age, gender, country, publisher_platform, device_platform, region,
+         * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
-         * **TikTok**: gender, age, country_code, platform, ac, language.
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
          *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**

package/dist/index.d.ts

@@ -2540,12 +2540,54 @@ type AdAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 /**
@@ -5062,12 +5104,54 @@ type CampaignAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 /**
@@ -9291,23 +9375,44 @@ type InstagramBusinessDiscovery = {
      * Most recent media first, up to `limit`.
      */
     media: Array<{
-        id?: string;
-        caption?: (string) | null;
+        id: string;
+        caption: (string) | null;
         /**
          * IMAGE, VIDEO or CAROUSEL_ALBUM
          */
-        mediaType?: (string) | null;
+        mediaType: (string) | null;
         /**
          * FEED or REELS
          */
-        mediaProductType?: (string) | null;
-        timestamp?: (string) | null;
-        permalink?: (string) | null;
+        mediaProductType: (string) | null;
+        timestamp: (string) | null;
+        permalink: (string) | null;
         /**
          * Null when the owner hides like counts
          */
-        likeCount?: (number) | null;
-        commentsCount?: (number) | null;
+        likeCount: (number) | null;
+        commentsCount: (number) | null;
+        /**
+         * Temporary CDN URL that expires; download the file rather than storing the link. Null on videos whose audio is licensed music, use thumbnailUrl for the cover.
+         */
+        mediaUrl: (string) | null;
+        /**
+         * Video cover frame, VIDEO only. Temporary CDN URL.
+         */
+        thumbnailUrl: (string) | null;
+        /**
+         * Reels only. Null on images and carousels.
+         */
+        viewCount: (number) | null;
+        /**
+         * Carousel slides in order. Null unless mediaType is CAROUSEL_ALBUM.
+         */
+        children: Array<{
+            id: string;
+            mediaType: (string) | null;
+            mediaUrl: (string) | null;
+            thumbnailUrl: (string) | null;
+        }> | null;
     }>;
 };
 type InstagramDemographicsResponse = {
@@ -42983,11 +43088,23 @@ type GetCampaignAnalyticsData = {
          * **Meta**: age, gender, country, publisher_platform, device_platform, region,
          * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
+         *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**
@@ -43353,7 +43470,7 @@ type QueryAdInsightsData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+         * Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType=AUDIENCE, e.g. dimensions=campaign_id,placement) and on Google (select segments.* in the query).
          */
         breakdowns?: string;
         /**
@@ -43581,15 +43698,26 @@ type GetAdAnalyticsData = {
         /**
          * Comma-separated breakdown dimensions.
          *
-         * **Meta**: age, gender, country, publisher_platform, device_platform, region.
+         * **Meta**: age, gender, country, publisher_platform, device_platform, region,
+         * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
-         * **TikTok**: gender, age, country_code, platform, ac, language.
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
          *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -2999,6 +2999,8 @@ export const getInstagramAudio = <ThrowOnError extends boolean = false>(options:
  *
  * `likeCount` is null when the owner hides like counts.
  *
+ * Media URLs are temporary, and fields Meta does not return come back as null, never omitted.
+ *
  */
 export const getInstagramBusinessDiscovery = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetInstagramBusinessDiscoveryData, ThrowOnError>) => {
     return (options?.client ?? client).get<GetInstagramBusinessDiscoveryResponse, GetInstagramBusinessDiscoveryError, ThrowOnError>({
@@ -10945,9 +10947,9 @@ export const removeAdGroupAssets = <ThrowOnError extends boolean = false>(option
  *
  * Returns performance analytics for a whole campaign in one call: summary metrics, a daily
  * timeline over the requested date range (summed across the campaign's ads), and optional
- * demographic breakdowns. Breakdowns are fetched live from Meta at the campaign level (one call
- * per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level age/gender/etc.
- * without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass
+ * demographic breakdowns. Breakdowns are fetched live from Meta, TikTok or LinkedIn at the campaign
+ * level (one call per dimension, no per-ad fan-out), so an agency dashboard gets campaign-level
+ * age/gender/placement/etc. without summing thousands of per-ad reads. `campaignId` is the platform campaign id; pass
  * `platform` when a campaign id could be ambiguous across platforms. If no date range is provided,
  * defaults to the last 90 days. Date range is capped at 730 days max.
  * Google adds searchImpressionShare, searchBudgetLostImpressionShare,
@@ -11188,10 +11190,10 @@ export const getAdInsightsReport = <ThrowOnError extends boolean = false>(option
 
 /**
  * Get ad analytics
- * Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta and TikTok.
+ * Returns one ad's performance summary and daily timeline, with optional audience breakdowns on Meta, TikTok and LinkedIn.
  *
  * Includes summary metrics, a daily timeline
- * over the requested date range, and optional demographic breakdowns (Meta and TikTok only).
+ * over the requested date range, and optional demographic breakdowns (Meta, TikTok and LinkedIn only).
  * If no date range is provided, defaults to the last 90 days. Date range is capped at 730 days max.
  *
  */

package/src/generated/types.gen.ts

@@ -543,12 +543,54 @@ export type AdAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 
@@ -3178,12 +3220,54 @@ export type CampaignAnalyticsResponse = {
          * keys are ABSENT rather than 0. `audiencePenetration` is available here only: it
          * is not part of the stored metrics series.
          *
+         * TikTok rows are keyed by TikTok's own dimension name (`country_code` for
+         * `country`, `platform` for `publisher_platform`). `placement` rows carry the
+         * label TikTok Ads Manager shows (`TikTok`, `TikTok Ad Network`, `News Feed App Series`)
+         * in `placement` and TikTok's API value (`PLACEMENT_TIKTOK`, `PLACEMENT_PANGLE`,
+         * `PLACEMENT_GLOBAL_APP_BUNDLE`) in `placementRaw`; a value without a known label
+         * carries the raw value in both.
+         *
+         * A requested dimension with no data in the range is an empty array.
+         *
          */
         breakdowns?: {
             [key: string]: Array<{
                 [key: string]: unknown;
             }>;
         };
+        /**
+         * Requested breakdowns this platform cannot break down by (e.g. region on TikTok, any breakdown on Google). Absent when every requested breakdown is supported.
+         */
+        unsupportedBreakdowns?: Array<(string)>;
+        /**
+         * Guidance for some names in unsupportedBreakdowns, keyed by that name (e.g. placement on Meta points at publisher_platform and platform_position; platform_position on TikTok points at placement). Absent when no unsupported name has a hint.
+         */
+        breakdownHints?: {
+            [key: string]: (string);
+        };
+        /**
+         * TikTok only: breakdowns the platform failed to return (rate limit, permission, rejected query). Each one is an empty array under breakdowns; summary and daily are unaffected. Absent when every breakdown answered.
+         */
+        breakdownErrors?: Array<{
+            breakdown?: string;
+            /**
+             * The platform's error message.
+             */
+            message?: string;
+        }>;
+        /**
+         * TikTok only: TikTok metric names TikTok refused for a breakdown, keyed by the requested breakdown (e.g. total_purchase and total_purchase_value have no relation to platform, ac or language). Every row value derived from a refused metric is null in that breakdown (purchaseValue and roas, or the matching actions and actionValues entries), never a number computed without it. Absent when no metric was refused.
+         */
+        breakdownDroppedMetrics?: {
+            [key: string]: Array<(string)>;
+        };
+        /**
+         * TikTok only, present when the requested range is longer than the 365 days TikTok serves per breakdown: the window the breakdowns cover (the last 365 days of the range). summary and daily still cover the full range.
+         */
+        breakdownsRange?: {
+            fromDate?: string;
+            toDate?: string;
+        };
     };
 };
 
@@ -7599,23 +7683,44 @@ export type InstagramBusinessDiscovery = {
      * Most recent media first, up to `limit`.
      */
     media: Array<{
-        id?: string;
-        caption?: (string) | null;
+        id: string;
+        caption: (string) | null;
         /**
          * IMAGE, VIDEO or CAROUSEL_ALBUM
          */
-        mediaType?: (string) | null;
+        mediaType: (string) | null;
         /**
          * FEED or REELS
          */
-        mediaProductType?: (string) | null;
-        timestamp?: (string) | null;
-        permalink?: (string) | null;
+        mediaProductType: (string) | null;
+        timestamp: (string) | null;
+        permalink: (string) | null;
         /**
          * Null when the owner hides like counts
          */
-        likeCount?: (number) | null;
-        commentsCount?: (number) | null;
+        likeCount: (number) | null;
+        commentsCount: (number) | null;
+        /**
+         * Temporary CDN URL that expires; download the file rather than storing the link. Null on videos whose audio is licensed music, use thumbnailUrl for the cover.
+         */
+        mediaUrl: (string) | null;
+        /**
+         * Video cover frame, VIDEO only. Temporary CDN URL.
+         */
+        thumbnailUrl: (string) | null;
+        /**
+         * Reels only. Null on images and carousels.
+         */
+        viewCount: (number) | null;
+        /**
+         * Carousel slides in order. Null unless mediaType is CAROUSEL_ALBUM.
+         */
+        children: Array<{
+            id: string;
+            mediaType: (string) | null;
+            mediaUrl: (string) | null;
+            thumbnailUrl: (string) | null;
+        }> | null;
     }>;
 };
 
@@ -43516,11 +43621,23 @@ export type GetCampaignAnalyticsData = {
          * **Meta**: age, gender, country, publisher_platform, device_platform, region,
          * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
+         *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**
@@ -43907,7 +44024,7 @@ export type QueryAdInsightsData = {
          */
         after?: string;
         /**
-         * Comma-separated Graph breakdowns (e.g. age,gender or publisher_platform).
+         * Meta only: comma-separated Graph breakdowns (e.g. age,gender or publisher_platform). Returns 400 on TikTok (add the breakdown to dimensions with reportType=AUDIENCE, e.g. dimensions=campaign_id,placement) and on Google (select segments.* in the query).
          */
         breakdowns?: string;
         /**
@@ -44144,15 +44261,26 @@ export type GetAdAnalyticsData = {
         /**
          * Comma-separated breakdown dimensions.
          *
-         * **Meta**: age, gender, country, publisher_platform, device_platform, region.
+         * **Meta**: age, gender, country, publisher_platform, device_platform, region,
+         * platform_position, impression_device, video_asset, image_asset, body_asset, title_asset.
          *
-         * **TikTok**: gender, age, country_code, platform, ac, language.
+         * **TikTok**: gender, age, country (or country_code), publisher_platform (or platform),
+         * ac, language, placement. TikTok serves at most 365 days per breakdown, so a longer
+         * range is read over its last 365 days and `analytics.breakdownsRange` says which window.
          *
          * **LinkedIn** (firmographics): job_title, job_function, seniority, industry,
          * company, company_size, country, region. Rows carry the raw pivot `value`
          * plus a resolved `name`. LinkedIn serves these aggregated over the whole
          * range, delays the data 12-24h, and omits segments with fewer than 3 events.
          *
+         * A known dimension the platform cannot break down by is listed in
+         * `analytics.unsupportedBreakdowns` instead of being dropped (with guidance in
+         * `analytics.breakdownHints` where there is an alternative); the rest of the response
+         * is unchanged. An unknown name returns 400. A TikTok dimension that fails is listed
+         * in `analytics.breakdownErrors` and the response stays 200.
+         * Metrics TikTok refuses for a dimension are listed in `analytics.breakdownDroppedMetrics`,
+         * and the row values derived from them are null.
+         *
          */
         breakdowns?: string;
         /**