@getlatedev/node 0.2.373 → 0.2.375

package/dist/index.d.mts

@@ -4420,19 +4420,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -4475,18 +4475,18 @@ type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -4538,7 +4538,7 @@ type TargetingSpec = {
      */
     incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
     /**
-     * Language codes (e.g. ['en']).
+     * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code ("en_GB", "pt_BR") for a specific one. Unknown codes are rejected.
      */
     languages?: Array<(string)>;
     /**
@@ -7195,6 +7195,18 @@ type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7910,10 +7922,17 @@ type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 type GetYouTubeDemographicsResponse = (YouTubeDemographicsResponse);
@@ -12654,6 +12673,10 @@ type GetGmbLocationsData = {
          * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
          */
         filter?: string;
+        /**
+         * Max locations to return (default 100, max 500). Raise it to enumerate an account with more than 100 locations; for accounts with thousands, use search/filter instead.
+         */
+        limit?: number;
         /**
          * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
          */
@@ -12678,9 +12701,9 @@ type GetGmbLocationsResponse = ({
     selectedLocationId?: string;
     cached?: boolean;
 });
-type GetGmbLocationsError = ({
+type GetGmbLocationsError = (unknown | {
     error?: string;
-} | unknown);
+});
 type UpdateGmbLocationData = {
     body: {
         selectedLocationId: string;
@@ -23423,16 +23446,16 @@ type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -23835,7 +23858,7 @@ type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -23902,7 +23925,7 @@ type CreateStandaloneAdData = {
          */
         incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
         /**
-         * Language codes (e.g. ['en']). Restricts the audience by language.
+         * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en'], ['de']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code for a specific one ("en_GB", "pt_BR", "zh_TW"). Unknown codes are rejected. Other ad platforms use their own language-code systems.
          */
         languages?: Array<(string)>;
         /**
@@ -25874,6 +25897,10 @@ type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{

package/dist/index.d.ts

@@ -4420,19 +4420,19 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -4475,18 +4475,18 @@ type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -4538,7 +4538,7 @@ type TargetingSpec = {
      */
     incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
     /**
-     * Language codes (e.g. ['en']).
+     * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code ("en_GB", "pt_BR") for a specific one. Unknown codes are rejected.
      */
     languages?: Array<(string)>;
     /**
@@ -7195,6 +7195,18 @@ type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7910,10 +7922,17 @@ type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 type GetYouTubeDemographicsResponse = (YouTubeDemographicsResponse);
@@ -12654,6 +12673,10 @@ type GetGmbLocationsData = {
          * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
          */
         filter?: string;
+        /**
+         * Max locations to return (default 100, max 500). Raise it to enumerate an account with more than 100 locations; for accounts with thousands, use search/filter instead.
+         */
+        limit?: number;
         /**
          * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
          */
@@ -12678,9 +12701,9 @@ type GetGmbLocationsResponse = ({
     selectedLocationId?: string;
     cached?: boolean;
 });
-type GetGmbLocationsError = ({
+type GetGmbLocationsError = (unknown | {
     error?: string;
-} | unknown);
+});
 type UpdateGmbLocationData = {
     body: {
         selectedLocationId: string;
@@ -23423,16 +23446,16 @@ type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -23835,7 +23858,7 @@ type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -23902,7 +23925,7 @@ type CreateStandaloneAdData = {
          */
         incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
         /**
-         * Language codes (e.g. ['en']). Restricts the audience by language.
+         * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en'], ['de']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code for a specific one ("en_GB", "pt_BR", "zh_TW"). Unknown codes are rejected. Other ad platforms use their own language-code systems.
          */
         languages?: Array<(string)>;
         /**
@@ -25874,6 +25897,10 @@ type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -279,8 +279,11 @@ export const getInstagramDemographics = <ThrowOnError extends boolean = false>(o
 /**
  * Get YouTube demographics
  * Returns audience demographic insights for a YouTube channel, broken down by age, gender, and/or country.
+ * Pass videoId to get the audience profile of a single video instead of the whole channel.
  * Age and gender values are viewer percentages (0-100). Country values are view counts.
- * Data is based on signed-in viewers only, with a 2-3 day delay. Requires the Analytics add-on.
+ * Data is based on signed-in viewers only, with a 2-3 day delay. YouTube suppresses demographics
+ * for videos with too few signed-in views, so low-traffic videos can return empty breakdowns.
+ * Requires the Analytics add-on.
  *
  */
 export const getYouTubeDemographics = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetYouTubeDemographicsData, ThrowOnError>) => {
@@ -2024,7 +2027,7 @@ export const updateYoutubeDefaultPlaylist = <ThrowOnError extends boolean = fals
 
 /**
  * List GBP locations
- * Returns Google Business Profile locations the connected account can access, plus the currently selected location. The list is bounded (see hasMore); for accounts that own many locations, use the search or filter query params to find a specific one instead of loading them all.
+ * Returns Google Business Profile locations the connected account can access, plus the currently selected location. The list is bounded (see hasMore); for accounts that own many locations, use the search or filter query params to find a specific one instead of loading them all, or raise limit to enumerate an account with more than 100 locations.
  *
  */
 export const getGmbLocations = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetGmbLocationsData, ThrowOnError>) => {

package/src/generated/types.gen.ts

@@ -3692,19 +3692,19 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
+     * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits; both must be set together or both omitted. `radius` is only honoured on platforms whose capability map allows city radius (Meta).
      */
     cities?: Array<{
         key: string;
         name?: string;
         /**
-         * Radius around the city. Requires distance_unit.
+         * Radius around the city. Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng), which allows a smaller radius.
          */
         radius?: number;
         /**
          * Required if radius is set.
          */
-        distance_unit?: 'mile' | 'kilometer';
+        distanceUnit?: 'mile' | 'kilometer';
     }>;
     /**
      * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`). Supported on Meta, Google, TikTok, Pinterest, X.
@@ -3747,18 +3747,18 @@ export type TargetingSpec = {
             name?: string;
         }>;
         /**
-         * Cities to exclude. Optional `radius` + `distance_unit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
+         * Cities to exclude. Optional `radius` + `distanceUnit` exclude a catchment around the city (both must be set together or both omitted); Meta honours the radius on excluded cities.
          */
         cities?: Array<{
             key: string;
             /**
-             * Radius around the excluded city. Requires distance_unit.
+             * Radius around the excluded city. Requires distanceUnit.
              */
             radius?: number;
             /**
              * Required if radius is set.
              */
-            distance_unit?: 'mile' | 'kilometer';
+            distanceUnit?: 'mile' | 'kilometer';
         }>;
         zips?: Array<{
             key: string;
@@ -3810,7 +3810,7 @@ export type TargetingSpec = {
      */
     incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
     /**
-     * Language codes (e.g. ['en']).
+     * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code ("en_GB", "pt_BR") for a specific one. Unknown codes are rejected.
      */
     languages?: Array<(string)>;
     /**
@@ -6577,6 +6577,18 @@ export type YouTubeDemographicsResponse = {
      */
     accountId?: string;
     platform?: string;
+    /**
+     * Present only when demographics are scoped to a single video
+     */
+    videoId?: string;
+    /**
+     * Video title (video mode only)
+     */
+    title?: (string) | null;
+    /**
+     * Video publish date (video mode only)
+     */
+    publishedAt?: (string) | null;
     /**
      * Object keyed by breakdown dimension (age, gender, country)
      */
@@ -7338,10 +7350,17 @@ export type GetYouTubeDemographicsData = {
          */
         endDate?: string;
         /**
-         * Start date in YYYY-MM-DD format. Defaults to 90 days ago.
+         * Start date in YYYY-MM-DD format. Defaults to 90 days ago, or to the video's
+         * publish date (lifetime) when videoId is provided.
          *
          */
         startDate?: string;
+        /**
+         * YouTube video ID. When provided, demographics are scoped to this single video
+         * (must belong to the connected channel; otherwise 404 video_not_found).
+         *
+         */
+        videoId?: string;
     };
 };
 
@@ -12437,6 +12456,10 @@ export type GetGmbLocationsData = {
          * Raw Google Business Information API filter expression (advanced; takes precedence over search), e.g. storeCode="LH279411".
          */
         filter?: string;
+        /**
+         * Max locations to return (default 100, max 500). Raise it to enumerate an account with more than 100 locations; for accounts with thousands, use search/filter instead.
+         */
+        limit?: number;
         /**
          * Free-text search on the business name, applied server-side by Google. Use for accounts with many locations.
          */
@@ -12463,9 +12486,9 @@ export type GetGmbLocationsResponse = ({
     cached?: boolean;
 });
 
-export type GetGmbLocationsError = ({
+export type GetGmbLocationsError = (unknown | {
     error?: string;
-} | unknown);
+});
 
 export type UpdateGmbLocationData = {
     body: {
@@ -24082,16 +24105,16 @@ export type BoostPostData = {
                 name?: string;
             }>;
             /**
-             * City targeting. Optional `radius` + `distance_unit` extend beyond the city limits (both set together, Meta only).
+             * City targeting. Optional `radius` + `distanceUnit` extend beyond the city limits (both set together, Meta only).
              */
             cities?: Array<{
                 key: string;
                 name?: string;
                 /**
-                 * Requires distance_unit.
+                 * Requires distanceUnit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
                  */
                 radius?: number;
-                distance_unit?: 'mile' | 'kilometer';
+                distanceUnit?: 'mile' | 'kilometer';
             }>;
             /**
              * Postal/ZIP targeting. `key` is the platform's postal location ID (e.g. Meta `US:94304`).
@@ -24497,7 +24520,7 @@ export type CreateStandaloneAdData = {
              */
             key: string;
             /**
-             * Optional radius around the city. Must be set together with distance_unit.
+             * Optional radius around the city. Must be set together with distance_unit. Meta enforces a minimum city radius (~17 km / 10 mi); smaller values resolve to a 0-size audience and the ad fails at launch. For a tighter catchment use customLocations (lat/lng).
              */
             radius?: number;
             /**
@@ -24564,7 +24587,7 @@ export type CreateStandaloneAdData = {
          */
         incomeTier?: 'top_5' | 'top_10' | 'top_10_25' | 'top_25_50';
         /**
-         * Language codes (e.g. ['en']). Restricts the audience by language.
+         * Language codes restricting the audience by language. On Meta, ISO 639-1 codes (e.g. ['en'], ['de']); a bare code targets all regional variants ("en" = all English), or use a region-qualified code for a specific one ("en_GB", "pt_BR", "zh_TW"). Unknown codes are rejected. Other ad platforms use their own language-code systems.
          */
         languages?: Array<(string)>;
         /**
@@ -26641,6 +26664,10 @@ export type CreateCtwaAdData = {
          * TargetingGeoLocationCity. `key` is Meta's city ID
          * (lookupable via GET /v1/ads/targeting/search). `radius`
          * and `distance_unit` are coupled: set both or neither.
+         * Meta enforces a minimum city radius (~17 km / 10 mi);
+         * smaller values resolve to a 0-size audience and the ad
+         * fails at launch. For a tighter catchment use customLocations
+         * (lat/lng).
          *
          */
         cities?: Array<{