@getlatedev/node 0.2.1076 → 0.2.1078

package/dist/index.d.mts

@@ -3600,6 +3600,16 @@ type AnalyticsDeltaEntry = {
         audienceCountries: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays. 0 elsewhere.
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second, keyed by the second, fractions 0 to 1. Empty object elsewhere.
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     };
 };
 type AnalyticsDeltaResponse = {
@@ -10447,6 +10457,16 @@ type PostAnalytics = {
     audienceCountries?: {
         [key: string]: (number);
     };
+    /**
+     * Facebook Reels only: plays that were replays (Meta fb_reels_replay_count). Summed across accounts. 0 for other media and platforms.
+     */
+    replays?: number;
+    /**
+     * Facebook Reels only: share of plays still watching at each second of the Reel, keyed by the second from "0", fractions 0 to 1 (Meta post_video_retention_graph). Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     */
+    retentionCurve?: {
+        [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.
      */
@@ -17764,6 +17784,16 @@ type GetPostTimelineResponse = ({
         audienceCountries?: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays, as of this date; 0 elsewhere
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second as of this date, keyed by the second, fractions 0 to 1; empty object elsewhere
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     }>;
 });
 type GetPostTimelineError = ({
@@ -47100,7 +47130,7 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -47120,7 +47150,7 @@ type CreateAdAudienceData = {
         adAccountId: string;
         name: string;
         description?: string;
-        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
+        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike';
         /**
          * Required for website_retargeting audiences (LinkedIn only).
          * Each rule is a URL pattern; a member who visits any
@@ -47183,11 +47213,11 @@ type CreateAdAudienceData = {
             linkedinPageUrl?: string;
         }>;
         /**
-         * Required for website audiences
+         * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
          */
         pixelId?: string;
         /**
-         * Required for website (max 180) and meta_engagement (max 365) audiences.
+         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
          */
         retentionDays?: number;
         /**
@@ -47202,10 +47232,26 @@ type CreateAdAudienceData = {
          */
         sourceId?: string;
         /**
-         * meta_engagement only. The engagement event; defaults per source
+         * meta_engagement: the engagement event; defaults per source
          * (page → page_engaged, instagram → ig_business_profile_all,
          * video → video_watched). Ignored when `rule` is provided.
          *
+         * website on TikTok: the pixel event (default `PAGE BROWSE`). website
+         * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
+         *
+         * tiktok_engagement (required): the TikTok engagement event, validated
+         * per `source` (TikTok's filter values, spaces included):
+         * - ads: `CLICK`, `IMPRESSION`, `PLAY 2S`, `PLAY 6S`, `PLAY 25`, `PLAY 50`, `PLAY 75`,
+         * `PLAY OVER`, and the `ENGAGEMENT APP PROFILE` / `ENGAGEMENT TIKTOK INSTANT` /
+         * `ENGAGEMENT COLLECTION ADS` `CLICK` and `IMPRESSION` events.
+         * - organic_video: `ORGANIC VIDEO PLAY 2S`, `ORGANIC VIDEO PLAY 6S`,
+         * `ORGANIC VIDEO PLAY OVER`, `ORGANIC VIDEO ENGAGEMENT`.
+         * - live_video: `LIVE VIDEO VIEW`, `LIVE VIDEO ENGAGEMENT`.
+         * - business_account: `BUSINESS ACCOUNT PROFILE FOLLOW`, `BUSINESS ACCOUNT PROFILE VISIT`,
+         * `BUSINESS ACCOUNT ENGAGEMENT`, `BUSINESS ACCOUNT PLAY 2S`, `BUSINESS ACCOUNT PLAY 6S`,
+         * `BUSINESS ACCOUNT PLAY OVER` and the rest of TikTok's business-account events.
+         * An unknown value is a 400 that lists the valid ones.
+         *
          */
         event?: string;
         /**
@@ -47217,17 +47263,66 @@ type CreateAdAudienceData = {
          */
         country?: string;
         /**
-         * Required for lookalike audiences
+         * lookalike on Meta (0.01-0.20) and Pinterest (0.01-0.10, whole percents). Rejected on TikTok and Google.
          */
         ratio?: number;
         /**
-         * website only. Narrows the audience from all visitors to visitors of
-         * URLs containing this substring. Ignored when `rule` is supplied.
+         * lookalike on TikTok and Google: audience breadth. Rejected on Meta and Pinterest.
+         */
+        size?: 'narrow' | 'balanced' | 'broad';
+        /**
+         * Required for tiktok_engagement: what people engaged with.
+         */
+        source?: 'ads' | 'organic_video' | 'live_video' | 'business_account';
+        /**
+         * tiktok_engagement: ad group / campaign ids for `ads`, video ids for `organic_video` and `live_video` (max 10). Required except for `business_account`.
+         */
+        sourceIds?: Array<(string)>;
+        /**
+         * tiktok_engagement: the TikTok identity that owns the videos or business account. Required for organic_video, live_video and business_account.
+         */
+        identityId?: string;
+        /**
+         * tiktok_engagement: type of `identityId`.
+         */
+        identityType?: 'TT_USER' | 'BC_AUTH_TT';
+        /**
+         * tiktok_engagement: required when identityType is BC_AUTH_TT.
+         */
+        identityAuthorizedBcId?: string;
+        /**
+         * pinterest_engagement: Pinterest's `engager_type`, passed through when set.
+         */
+        engagerType?: 1 | 2;
+        /**
+         * pinterest_engagement: limit to one engagement action.
+         */
+        engagementType?: 'click' | 'save' | 'closeup' | 'comment' | 'like';
+        /**
+         * pinterest_engagement: people who engaged with Pins from these domains. The domain must be claimed on the Pinterest account or Pinterest rejects it.
+         */
+        engagementDomains?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these campaigns' ads.
+         */
+        campaignIds?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these ads.
+         */
+        adIds?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these Pins. At least one of engagementDomains, campaignIds, adIds or pinIds is required.
+         */
+        pinIds?: Array<(string)>;
+        /**
+         * website on Meta, TikTok and Google. Narrows the audience from all visitors
+         * to visitors of URLs containing this substring. Ignored when `rule` is
+         * supplied. A 400 on Pinterest, which only matches exact URLs.
          *
          */
         urlContains?: string;
         /**
-         * Optional raw Meta rule, replacing the one we build. Omit it for all
+         * Meta only (a 400 elsewhere). Optional raw Meta rule, replacing the one we build. Omit it for all
          * visitors of `pixelId`, or use `urlContains` for the common page-match
          * case.
          *

package/dist/index.d.ts

@@ -3600,6 +3600,16 @@ type AnalyticsDeltaEntry = {
         audienceCountries: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays. 0 elsewhere.
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second, keyed by the second, fractions 0 to 1. Empty object elsewhere.
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     };
 };
 type AnalyticsDeltaResponse = {
@@ -10447,6 +10457,16 @@ type PostAnalytics = {
     audienceCountries?: {
         [key: string]: (number);
     };
+    /**
+     * Facebook Reels only: plays that were replays (Meta fb_reels_replay_count). Summed across accounts. 0 for other media and platforms.
+     */
+    replays?: number;
+    /**
+     * Facebook Reels only: share of plays still watching at each second of the Reel, keyed by the second from "0", fractions 0 to 1 (Meta post_video_retention_graph). Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     */
+    retentionCurve?: {
+        [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.
      */
@@ -17764,6 +17784,16 @@ type GetPostTimelineResponse = ({
         audienceCountries?: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays, as of this date; 0 elsewhere
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second as of this date, keyed by the second, fractions 0 to 1; empty object elsewhere
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     }>;
 });
 type GetPostTimelineError = ({
@@ -47100,7 +47130,7 @@ type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -47120,7 +47150,7 @@ type CreateAdAudienceData = {
         adAccountId: string;
         name: string;
         description?: string;
-        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
+        type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike';
         /**
          * Required for website_retargeting audiences (LinkedIn only).
          * Each rule is a URL pattern; a member who visits any
@@ -47183,11 +47213,11 @@ type CreateAdAudienceData = {
             linkedinPageUrl?: string;
         }>;
         /**
-         * Required for website audiences
+         * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
          */
         pixelId?: string;
         /**
-         * Required for website (max 180) and meta_engagement (max 365) audiences.
+         * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
          */
         retentionDays?: number;
         /**
@@ -47202,10 +47232,26 @@ type CreateAdAudienceData = {
          */
         sourceId?: string;
         /**
-         * meta_engagement only. The engagement event; defaults per source
+         * meta_engagement: the engagement event; defaults per source
          * (page → page_engaged, instagram → ig_business_profile_all,
          * video → video_watched). Ignored when `rule` is provided.
          *
+         * website on TikTok: the pixel event (default `PAGE BROWSE`). website
+         * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
+         *
+         * tiktok_engagement (required): the TikTok engagement event, validated
+         * per `source` (TikTok's filter values, spaces included):
+         * - ads: `CLICK`, `IMPRESSION`, `PLAY 2S`, `PLAY 6S`, `PLAY 25`, `PLAY 50`, `PLAY 75`,
+         * `PLAY OVER`, and the `ENGAGEMENT APP PROFILE` / `ENGAGEMENT TIKTOK INSTANT` /
+         * `ENGAGEMENT COLLECTION ADS` `CLICK` and `IMPRESSION` events.
+         * - organic_video: `ORGANIC VIDEO PLAY 2S`, `ORGANIC VIDEO PLAY 6S`,
+         * `ORGANIC VIDEO PLAY OVER`, `ORGANIC VIDEO ENGAGEMENT`.
+         * - live_video: `LIVE VIDEO VIEW`, `LIVE VIDEO ENGAGEMENT`.
+         * - business_account: `BUSINESS ACCOUNT PROFILE FOLLOW`, `BUSINESS ACCOUNT PROFILE VISIT`,
+         * `BUSINESS ACCOUNT ENGAGEMENT`, `BUSINESS ACCOUNT PLAY 2S`, `BUSINESS ACCOUNT PLAY 6S`,
+         * `BUSINESS ACCOUNT PLAY OVER` and the rest of TikTok's business-account events.
+         * An unknown value is a 400 that lists the valid ones.
+         *
          */
         event?: string;
         /**
@@ -47217,17 +47263,66 @@ type CreateAdAudienceData = {
          */
         country?: string;
         /**
-         * Required for lookalike audiences
+         * lookalike on Meta (0.01-0.20) and Pinterest (0.01-0.10, whole percents). Rejected on TikTok and Google.
          */
         ratio?: number;
         /**
-         * website only. Narrows the audience from all visitors to visitors of
-         * URLs containing this substring. Ignored when `rule` is supplied.
+         * lookalike on TikTok and Google: audience breadth. Rejected on Meta and Pinterest.
+         */
+        size?: 'narrow' | 'balanced' | 'broad';
+        /**
+         * Required for tiktok_engagement: what people engaged with.
+         */
+        source?: 'ads' | 'organic_video' | 'live_video' | 'business_account';
+        /**
+         * tiktok_engagement: ad group / campaign ids for `ads`, video ids for `organic_video` and `live_video` (max 10). Required except for `business_account`.
+         */
+        sourceIds?: Array<(string)>;
+        /**
+         * tiktok_engagement: the TikTok identity that owns the videos or business account. Required for organic_video, live_video and business_account.
+         */
+        identityId?: string;
+        /**
+         * tiktok_engagement: type of `identityId`.
+         */
+        identityType?: 'TT_USER' | 'BC_AUTH_TT';
+        /**
+         * tiktok_engagement: required when identityType is BC_AUTH_TT.
+         */
+        identityAuthorizedBcId?: string;
+        /**
+         * pinterest_engagement: Pinterest's `engager_type`, passed through when set.
+         */
+        engagerType?: 1 | 2;
+        /**
+         * pinterest_engagement: limit to one engagement action.
+         */
+        engagementType?: 'click' | 'save' | 'closeup' | 'comment' | 'like';
+        /**
+         * pinterest_engagement: people who engaged with Pins from these domains. The domain must be claimed on the Pinterest account or Pinterest rejects it.
+         */
+        engagementDomains?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these campaigns' ads.
+         */
+        campaignIds?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these ads.
+         */
+        adIds?: Array<(string)>;
+        /**
+         * pinterest_engagement: people who engaged with these Pins. At least one of engagementDomains, campaignIds, adIds or pinIds is required.
+         */
+        pinIds?: Array<(string)>;
+        /**
+         * website on Meta, TikTok and Google. Narrows the audience from all visitors
+         * to visitors of URLs containing this substring. Ignored when `rule` is
+         * supplied. A 400 on Pinterest, which only matches exact URLs.
          *
          */
         urlContains?: string;
         /**
-         * Optional raw Meta rule, replacing the one we build. Omit it for all
+         * Meta only (a 400 elsewhere). Optional raw Meta rule, replacing the one we build. Omit it for all
          * visitors of `pixelId`, or use `urlContains` for the common page-match
          * case.
          *

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -12482,8 +12482,28 @@ export const listAdAudiences = <ThrowOnError extends boolean = false>(options: O
 
 /**
  * Create custom audience
- * Create a custom audience. `customer_list` is supported on Meta, Google, X, LinkedIn, TikTok, and Pinterest;
- * `website` and `lookalike` are Meta-only; `company_list`, `engagement` and `website_retargeting` are LinkedIn-only.
+ * Create a custom audience. `customer_list` is supported on Meta, Google, X, LinkedIn, TikTok, and Pinterest.
+ * `website` (pixel/tag visitors) and `lookalike` are supported on Meta, TikTok, Pinterest and Google.
+ * `meta_engagement` is Meta-only, `tiktok_engagement` TikTok-only, `pinterest_engagement` Pinterest-only;
+ * `company_list`, `engagement` and `website_retargeting` are LinkedIn-only. A type sent to a platform
+ * that does not support it is a 422 `FEATURE_NOT_AVAILABLE`.
+ *
+ * Per-platform rules for `website`:
+ *
+ * - Meta: `pixelId` required, `retentionDays` 1-180, optional `urlContains` or raw `rule`. `event` is not accepted.
+ * - TikTok: `pixelId` required, `retentionDays` one of 7, 14, 30, 60, 90, 180. `event` is a TikTok pixel event
+ * (default `PAGE BROWSE`; also `CLICK BUTTON`, `PIXEL SUBMIT FORM`, `CONTACT`, `DOWNLOAD`,
+ * `PIXEL ADD PAYMENT INFO`, `COMPLETE PAYMENT`, `INITIATE CHECKOUT`, `COMPLETE REGISTRATION`,
+ * `PRODUCT DETAIL PAGE BROWSE`, `PIXEL SEARCH`, `PIXEL ADD TO CART`, `PLACE AN ORDER`,
+ * `PIXEL ADD TO WISHLIST`, `PIXEL SUBSCRIBE`), optional `urlContains`.
+ * - Pinterest: `pixelId` is the Pinterest tag id, `retentionDays` 1-540, optional `event` (e.g. `checkout`, `addtocart`).
+ * Pinterest matches URLs exactly, so `urlContains` is a 400 there.
+ * - Google: no `pixelId` (the account's Google tag is used), `retentionDays` 1-540, `urlContains`
+ * defaults to `/` (all visitors). Built as a rule-based user list with prepopulation requested.
+ *
+ * Per-platform rules for `lookalike`: Meta takes `ratio` (0.01-0.20); Pinterest takes `ratio` in whole
+ * percents (0.01-0.10) and `country` US, CA or GB; TikTok and Google take `size` (narrow, balanced, broad)
+ * instead of `ratio`. TikTok needs a seed with at least 1,000 matched people.
  * `saved_targeting` stores a reusable TargetingSpec (no member upload, no adAccountId) that you reference later via
  * `savedTargetingId` on `POST /v1/ads/create`.
  *
@@ -12494,7 +12514,8 @@ export const listAdAudiences = <ThrowOnError extends boolean = false>(options: O
  * - `company_list` is filled AT CREATION from the `companies` array below, which is required. To change the list
  * afterwards send the new full list to `POST /v1/ads/audiences/{audienceId}/companies` (a replace, not a merge).
  * The `/users` endpoint rejects these audiences with a 422.
- * - `website`, `website_retargeting`, `engagement`, `meta_engagement` and `lookalike` fill themselves from the pixel,
+ * - `website`, `website_retargeting`, `engagement`, `meta_engagement`, `tiktok_engagement`, `pinterest_engagement`
+ * and `lookalike` fill themselves from the pixel,
  * engagement source or seed audience you point them at. They take no member upload at all.
  *
  * Create is not idempotent, never auto-retry.

package/src/generated/types.gen.ts

@@ -1676,6 +1676,16 @@ export type AnalyticsDeltaEntry = {
         audienceCountries: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays. 0 elsewhere.
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second, keyed by the second, fractions 0 to 1. Empty object elsewhere.
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     };
 };
 
@@ -8848,6 +8858,16 @@ export type PostAnalytics = {
     audienceCountries?: {
         [key: string]: (number);
     };
+    /**
+     * Facebook Reels only: plays that were replays (Meta fb_reels_replay_count). Summed across accounts. 0 for other media and platforms.
+     */
+    replays?: number;
+    /**
+     * Facebook Reels only: share of plays still watching at each second of the Reel, keyed by the second from "0", fractions 0 to 1 (Meta post_video_retention_graph). Empty object for other media and platforms. Views-weighted across accounts like impressionSources.
+     */
+    retentionCurve?: {
+        [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.
      */
@@ -16508,6 +16528,16 @@ export type GetPostTimelineResponse = ({
         audienceCountries?: {
             [key: string]: (number);
         };
+        /**
+         * Facebook Reels only: plays that were replays, as of this date; 0 elsewhere
+         */
+        replays?: number;
+        /**
+         * Facebook Reels only: share of plays still watching at each second as of this date, keyed by the second, fractions 0 to 1; empty object elsewhere
+         */
+        retentionCurve?: {
+            [key: string]: (number);
+        };
     }>;
 });
 
@@ -47953,7 +47983,7 @@ export type ListAdAudiencesResponse = ({
         platformAudienceId?: string;
         name?: string;
         description?: string;
-        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
+        type?: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike' | 'saved_targeting';
         /**
          * Present (and the only meaningful payload) when `type` is `saved_targeting`. Null for uploaded/derived audience types.
          */
@@ -47975,7 +48005,7 @@ export type CreateAdAudienceData = {
     adAccountId: string;
     name: string;
     description?: string;
-    type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'website' | 'website_retargeting' | 'lookalike';
+    type: 'customer_list' | 'company_list' | 'engagement' | 'meta_engagement' | 'tiktok_engagement' | 'pinterest_engagement' | 'website' | 'website_retargeting' | 'lookalike';
     /**
      * Required for website_retargeting audiences (LinkedIn only).
      * Each rule is a URL pattern; a member who visits any
@@ -48038,11 +48068,11 @@ export type CreateAdAudienceData = {
         linkedinPageUrl?: string;
     }>;
     /**
-     * Required for website audiences
+     * website: the Meta pixel, TikTok pixel or Pinterest tag id. Required on those three, rejected on Google.
      */
     pixelId?: string;
     /**
-     * Required for website (max 180) and meta_engagement (max 365) audiences.
+     * Required for website (Meta max 180, TikTok 7/14/30/60/90/180, Pinterest and Google max 540), meta_engagement (max 365) and tiktok_engagement (7/14/30/60/90/180; organic and live video and most business-account events only 7/14/30).
      */
     retentionDays?: number;
     /**
@@ -48057,10 +48087,26 @@ export type CreateAdAudienceData = {
      */
     sourceId?: string;
     /**
-     * meta_engagement only. The engagement event; defaults per source
+     * meta_engagement: the engagement event; defaults per source
      * (page → page_engaged, instagram → ig_business_profile_all,
      * video → video_watched). Ignored when `rule` is provided.
      *
+     * website on TikTok: the pixel event (default `PAGE BROWSE`). website
+     * on Pinterest: the tag event (`pagevisit`, `signup`, `checkout`, `viewcategory`, `search`, `addtocart`, `watchvideo`, `lead`, `custom` or a partner-defined event).
+     *
+     * tiktok_engagement (required): the TikTok engagement event, validated
+     * per `source` (TikTok's filter values, spaces included):
+     * - ads: `CLICK`, `IMPRESSION`, `PLAY 2S`, `PLAY 6S`, `PLAY 25`, `PLAY 50`, `PLAY 75`,
+     * `PLAY OVER`, and the `ENGAGEMENT APP PROFILE` / `ENGAGEMENT TIKTOK INSTANT` /
+     * `ENGAGEMENT COLLECTION ADS` `CLICK` and `IMPRESSION` events.
+     * - organic_video: `ORGANIC VIDEO PLAY 2S`, `ORGANIC VIDEO PLAY 6S`,
+     * `ORGANIC VIDEO PLAY OVER`, `ORGANIC VIDEO ENGAGEMENT`.
+     * - live_video: `LIVE VIDEO VIEW`, `LIVE VIDEO ENGAGEMENT`.
+     * - business_account: `BUSINESS ACCOUNT PROFILE FOLLOW`, `BUSINESS ACCOUNT PROFILE VISIT`,
+     * `BUSINESS ACCOUNT ENGAGEMENT`, `BUSINESS ACCOUNT PLAY 2S`, `BUSINESS ACCOUNT PLAY 6S`,
+     * `BUSINESS ACCOUNT PLAY OVER` and the rest of TikTok's business-account events.
+     * An unknown value is a 400 that lists the valid ones.
+     *
      */
     event?: string;
     /**
@@ -48072,17 +48118,66 @@ export type CreateAdAudienceData = {
      */
     country?: string;
     /**
-     * Required for lookalike audiences
+     * lookalike on Meta (0.01-0.20) and Pinterest (0.01-0.10, whole percents). Rejected on TikTok and Google.
      */
     ratio?: number;
     /**
-     * website only. Narrows the audience from all visitors to visitors of
-     * URLs containing this substring. Ignored when `rule` is supplied.
+     * lookalike on TikTok and Google: audience breadth. Rejected on Meta and Pinterest.
+     */
+    size?: 'narrow' | 'balanced' | 'broad';
+    /**
+     * Required for tiktok_engagement: what people engaged with.
+     */
+    source?: 'ads' | 'organic_video' | 'live_video' | 'business_account';
+    /**
+     * tiktok_engagement: ad group / campaign ids for `ads`, video ids for `organic_video` and `live_video` (max 10). Required except for `business_account`.
+     */
+    sourceIds?: Array<(string)>;
+    /**
+     * tiktok_engagement: the TikTok identity that owns the videos or business account. Required for organic_video, live_video and business_account.
+     */
+    identityId?: string;
+    /**
+     * tiktok_engagement: type of `identityId`.
+     */
+    identityType?: 'TT_USER' | 'BC_AUTH_TT';
+    /**
+     * tiktok_engagement: required when identityType is BC_AUTH_TT.
+     */
+    identityAuthorizedBcId?: string;
+    /**
+     * pinterest_engagement: Pinterest's `engager_type`, passed through when set.
+     */
+    engagerType?: 1 | 2;
+    /**
+     * pinterest_engagement: limit to one engagement action.
+     */
+    engagementType?: 'click' | 'save' | 'closeup' | 'comment' | 'like';
+    /**
+     * pinterest_engagement: people who engaged with Pins from these domains. The domain must be claimed on the Pinterest account or Pinterest rejects it.
+     */
+    engagementDomains?: Array<(string)>;
+    /**
+     * pinterest_engagement: people who engaged with these campaigns' ads.
+     */
+    campaignIds?: Array<(string)>;
+    /**
+     * pinterest_engagement: people who engaged with these ads.
+     */
+    adIds?: Array<(string)>;
+    /**
+     * pinterest_engagement: people who engaged with these Pins. At least one of engagementDomains, campaignIds, adIds or pinIds is required.
+     */
+    pinIds?: Array<(string)>;
+    /**
+     * website on Meta, TikTok and Google. Narrows the audience from all visitors
+     * to visitors of URLs containing this substring. Ignored when `rule` is
+     * supplied. A 400 on Pinterest, which only matches exact URLs.
      *
      */
     urlContains?: string;
     /**
-     * Optional raw Meta rule, replacing the one we build. Omit it for all
+     * Meta only (a 400 elsewhere). Optional raw Meta rule, replacing the one we build. Omit it for all
      * visitors of `pixelId`, or use `urlContains` for the common page-match
      * case.
      *