@zernio/node 0.2.994 → 0.2.995

package/dist/index.d.mts

@@ -10902,7 +10902,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok.
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
      */
     behaviors?: Array<{
         id: string;
@@ -44067,7 +44067,7 @@ type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
          */
         behaviors?: Array<{
             id: string;
@@ -45373,7 +45373,7 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` is Meta only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
@@ -45401,7 +45401,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
+         * What the result is. Equals the requested dimension (interest, behavior, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**

package/dist/index.d.ts

@@ -10902,7 +10902,7 @@ type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok.
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
      */
     behaviors?: Array<{
         id: string;
@@ -44067,7 +44067,7 @@ type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
          */
         behaviors?: Array<{
             id: string;
@@ -45373,7 +45373,7 @@ type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` is Meta only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
@@ -45401,7 +45401,7 @@ type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
+         * What the result is. Equals the requested dimension (interest, behavior, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**

package/dist/index.js

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

package/dist/index.mjs

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

package/package.json

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

package/src/generated/sdk.gen.ts

@@ -11981,15 +11981,27 @@ export const searchAdInterests = <ThrowOnError extends boolean = false>(options:
  *
  * - `geo`: locations, further scoped by `geoType`
  * - `interest`
- * - `behavior`
- * - `income`
+ * - `behavior`: Meta-only, matched by name against Meta's fixed behaviors catalog
+ * (e.g. `Small business owners`, `Frequent Travelers`); ids feed `TargetingSpec.behaviors`
+ * - `income`: the household-income tiers the platform can target (Meta, TikTok, Google).
+ * The id is the normalized tier (`top_5`, `top_10`, `top_10_25`, `top_25_50`) to pass as
+ * `TargetingSpec.incomeTier`, never a platform segment id. Meta's tiers are US-only
+ * ZIP-code percentiles (label and `audienceSize` come live from Meta), TikTok expresses all
+ * four and Google only `top_10`. `q` is matched against the label, so `top` or `income`
+ * lists every tier
  * - `language`: Google-only
  * - `workPosition`, `workEmployer`, `workIndustry`: the Meta-only work demographics, whose
  * ids feed `TargetingSpec.workPositions`/`workEmployers`/`workIndustries`
  * - `industry`, `jobFunction`, `seniority`, `companySize`: the LinkedIn-only B2B facets, whose
  * URNs feed `TargetingSpec.industries`/`jobFunctions`/`seniorities`/`companySizes`
  *
- * Availability of each dimension varies by platform (e.g. behaviours are Meta/TikTok only).
+ * Availability of each dimension varies by platform. A dimension a platform cannot search
+ * returns a 400 naming `dimension`; it never falls back to another dimension, and every
+ * result's `type` is the requested dimension (or the geo level for `geo`).
+ *
+ * TikTok `interest` searches TikTok's interest category catalog (about 700 categories over
+ * four levels, `path` holds the parent categories), matched by name in Zernio. The ids are
+ * what `TargetingSpec.interests` sends to TikTok as `interest_category_ids`.
  * Work industries are a fixed ~30-entry Meta catalog with no server-side query,
  * so `workIndustry` matching, ranking and `limit` happen in Zernio. `language`
  * is likewise a fixed, checked-in table of Google's targetable

package/src/generated/types.gen.ts

@@ -9425,7 +9425,7 @@ export type TargetingSpec = {
         name?: string;
     }>;
     /**
-     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok.
+     * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400).
      */
     behaviors?: Array<{
         id: string;
@@ -44815,7 +44815,7 @@ export type CreateStandaloneAdData = {
             address?: string;
         }>;
         /**
-         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta and TikTok. Each must include id.
+         * Behaviour entities from /v1/ads/targeting/search?dimension=behavior. Supported on Meta only (TikTok behaviours are rejected with a 400). Each must include id.
          */
         behaviors?: Array<{
             id: string;
@@ -46166,7 +46166,7 @@ export type SearchAdTargetingData = {
          */
         countryCode?: string;
         /**
-         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities, `income` resolves income-tier options, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
+         * What to search. `geo` resolves locations (scope further with `geoType`), `interest`/`behavior` resolve audience entities (`behavior` is Meta only), `income` resolves the normalized income tiers, `language` resolves Google's targetable language_constant table (Google only), `workPosition`/`workEmployer`/`workIndustry` resolve Meta work demographics, `industry`/`jobFunction`/`seniority`/`companySize` resolve LinkedIn B2B facets (LinkedIn only). Defaults to `interest` for backward compatibility with the deprecated /v1/ads/interests alias.
          */
         dimension?: 'geo' | 'interest' | 'behavior' | 'income' | 'language' | 'workPosition' | 'workEmployer' | 'workIndustry' | 'industry' | 'jobFunction' | 'seniority' | 'companySize';
         /**
@@ -46195,7 +46195,7 @@ export type SearchAdTargetingResponse = ({
          */
         name: string;
         /**
-         * What the result is (e.g. city, region, country, zip, metro, location, interest, behavior, income, industry, jobFunction, seniority, companySize).
+         * What the result is. Equals the requested dimension (interest, behavior, income, language, workPosition, workEmployer, workIndustry, industry, jobFunction, seniority, companySize), or the location level for geo (country, region, city, zip, metro, ...).
          */
         type: string;
         /**