taboola-backstage-sdk 0.1.0

package/dist/index.d.cts

@@ -0,0 +1,3454 @@
+import { Options } from 'ky';
+
+/**
+ * OAuth2 authentication module for Taboola Backstage API
+ */
+/**
+ * OAuth2 authentication manager
+ * Handles token acquisition and automatic refresh
+ */
+declare class OAuthManager {
+    private readonly clientId;
+    private readonly clientSecret;
+    private storedToken;
+    private tokenPromise;
+    constructor(clientId: string, clientSecret: string);
+    /**
+     * Get a valid access token, refreshing if necessary
+     */
+    getAccessToken(): Promise<string>;
+    /**
+     * Force refresh the token (e.g., after a 401 response)
+     */
+    refreshToken(): Promise<string>;
+    /**
+     * Clear the stored token
+     */
+    clearToken(): void;
+    /**
+     * Check if a token is expired or about to expire
+     */
+    private isTokenExpired;
+    /**
+     * Fetch a new token from the OAuth endpoint
+     */
+    private fetchToken;
+}
+
+/**
+ * HTTP client wrapper using ky
+ */
+
+/** Default API base URL */
+declare const DEFAULT_BASE_URL = "https://backstage.taboola.com/backstage/api/1.0";
+interface HttpClientOptions {
+    baseUrl?: string | undefined;
+    timeout?: number | undefined;
+    retries?: number | undefined;
+    debug?: boolean | undefined;
+}
+/**
+ * HTTP client for Taboola API requests
+ */
+declare class HttpClient {
+    private readonly client;
+    private readonly authManager;
+    private readonly debug;
+    constructor(authManager: OAuthManager, options?: HttpClientOptions);
+    /**
+     * Make a GET request
+     */
+    get<T>(path: string, options?: Options): Promise<T>;
+    /**
+     * Make a POST request
+     */
+    post<T>(path: string, body?: unknown, options?: Options): Promise<T>;
+    /**
+     * Make a PUT request
+     */
+    put<T>(path: string, body?: unknown, options?: Options): Promise<T>;
+    /**
+     * Make a PATCH request
+     */
+    patch<T>(path: string, body?: unknown, options?: Options): Promise<T>;
+    /**
+     * Make a DELETE request
+     */
+    delete<T>(path: string, options?: Options): Promise<T>;
+    /**
+     * Internal request handler
+     */
+    private request;
+}
+
+/**
+ * Common types shared across the SDK
+ */
+/**
+ * Targeting type - specifies inclusion/exclusion behavior
+ */
+type TargetingType = 'ALL' | 'INCLUDE' | 'EXCLUDE';
+/**
+ * Generic targeting object used across various targeting fields
+ */
+interface TargetingValue<T = string> {
+    type: TargetingType;
+    value: T[] | null;
+    href?: string | null;
+}
+/**
+ * Multi-targeting state for audience segments
+ */
+type MultiTargetingState = 'ALL' | 'EXISTS' | 'NOT_EXISTS';
+/**
+ * Multi-targeting object used for audience targeting
+ */
+interface MultiTargeting {
+    state: MultiTargetingState;
+    value: unknown[] | null;
+    href?: string | null;
+}
+/**
+ * Pagination parameters for list endpoints
+ */
+interface PaginationParams {
+    page?: number;
+    page_size?: number;
+}
+/**
+ * Standard list response wrapper
+ */
+interface ListResponse<T> {
+    results: T[];
+    metadata?: {
+        total?: number;
+        count?: number;
+    };
+}
+/**
+ * Date string in YYYY-MM-DD format
+ */
+type DateString = string;
+/**
+ * Currency codes (ISO 4217)
+ * Common values: USD, EUR, GBP, JPY, AUD, CAD
+ */
+type CurrencyCode = string;
+/**
+ * Approval states for campaigns and items
+ */
+type ApprovalState = 'APPROVED' | 'PENDING' | 'REJECTED';
+/**
+ * Status values for campaigns
+ */
+type CampaignStatus = 'RUNNING' | 'PAUSED' | 'PENDING_APPROVAL' | 'REJECTED' | 'FROZEN' | 'PENDING_START_DATE' | 'EXPIRED' | 'TERMINATED' | 'DEPLETED' | 'DEPLETED_MONTHLY';
+/**
+ * Status values for items
+ */
+type ItemStatus = 'RUNNING' | 'CRAWLING' | 'CRAWLING_ERROR' | 'NEED_TO_EDIT' | 'PAUSED' | 'STOPPED' | 'PENDING_APPROVAL' | 'REJECTED';
+/**
+ * Pricing models
+ */
+type PricingModel = 'CPC' | 'CPM' | 'VCPM' | 'CPV' | 'CPA';
+/**
+ * Spending limit models
+ */
+type SpendingLimitModel = 'MONTHLY' | 'ENTIRE' | 'DAILY' | 'NONE';
+/**
+ * Daily ad delivery models
+ */
+type DailyAdDeliveryModel = 'ACCELERATED' | 'BALANCED' | 'STRICT';
+/**
+ * Marketing objectives
+ */
+type MarketingObjective = 'DRIVE_WEBSITE_TRAFFIC' | 'BRAND_AWARENESS' | 'DRIVE_PURCHASES' | 'GENERATE_LEADS' | 'DRIVE_APP_INSTALLS' | 'MAX_CONVERSIONS';
+/**
+ * Bid strategies
+ */
+type BidStrategy = 'FIXED' | 'SMART' | 'TARGET_CPA' | 'MAX_CONVERSIONS' | 'TARGET_ROAS';
+/**
+ * Traffic allocation modes
+ */
+type TrafficAllocationMode = 'OPTIMIZED' | 'EVEN';
+/**
+ * Platform types
+ */
+type PlatformType = 'DESK' | 'PHON' | 'TBLT';
+/**
+ * Connection types
+ */
+type ConnectionType = 'WIFI' | 'CELLULAR';
+/**
+ * Operating systems
+ */
+type OperatingSystem = 'WINDOWS' | 'MACOSX' | 'LINUX' | 'IOS' | 'ANDROID';
+/**
+ * Call-to-action button types
+ */
+type CTAType = 'NONE' | 'APPLY_NOW' | 'BOOK_NOW' | 'CONTACT_US' | 'DOWNLOAD' | 'GET_OFFER' | 'GET_QUOTE' | 'INSTALL' | 'LEARN_MORE' | 'ORDER_NOW' | 'PLAY_NOW' | 'READ_MORE' | 'SEE_MORE' | 'SHOP_NOW' | 'SIGN_UP' | 'SUBSCRIBE' | 'WATCH_MORE';
+/**
+ * Item types
+ */
+type ItemType = 'ITEM' | 'RSS' | 'RSS_CHILD' | 'VIDEO';
+/**
+ * External brand safety providers
+ */
+type BrandSafetyProvider = 'IAS' | 'DV' | 'MOAT' | 'NONE';
+/**
+ * Report dimension types
+ */
+type ReportDimension = 'day' | 'week' | 'month' | 'campaign' | 'campaign_day' | 'campaign_week' | 'campaign_month' | 'site' | 'site_day' | 'country' | 'country_day' | 'platform' | 'platform_day' | 'browser' | 'browser_day' | 'os_family' | 'os_family_day' | 'item_breakdown';
+
+/**
+ * Authentication types for Taboola Backstage API
+ */
+/**
+ * Client configuration for TaboolaClient
+ */
+interface TaboolaConfig {
+    /** OAuth2 client ID provided by Taboola */
+    clientId: string;
+    /** OAuth2 client secret provided by Taboola */
+    clientSecret: string;
+    /** Base URL for the API (defaults to production) */
+    baseUrl?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Request timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Number of retry attempts for failed requests (default: 3) */
+    retries?: number;
+}
+/**
+ * OAuth2 token response from Taboola
+ */
+interface TokenResponse {
+    /** The access token to use for API requests */
+    access_token: string;
+    /** Token type (always "bearer") */
+    token_type: 'bearer';
+    /** Token lifetime in seconds (typically 43200 = 12 hours) */
+    expires_in: number;
+}
+/**
+ * Internal token storage with expiry tracking
+ */
+interface StoredToken {
+    /** The access token */
+    accessToken: string;
+    /** Timestamp when the token expires */
+    expiresAt: number;
+}
+
+/**
+ * Account types for Taboola Backstage API
+ */
+
+/**
+ * Partner types
+ */
+type PartnerType = 'PUBLISHER' | 'ADVERTISER';
+/**
+ * Account types
+ */
+type AccountType = 'PARTNER' | 'NETWORK';
+/**
+ * Campaign types available to account
+ */
+type CampaignType = 'PAID' | 'VIDEO';
+/**
+ * Account details response
+ */
+interface Account {
+    /** Numeric account ID */
+    id: number;
+    /** Account display name */
+    name: string;
+    /** Alphabetic account ID used in API paths */
+    account_id: string;
+    /** Types of partnerships */
+    partner_types: PartnerType[];
+    /** Account type */
+    type: AccountType;
+    /** Available campaign types */
+    campaign_types: CampaignType[];
+    /** Account currency */
+    currency: CurrencyCode;
+}
+/**
+ * Advertiser account in network
+ */
+interface AdvertiserAccount {
+    /** Numeric account ID */
+    id: number;
+    /** Account display name */
+    name: string;
+    /** Alphabetic account ID */
+    account_id: string;
+    /** Partner types */
+    partner_types: PartnerType[];
+    /** Account type */
+    type: AccountType;
+    /** Campaign types */
+    campaign_types: CampaignType[];
+    /** Account currency */
+    currency: CurrencyCode;
+}
+/**
+ * Response for allowed accounts list
+ */
+interface AllowedAccountsResponse {
+    results: Account[];
+}
+/**
+ * Response for network advertisers list
+ */
+interface NetworkAdvertisersResponse {
+    results: AdvertiserAccount[];
+}
+
+/**
+ * Campaign types for Taboola Backstage API
+ */
+
+/**
+ * Publisher bid modifier entry
+ */
+interface PublisherBidModifier {
+    /** Publisher ID */
+    publisher_id: string;
+    /** Bid modifier value (1.0 = no change, 1.5 = +50%, 0.5 = -50%) */
+    modifier: number;
+}
+/**
+ * Publisher bid modifier collection
+ */
+interface PublisherBidModifierCollection {
+    values: PublisherBidModifier[];
+}
+/**
+ * Publisher bid strategy modifier entry
+ */
+interface PublisherBidStrategyModifier {
+    /** Publisher ID */
+    publisher_id: string;
+    /** Target CPA for this publisher */
+    target_cpa?: number;
+}
+/**
+ * Publisher bid strategy modifier collection
+ */
+interface PublisherBidStrategyModifierCollection {
+    values: PublisherBidStrategyModifier[];
+}
+/**
+ * External brand safety configuration
+ */
+interface ExternalBrandSafety {
+    /** Brand safety provider type */
+    type: BrandSafetyProvider;
+    /** Provider-specific values */
+    values: string[];
+}
+/**
+ * Verification pixel configuration
+ */
+interface VerificationPixel {
+    /** Pixel type */
+    type: string;
+    /** Pixel URL or code */
+    value: string;
+}
+/**
+ * Viewability tag configuration
+ */
+interface ViewabilityTag {
+    /** Tag type */
+    type: string;
+    /** Tag value */
+    value: string;
+}
+/**
+ * Activity schedule rule for day-parting
+ */
+interface ActivityScheduleRule {
+    /** Day of week (SUNDAY, MONDAY, etc.) */
+    day: string;
+    /** Start hour (0-23) */
+    from_hour: number;
+    /** End hour (0-23) */
+    until_hour: number;
+}
+/**
+ * Activity schedule configuration
+ */
+interface ActivitySchedule {
+    /** Schedule mode */
+    mode: 'ALWAYS' | 'CUSTOM';
+    /** Schedule rules (only when mode is CUSTOM) */
+    rules: ActivityScheduleRule[];
+    /** Timezone for the schedule */
+    time_zone: string | null;
+}
+/**
+ * Policy review status
+ */
+interface PolicyReview {
+    /** Rejection reason if rejected */
+    reject_reason: string | null;
+}
+/**
+ * Full Campaign object
+ */
+interface Campaign {
+    /** Unique campaign ID */
+    id: string;
+    /** Account ID the campaign belongs to */
+    advertiser_id: string;
+    /** Campaign name */
+    name: string;
+    /** Branding text shown with ads */
+    branding_text: string;
+    /** Tracking code appended to URLs */
+    tracking_code?: string;
+    /** Pricing model */
+    pricing_model: PricingModel;
+    /** Cost per click */
+    cpc: number;
+    /** Daily spending cap (0 = no cap) */
+    daily_cap: number;
+    /** Daily delivery model */
+    daily_ad_delivery_model: DailyAdDeliveryModel;
+    /** Total spending limit */
+    spending_limit: number;
+    /** Spending limit period */
+    spending_limit_model: SpendingLimitModel;
+    /** Target CPA goal */
+    cpa_goal: number;
+    /** Country targeting */
+    country_targeting: TargetingValue;
+    /** Sub-country (region) targeting */
+    sub_country_targeting: TargetingValue;
+    /** DMA targeting (US only) */
+    dma_country_targeting?: TargetingValue;
+    /** Region targeting */
+    region_country_targeting?: TargetingValue;
+    /** City targeting */
+    city_targeting?: TargetingValue;
+    /** Postal code targeting */
+    postal_code_targeting: TargetingValue;
+    /** Contextual targeting */
+    contextual_targeting?: TargetingValue;
+    /** Platform targeting */
+    platform_targeting: TargetingValue;
+    /** Publisher targeting (blocking) */
+    publisher_targeting: TargetingValue;
+    /** OS targeting */
+    os_targeting: TargetingValue;
+    /** Connection type targeting */
+    connection_type_targeting: TargetingValue;
+    /** Browser targeting */
+    browser_targeting?: TargetingValue;
+    /** Auto publisher targeting */
+    auto_publisher_targeting?: TargetingValue;
+    /** Publisher bid modifiers */
+    publisher_bid_modifier: PublisherBidModifierCollection;
+    /** Publisher bid strategy modifiers */
+    publisher_bid_strategy_modifiers: PublisherBidStrategyModifierCollection;
+    /** Campaign profile ID */
+    campaign_profile?: string | null;
+    /** Internal comments */
+    comments: string;
+    /** Total amount spent */
+    spent: number;
+    /** Bid strategy */
+    bid_strategy?: BidStrategy;
+    /** @deprecated Use bid_strategy instead */
+    bid_type?: string;
+    /** Traffic allocation mode */
+    traffic_allocation_mode: TrafficAllocationMode;
+    /** A/B test end date */
+    traffic_allocation_ab_test_end_date?: DateString | null;
+    /** External brand safety config */
+    external_brand_safety: ExternalBrandSafety;
+    /** Campaign start date */
+    start_date: DateString | null;
+    /** Campaign end date */
+    end_date: DateString;
+    /** Approval state */
+    approval_state: ApprovalState;
+    /** Whether campaign is active */
+    is_active: boolean;
+    /** Campaign status */
+    status: CampaignStatus;
+    /** Marketplace audience targeting */
+    audience_segments_multi_targeting: MultiTargeting;
+    /** Custom audience targeting */
+    custom_audience_targeting: MultiTargeting;
+    /** Marking label targeting */
+    marking_label_multi_targeting?: MultiTargeting;
+    /** Lookalike audience targeting */
+    lookalike_audience_targeting: MultiTargeting;
+    /** Contextual segments targeting */
+    contextual_segments_targeting?: MultiTargeting;
+    /** Marketing objective */
+    marketing_objective: MarketingObjective;
+    /** Verification pixel config */
+    verification_pixel?: VerificationPixel;
+    /** Viewability tag config */
+    viewability_tag?: ViewabilityTag;
+    /** Activity schedule */
+    activity_schedule: ActivitySchedule;
+    /** Policy review status */
+    policy_review: PolicyReview;
+    /** Account currency */
+    currency?: CurrencyCode;
+}
+/**
+ * Campaign creation request
+ */
+interface CreateCampaignRequest {
+    /** Campaign name (required) */
+    name: string;
+    /** Branding text (required) */
+    branding_text: string;
+    /** Cost per click */
+    cpc?: number;
+    /** Spending limit */
+    spending_limit?: number;
+    /** Spending limit model */
+    spending_limit_model?: SpendingLimitModel;
+    /** Marketing objective (required) */
+    marketing_objective: MarketingObjective;
+    /** Daily cap */
+    daily_cap?: number;
+    /** Daily ad delivery model */
+    daily_ad_delivery_model?: DailyAdDeliveryModel;
+    /** Bid strategy */
+    bid_strategy?: BidStrategy;
+    /** CPA goal */
+    cpa_goal?: number;
+    /** Country targeting */
+    country_targeting?: TargetingValue;
+    /** Platform targeting */
+    platform_targeting?: TargetingValue;
+    /** OS targeting */
+    os_targeting?: TargetingValue;
+    /** Start date */
+    start_date?: DateString;
+    /** End date */
+    end_date?: DateString;
+    /** Tracking code */
+    tracking_code?: string;
+    /** Comments */
+    comments?: string;
+    /** Traffic allocation mode */
+    traffic_allocation_mode?: TrafficAllocationMode;
+}
+/**
+ * Campaign update request
+ */
+interface UpdateCampaignRequest {
+    /** Campaign name */
+    name?: string;
+    /** Branding text */
+    branding_text?: string;
+    /** Cost per click */
+    cpc?: number;
+    /** Spending limit */
+    spending_limit?: number;
+    /** Spending limit model */
+    spending_limit_model?: SpendingLimitModel;
+    /** Daily cap */
+    daily_cap?: number;
+    /** Daily ad delivery model */
+    daily_ad_delivery_model?: DailyAdDeliveryModel;
+    /** Bid strategy */
+    bid_strategy?: BidStrategy;
+    /** CPA goal */
+    cpa_goal?: number;
+    /** Country targeting */
+    country_targeting?: TargetingValue;
+    /** Platform targeting */
+    platform_targeting?: TargetingValue;
+    /** OS targeting */
+    os_targeting?: TargetingValue;
+    /** Start date */
+    start_date?: DateString;
+    /** End date */
+    end_date?: DateString;
+    /** Whether campaign is active */
+    is_active?: boolean;
+    /** Tracking code */
+    tracking_code?: string;
+    /** Comments */
+    comments?: string;
+    /** Activity schedule */
+    activity_schedule?: ActivitySchedule;
+}
+/**
+ * Campaign list response
+ */
+interface CampaignListResponse {
+    results: Campaign[];
+    metadata?: {
+        total: number;
+        count: number;
+    };
+}
+/**
+ * Bulk campaign update request item
+ */
+interface BulkCampaignUpdate {
+    /** Campaign ID to update */
+    campaign_id: string;
+    /** Fields to update */
+    update: UpdateCampaignRequest;
+}
+/**
+ * Bulk campaign update request
+ */
+interface BulkCampaignUpdateRequest {
+    campaigns: BulkCampaignUpdate[];
+}
+/**
+ * Campaign patch operation
+ */
+type PatchOperation = 'ADD' | 'REMOVE' | 'REPLACE';
+/**
+ * Campaign patch request for collections
+ */
+interface CampaignPatchRequest {
+    /** Operation type */
+    op: PatchOperation;
+    /** Path to the field */
+    path: string;
+    /** Value to set */
+    value: unknown;
+}
+/**
+ * Campaign reach estimation request
+ */
+interface CampaignReachEstimatorRequest {
+    /** Country codes */
+    country_targeting?: string[];
+    /** Platform types */
+    platform_targeting?: string[];
+    /** Daily budget */
+    daily_cap?: number;
+    /** CPC bid */
+    cpc?: number;
+}
+/**
+ * Campaign reach estimation response
+ */
+interface CampaignReachEstimatorResponse {
+    /** Estimated daily impressions */
+    estimated_impressions: number;
+    /** Estimated daily clicks */
+    estimated_clicks: number;
+    /** Estimated daily reach */
+    estimated_reach: number;
+}
+
+/**
+ * Campaign Item (Ad) types for Taboola Backstage API
+ */
+
+/**
+ * Creative focus type
+ * @deprecated Use automatic cropping instead
+ */
+type CreativeFocusType = 'AUTOMATIC' | 'CUSTOM';
+/**
+ * Coordinates for custom creative focus
+ * @deprecated
+ */
+interface Coordinates {
+    top: number;
+    left: number;
+    right: number;
+    bottom: number;
+}
+/**
+ * Creative focus configuration
+ * @deprecated
+ */
+interface CreativeFocus {
+    type: CreativeFocusType;
+    coordinates: Coordinates | null;
+}
+/**
+ * CTA (Call to Action) configuration
+ */
+interface CTA {
+    /** CTA button type */
+    cta_type: CTAType;
+    /** Custom CTA text (if applicable) */
+    cta_text?: string;
+}
+/**
+ * Verification pixel for item
+ */
+interface ItemVerificationPixel {
+    /** Pixel type */
+    type: string;
+    /** Pixel URL */
+    url: string;
+}
+/**
+ * Viewability tag for item
+ */
+interface ItemViewabilityTag {
+    /** Tag type */
+    type: string;
+    /** Tag value */
+    value: string;
+}
+/**
+ * Policy review status for item
+ */
+interface ItemPolicyReview {
+    /** Rejection reason if rejected */
+    reject_reason: string | null;
+}
+/**
+ * Full Campaign Item (Ad) object
+ */
+interface CampaignItem {
+    /** Unique item ID */
+    id: string;
+    /** Campaign ID this item belongs to */
+    campaign_id: string;
+    /** Item type */
+    type: ItemType;
+    /** Landing page URL */
+    url: string;
+    /** Thumbnail image URL */
+    thumbnail_url: string;
+    /** Ad title/headline */
+    title: string;
+    /** Ad description */
+    description?: string;
+    /** Approval state */
+    approval_state: ApprovalState;
+    /** Whether item is active */
+    is_active: boolean;
+    /** Item status */
+    status: ItemStatus;
+    /** Policy review status */
+    policy_review: ItemPolicyReview;
+    /** CTA button configuration */
+    cta: CTA | null;
+    /**
+     * Creative focus configuration
+     * @deprecated
+     */
+    creative_focus?: CreativeFocus;
+    /** Verification pixel */
+    verification_pixel?: ItemVerificationPixel;
+    /** Viewability tag */
+    viewability_tag?: ItemViewabilityTag;
+    /** Custom data for tracking */
+    custom_data?: string;
+    /** Fallback URL */
+    fallback_url?: string;
+    /** Third-party tracking pixel URLs */
+    third_party_tags?: string[];
+    /** RSS feed URL (for RSS items) */
+    rss_url?: string;
+    /** Parent item ID (for RSS children) */
+    parent_id?: string;
+}
+/**
+ * Create campaign item request
+ */
+interface CreateItemRequest {
+    /** Landing page URL (required) */
+    url: string;
+    /** Ad title/headline (required) */
+    title: string;
+    /** Thumbnail image URL (required unless uploading) */
+    thumbnail_url?: string;
+    /** Ad description */
+    description?: string;
+    /** CTA configuration */
+    cta?: CTA;
+    /** Custom tracking data */
+    custom_data?: string;
+    /** Third-party tracking pixels */
+    third_party_tags?: string[];
+    /** RSS feed URL (creates RSS item) */
+    rss_url?: string;
+}
+/**
+ * Update campaign item request
+ */
+interface UpdateItemRequest {
+    /** Ad title */
+    title?: string;
+    /** Ad description */
+    description?: string;
+    /** Thumbnail image URL */
+    thumbnail_url?: string;
+    /** Whether item is active */
+    is_active?: boolean;
+    /** CTA configuration */
+    cta?: CTA;
+    /** Custom tracking data */
+    custom_data?: string;
+    /** Third-party tracking pixels */
+    third_party_tags?: string[];
+}
+/**
+ * Campaign item list response
+ */
+interface CampaignItemListResponse {
+    results: CampaignItem[];
+    metadata?: {
+        total: number;
+        count: number;
+    };
+}
+/**
+ * Bulk item creation request
+ */
+interface BulkCreateItemsRequest {
+    items: CreateItemRequest[];
+}
+/**
+ * Bulk item creation response
+ */
+interface BulkCreateItemsResponse {
+    results: CampaignItem[];
+    failed?: {
+        item: CreateItemRequest;
+        error: string;
+    }[];
+}
+/**
+ * Bulk item update request (across campaigns)
+ */
+interface BulkUpdateItemsRequest {
+    items: {
+        /** Item ID */
+        id: string;
+        /** Campaign ID */
+        campaign_id: string;
+        /** Fields to update */
+        update: UpdateItemRequest;
+    }[];
+}
+/**
+ * Bulk item delete request (across campaigns)
+ */
+interface BulkDeleteItemsRequest {
+    items: {
+        /** Item ID */
+        id: string;
+        /** Campaign ID */
+        campaign_id: string;
+    }[];
+}
+/**
+ * RSS child item
+ */
+interface RSSChildItem extends CampaignItem {
+    /** Parent RSS item ID */
+    parent_id: string;
+}
+/**
+ * RSS children list response
+ */
+interface RSSChildrenListResponse {
+    results: RSSChildItem[];
+    metadata?: {
+        total: number;
+        count: number;
+    };
+}
+/**
+ * Image upload response
+ */
+interface ImageUploadResponse {
+    /** URL of the uploaded image */
+    url: string;
+    /** Image width */
+    width: number;
+    /** Image height */
+    height: number;
+}
+/**
+ * Image library search parameters
+ */
+interface ImageLibrarySearchParams {
+    /** Search query */
+    query: string;
+    /** Number of results */
+    limit?: number;
+    /** Result offset */
+    offset?: number;
+}
+/**
+ * Image library item
+ */
+interface ImageLibraryItem {
+    /** Image ID */
+    id: string;
+    /** Preview URL */
+    preview_url: string;
+    /** Full URL */
+    url: string;
+    /** Image width */
+    width: number;
+    /** Image height */
+    height: number;
+    /** Image source */
+    source: string;
+}
+/**
+ * Image library search response
+ */
+interface ImageLibrarySearchResponse {
+    results: ImageLibraryItem[];
+    total: number;
+}
+
+/**
+ * Dictionary API Types
+ *
+ * Types for Taboola Backstage API reference/dictionary data.
+ */
+/**
+ * Country for geo targeting
+ */
+interface Country {
+    name: string;
+    value: string;
+}
+/**
+ * Region/state within a country
+ */
+interface Region {
+    name: string;
+    value: string;
+    country: string;
+}
+/**
+ * DMA (Designated Market Area) - US only
+ */
+interface DMA {
+    name: string;
+    value: string;
+    country: string;
+}
+/**
+ * Postal code for geo targeting
+ */
+interface PostalCode {
+    name: string;
+    value: string;
+    country: string;
+}
+/**
+ * Platform for device targeting
+ */
+interface Platform {
+    name: string;
+    value: string;
+}
+/**
+ * Operating system for device targeting
+ */
+interface OperatingSystemInfo {
+    name: string;
+    value: string;
+}
+/**
+ * OS version for device targeting
+ */
+interface OSVersion {
+    name: string;
+    value: string;
+    os_family: string;
+}
+/**
+ * Browser for device targeting
+ */
+interface Browser {
+    name: string;
+    value: string;
+}
+/**
+ * Day of week for activity scheduling
+ */
+interface DayOfWeek {
+    name: string;
+    value: string;
+}
+/**
+ * Minimum CPC value per country/platform
+ */
+interface MinimumCPC {
+    country: string;
+    platform: string;
+    currency: string;
+    min_cpc: number;
+}
+/**
+ * Marketplace audience segment
+ */
+interface MarketplaceAudience {
+    id: string;
+    name: string;
+    description: string | null;
+    provider: string | null;
+    data_partner_id: string | null;
+    parent_id: string | null;
+    has_children: boolean;
+    country: string | null;
+    platform: string | null;
+    full_path: string | null;
+}
+/**
+ * Lookalike audience
+ */
+interface LookalikeAudience {
+    id: string;
+    name: string;
+    description: string | null;
+    source_audience_id: string | null;
+    status: string;
+    size: number | null;
+    country: string | null;
+}
+/**
+ * Contextual segment
+ */
+interface ContextualSegment {
+    id: string;
+    name: string;
+    description: string | null;
+    category: string | null;
+    parent_id: string | null;
+    has_children: boolean;
+}
+/**
+ * Campaign property enums response
+ */
+type CampaignEnums = Record<string, EnumValue[]>;
+/**
+ * Item property enums response
+ */
+type ItemEnums = Record<string, EnumValue[]>;
+/**
+ * Enum value object
+ */
+interface EnumValue {
+    name: string;
+    value: string;
+    description: string | null;
+}
+/**
+ * Postal code search params
+ */
+interface PostalCodeSearchParams {
+    search?: string | undefined;
+    page?: number | undefined;
+    page_size?: number | undefined;
+}
+/**
+ * Supported image library language
+ */
+interface ImageLibraryLanguage {
+    name: string;
+    value: string;
+}
+/**
+ * Image taxonomy
+ */
+interface ImageTaxonomy {
+    id: string;
+    name: string;
+    parent_id: string | null;
+    has_children: boolean;
+}
+
+/**
+ * Publisher API Types
+ *
+ * Types for Taboola Backstage API publisher targeting and blocking.
+ */
+
+/**
+ * Publisher information
+ */
+interface Publisher {
+    site: string;
+    site_id: string;
+    is_blocked: boolean;
+}
+/**
+ * Response for listing publishers
+ */
+type PublisherListResponse = ListResponse<Publisher>;
+/**
+ * Blocked publisher at account level
+ */
+interface BlockedPublisher {
+    site: string;
+    site_id: string;
+}
+/**
+ * Response for blocked publishers
+ */
+interface BlockedPublishersResponse {
+    results: BlockedPublisher[];
+}
+/**
+ * Request to update blocked publishers at account level
+ */
+interface UpdateBlockedPublishersRequest {
+    sites: string[];
+}
+
+/**
+ * Targeting API Types
+ *
+ * Types for Taboola Backstage API campaign targeting including
+ * postal codes, audience segments, and contextual targeting.
+ */
+
+/**
+ * Postal code targeting configuration
+ */
+interface PostalCodeTargeting {
+    type: 'INCLUDE' | 'EXCLUDE' | 'ALL';
+    values: PostalCodeValue[];
+    restrictions: PostalCodeRestrictions | null;
+}
+/**
+ * Individual postal code value
+ */
+interface PostalCodeValue {
+    postal_code: string;
+    country: string;
+}
+/**
+ * Postal code targeting restrictions
+ */
+interface PostalCodeRestrictions {
+    max_postal_codes: number;
+    supported_countries: string[];
+}
+/**
+ * Request to update postal code targeting
+ */
+interface UpdatePostalCodeTargetingRequest {
+    type: 'INCLUDE' | 'EXCLUDE' | 'ALL';
+    values: PostalCodeValue[];
+}
+/**
+ * Audience segment for targeting
+ */
+interface AudienceSegment {
+    id: string;
+    name: string | null;
+}
+/**
+ * Audience targeting configuration (marketplace, custom, lookalike)
+ */
+interface AudienceTargeting {
+    collection: AudienceSegment[];
+    type: MultiTargetingState;
+}
+/**
+ * Request to update audience targeting
+ */
+interface UpdateAudienceTargetingRequest {
+    type: MultiTargetingState;
+    collection?: AudienceSegment[] | undefined;
+    and_collection?: AudienceSegment[][] | undefined;
+    or_collection?: AudienceSegment[][] | undefined;
+}
+/**
+ * Contextual segment for targeting
+ */
+interface ContextualSegmentValue {
+    id: string;
+    name: string | null;
+}
+/**
+ * Contextual targeting configuration
+ */
+interface ContextualTargeting {
+    type: MultiTargetingState;
+    collection: ContextualSegmentValue[];
+}
+/**
+ * Request to update contextual targeting
+ */
+interface UpdateContextualTargetingRequest {
+    type: MultiTargetingState;
+    collection: ContextualSegmentValue[];
+}
+/**
+ * First party audience targeting
+ */
+interface FirstPartyAudienceTargeting {
+    type: MultiTargetingState;
+    collection: AudienceSegment[];
+}
+/**
+ * Request to update first party audience targeting
+ */
+interface UpdateFirstPartyAudienceTargetingRequest {
+    type: MultiTargetingState;
+    collection: AudienceSegment[];
+}
+
+/**
+ * Audience API Types
+ *
+ * Types for Combined Audiences and First Party Audience Onboarding.
+ */
+
+/**
+ * Combined audience - combines multiple audience types with AND/OR logic
+ */
+interface CombinedAudience {
+    id: string;
+    name: string;
+    description: string | null;
+    status: CombinedAudienceStatus;
+    created_at: string;
+    updated_at: string;
+    include_rules: CombinedAudienceRule[];
+    exclude_rules: CombinedAudienceRule[];
+}
+/**
+ * Combined audience status
+ */
+type CombinedAudienceStatus = 'ACTIVE' | 'INACTIVE' | 'DELETED';
+/**
+ * Rule within a combined audience
+ */
+interface CombinedAudienceRule {
+    audience_type: CombinedAudienceType;
+    audiences: CombinedAudienceItem[];
+}
+/**
+ * Type of audience in a combined audience rule
+ */
+type CombinedAudienceType = 'CUSTOM_AUDIENCE' | 'LOOKALIKE_AUDIENCE' | 'MARKETPLACE_AUDIENCE' | 'FIRST_PARTY_AUDIENCE';
+/**
+ * Individual audience item in a rule
+ */
+interface CombinedAudienceItem {
+    id: string;
+    name: string | null;
+}
+/**
+ * Response for listing combined audiences
+ */
+type CombinedAudienceListResponse = ListResponse<CombinedAudience>;
+/**
+ * Request to create a combined audience
+ */
+interface CreateCombinedAudienceRequest {
+    name: string;
+    description?: string | undefined;
+    include_rules: CombinedAudienceRule[];
+    exclude_rules?: CombinedAudienceRule[] | undefined;
+}
+/**
+ * Request to update a combined audience
+ */
+interface UpdateCombinedAudienceRequest {
+    name?: string | undefined;
+    description?: string | undefined;
+    include_rules?: CombinedAudienceRule[] | undefined;
+    exclude_rules?: CombinedAudienceRule[] | undefined;
+}
+/**
+ * Available audience for combined audience creation
+ */
+interface AvailableAudience {
+    id: string;
+    name: string;
+    type: CombinedAudienceType;
+    size: number | null;
+    status: string;
+}
+/**
+ * Response for listing available audiences
+ */
+type AvailableAudiencesResponse = ListResponse<AvailableAudience>;
+/**
+ * First party audience for onboarding
+ */
+interface FirstPartyAudience {
+    id: string;
+    name: string;
+    description: string | null;
+    status: FirstPartyAudienceStatus;
+    size: number | null;
+    match_rate: number | null;
+    created_at: string;
+    updated_at: string;
+    ttl_days: number | null;
+    source_type: FirstPartyAudienceSourceType;
+}
+/**
+ * First party audience status
+ */
+type FirstPartyAudienceStatus = 'BUILDING' | 'READY' | 'FAILED' | 'EXPIRED' | 'ARCHIVED';
+/**
+ * First party audience source type
+ */
+type FirstPartyAudienceSourceType = 'CRM' | 'EMAIL' | 'PHONE' | 'DEVICE_ID' | 'CUSTOM';
+/**
+ * Request to create a first party audience
+ */
+interface CreateFirstPartyAudienceRequest {
+    name: string;
+    description?: string | undefined;
+    ttl_days?: number | undefined;
+    source_type: FirstPartyAudienceSourceType;
+}
+/**
+ * User identifier for first party audience
+ */
+interface FirstPartyAudienceUser {
+    identifier_type: FirstPartyIdentifierType;
+    identifier_value: string;
+}
+/**
+ * Type of user identifier
+ */
+type FirstPartyIdentifierType = 'EMAIL' | 'EMAIL_SHA256' | 'PHONE' | 'PHONE_SHA256' | 'DEVICE_ID' | 'DEVICE_ID_SHA256';
+/**
+ * Request to add or remove users from first party audience
+ */
+interface AddRemoveUsersRequest {
+    add?: FirstPartyAudienceUser[] | undefined;
+    remove?: FirstPartyAudienceUser[] | undefined;
+}
+/**
+ * Response for add/remove users operation
+ */
+interface AddRemoveUsersResponse {
+    added_count: number;
+    removed_count: number;
+    failed_count: number;
+    errors: AddRemoveUserError[];
+}
+/**
+ * Error from add/remove users operation
+ */
+interface AddRemoveUserError {
+    identifier: string;
+    error: string;
+}
+
+/**
+ * Pixel API Types
+ *
+ * Types for Taboola Universal Pixel API including
+ * conversion rules and custom audience rules.
+ */
+
+/**
+ * Conversion rule for tracking conversions
+ */
+interface ConversionRule {
+    id: string;
+    display_name: string;
+    status: ConversionRuleStatus;
+    type: ConversionRuleType;
+    include_in_total_conversions: boolean;
+    include_in_total_value: boolean;
+    category: ConversionCategory | null;
+    conversion_window_days: number;
+    view_through_window_days: number;
+    counting_method: CountingMethod;
+    aggregation_type: AggregationType;
+    default_conversion_value: number | null;
+    conditions: Condition[];
+    effect: Effect;
+    event_name: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Conversion rule status
+ */
+type ConversionRuleStatus = 'ACTIVE' | 'ARCHIVED';
+/**
+ * Conversion rule type
+ */
+type ConversionRuleType = 'EVENT_BASED' | 'URL_BASED' | 'CUSTOM';
+/**
+ * Conversion category
+ */
+type ConversionCategory = 'PURCHASE' | 'LEAD' | 'SIGN_UP' | 'ADD_TO_CART' | 'CHECKOUT' | 'CONTENT_VIEW' | 'SEARCH' | 'ADD_PAYMENT_INFO' | 'SUBSCRIBE' | 'PAGE_VIEW' | 'COMPLETE_REGISTRATION' | 'OTHER';
+/**
+ * Counting method for conversions
+ */
+type CountingMethod = 'ALL' | 'ONE';
+/**
+ * Aggregation type for conversion values
+ */
+type AggregationType = 'SUM' | 'COUNT';
+/**
+ * Condition for matching conversions
+ */
+interface Condition {
+    type: ConditionType;
+    operator: ConditionOperator;
+    value: string;
+    parameter?: string | undefined;
+}
+/**
+ * Condition type
+ */
+type ConditionType = 'URL' | 'URL_PARAMETER' | 'EVENT_NAME' | 'EVENT_PARAMETER';
+/**
+ * Condition operator
+ */
+type ConditionOperator = 'EQUALS' | 'NOT_EQUALS' | 'CONTAINS' | 'NOT_CONTAINS' | 'STARTS_WITH' | 'ENDS_WITH' | 'REGEX';
+/**
+ * Effect of matching a conversion rule
+ */
+interface Effect {
+    type: EffectType;
+    value: number | null;
+    currency: string | null;
+    value_parameter: string | null;
+}
+/**
+ * Effect type
+ */
+type EffectType = 'FIXED_VALUE' | 'DYNAMIC_VALUE' | 'NO_VALUE';
+/**
+ * Response for listing conversion rules
+ */
+type ConversionRuleListResponse = ListResponse<ConversionRule>;
+/**
+ * Request to create a conversion rule
+ */
+interface CreateConversionRuleRequest {
+    display_name: string;
+    type: ConversionRuleType;
+    include_in_total_conversions?: boolean | undefined;
+    include_in_total_value?: boolean | undefined;
+    category?: ConversionCategory | undefined;
+    conversion_window_days?: number | undefined;
+    view_through_window_days?: number | undefined;
+    counting_method?: CountingMethod | undefined;
+    aggregation_type?: AggregationType | undefined;
+    default_conversion_value?: number | undefined;
+    conditions: Condition[];
+    effect: Effect;
+    event_name?: string | undefined;
+}
+/**
+ * Request to update a conversion rule
+ */
+interface UpdateConversionRuleRequest {
+    display_name?: string | undefined;
+    status?: ConversionRuleStatus | undefined;
+    include_in_total_conversions?: boolean | undefined;
+    include_in_total_value?: boolean | undefined;
+    category?: ConversionCategory | undefined;
+    conversion_window_days?: number | undefined;
+    view_through_window_days?: number | undefined;
+    counting_method?: CountingMethod | undefined;
+    aggregation_type?: AggregationType | undefined;
+    default_conversion_value?: number | undefined;
+    conditions?: Condition[] | undefined;
+    effect?: Effect | undefined;
+}
+/**
+ * Custom audience rule for building audiences from pixel data
+ */
+interface CustomAudienceRule {
+    id: string;
+    display_name: string;
+    status: CustomAudienceRuleStatus;
+    conditions: Condition[];
+    ttl_days: number;
+    size: number | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Custom audience rule status
+ */
+type CustomAudienceRuleStatus = 'ACTIVE' | 'PAUSED' | 'ARCHIVED';
+/**
+ * Response for listing custom audience rules
+ */
+type CustomAudienceRuleListResponse = ListResponse<CustomAudienceRule>;
+/**
+ * Request to create a custom audience rule
+ */
+interface CreateCustomAudienceRuleRequest {
+    display_name: string;
+    conditions: Condition[];
+    ttl_days?: number | undefined;
+}
+/**
+ * Request to update a custom audience rule
+ */
+interface UpdateCustomAudienceRuleRequest {
+    display_name?: string | undefined;
+    status?: CustomAudienceRuleStatus | undefined;
+    conditions?: Condition[] | undefined;
+    ttl_days?: number | undefined;
+}
+/**
+ * Conversion rule with additional performance data
+ */
+interface ConversionRuleWithData extends ConversionRule {
+    conversions_30d: number;
+    conversions_value_30d: number;
+    last_conversion_at: string | null;
+}
+/**
+ * Response for listing conversion rules with data
+ */
+type ConversionRuleWithDataListResponse = ListResponse<ConversionRuleWithData>;
+
+/**
+ * Report API Types
+ *
+ * Types for Taboola Backstage API reporting including
+ * Campaign Summary, Top Campaign Content, and Realtime reports.
+ */
+
+/**
+ * Common report parameters
+ */
+interface BaseReportParams {
+    start_date: string;
+    end_date: string;
+}
+/**
+ * Campaign Summary Report parameters
+ */
+interface CampaignSummaryReportParams extends BaseReportParams {
+    /** Filter by specific campaign ID */
+    campaign?: string | undefined;
+    /** Filter by specific site (publisher) */
+    site?: string | undefined;
+    /** Filter by country code */
+    country?: string | undefined;
+    /** Filter by platform */
+    platform?: string | undefined;
+    /** Include custom conversion columns (comma-separated rule names or 'all') */
+    include_conversions?: string | undefined;
+}
+/**
+ * Top Campaign Content Report parameters
+ */
+interface TopCampaignContentReportParams extends BaseReportParams {
+    /** Filter by specific campaign ID */
+    campaign?: string | undefined;
+    /** Limit number of results */
+    limit?: number | undefined;
+    /** Include custom conversion columns */
+    include_conversions?: string | undefined;
+}
+/**
+ * Realtime Report parameters
+ */
+interface RealtimeReportParams {
+    /** Filter by specific campaign ID */
+    campaign?: string | undefined;
+}
+/**
+ * Campaign Summary Report response
+ */
+interface CampaignSummaryReport {
+    'last-used-rawdata-update-time': string;
+    'last-used-rawdata-update-time-gmt-millisec': number;
+    timezone: string;
+    results: CampaignSummaryRow[];
+    recordCount: number;
+    metadata: ReportMetadata;
+}
+/**
+ * Campaign summary report row
+ */
+interface CampaignSummaryRow {
+    /** Date of the data (for day/week/month dimensions) */
+    date?: string | undefined;
+    date_end_period?: string | undefined;
+    /** Campaign ID (for campaign dimension) */
+    campaign?: string | undefined;
+    campaign_name?: string | undefined;
+    /** Site name (for site dimension) */
+    site?: string | undefined;
+    site_id?: string | undefined;
+    /** Country code (for country dimension) */
+    country?: string | undefined;
+    /** Platform (for platform dimension) */
+    platform?: string | undefined;
+    /** Number of clicks */
+    clicks: number;
+    /** Number of impressions */
+    impressions: number;
+    /** Number of visible impressions */
+    visible_impressions: number;
+    /** Total spend */
+    spent: number;
+    /** Click-through rate */
+    ctr: number;
+    /** Visible click-through rate */
+    vctr: number;
+    /** Cost per thousand impressions */
+    cpm: number;
+    /** Visible cost per thousand impressions */
+    vcpm: number;
+    /** Cost per click */
+    cpc: number;
+    /** Number of campaigns */
+    campaigns_num?: number | undefined;
+    /** Currency code */
+    currency: string;
+    /** Total conversion value */
+    conversions_value: number;
+    /** Return on ad spend */
+    roas: number;
+    /** Cost per action (all) */
+    cpa: number;
+    /** CPA from clicks */
+    cpa_clicks: number;
+    /** CPA from views */
+    cpa_views: number;
+    /** Number of conversion actions */
+    cpa_actions_num: number;
+    /** Actions from clicks */
+    cpa_actions_num_from_clicks: number;
+    /** Actions from views */
+    cpa_actions_num_from_views: number;
+    /** Conversion rate (all) */
+    cpa_conversion_rate: number;
+    /** Conversion rate from clicks */
+    cpa_conversion_rate_clicks: number;
+    /** Conversion rate from views */
+    cpa_conversion_rate_views: number;
+    /** Custom conversion columns (dynamic based on include_conversions) */
+    [key: string]: unknown;
+}
+/**
+ * Top Campaign Content Report response
+ */
+interface TopCampaignContentReport {
+    'last-used-rawdata-update-time': string;
+    'last-used-rawdata-update-time-gmt-millisec': number;
+    timezone: string;
+    results: TopCampaignContentRow[];
+    recordCount: number;
+    metadata: ReportMetadata;
+}
+/**
+ * Top campaign content report row
+ */
+interface TopCampaignContentRow {
+    /** Item ID */
+    item: string;
+    item_name: string;
+    /** Thumbnail URL */
+    thumbnail_url: string;
+    /** Campaign ID */
+    campaign: string;
+    campaign_name: string;
+    /** Metrics */
+    clicks: number;
+    impressions: number;
+    visible_impressions: number;
+    spent: number;
+    ctr: number;
+    vctr: number;
+    cpm: number;
+    vcpm: number;
+    cpc: number;
+    currency: string;
+    conversions_value: number;
+    roas: number;
+    cpa: number;
+    cpa_actions_num: number;
+    cpa_conversion_rate: number;
+    /** Custom conversion columns */
+    [key: string]: unknown;
+}
+/**
+ * Realtime Campaign Report response
+ */
+interface RealtimeCampaignReport {
+    timestamp: string;
+    results: RealtimeCampaignRow[];
+}
+/**
+ * Realtime campaign report row
+ */
+interface RealtimeCampaignRow {
+    campaign: string;
+    campaign_name: string;
+    status: string;
+    clicks: number;
+    impressions: number;
+    spent: number;
+    ctr: number;
+    cpc: number;
+    conversions: number;
+    currency: string;
+}
+/**
+ * Realtime Ads Report response
+ */
+interface RealtimeAdsReport {
+    timestamp: string;
+    results: RealtimeAdsRow[];
+}
+/**
+ * Realtime ads report row
+ */
+interface RealtimeAdsRow {
+    item: string;
+    item_name: string;
+    campaign: string;
+    campaign_name: string;
+    status: string;
+    clicks: number;
+    impressions: number;
+    spent: number;
+    ctr: number;
+    cpc: number;
+    conversions: number;
+    currency: string;
+}
+/**
+ * Report metadata
+ */
+interface ReportMetadata {
+    total: number;
+    count: number;
+    static_fields: ReportField[];
+}
+/**
+ * Report field definition
+ */
+interface ReportField {
+    id: string;
+    format: string | null;
+    data_type: ReportDataType;
+}
+/**
+ * Report data type
+ */
+type ReportDataType = 'DATE' | 'STRING' | 'NUMERIC' | 'CURRENCY' | 'PERCENTAGE';
+
+/**
+ * Account API for Taboola Backstage
+ */
+
+/**
+ * Account management API
+ */
+declare class AccountsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get current account details
+     *
+     * Returns details of your primary account including the account_id
+     * needed for most API operations.
+     *
+     * @example
+     * ```typescript
+     * const account = await client.accounts.getCurrent();
+     * console.log(account.account_id); // 'my-account-id'
+     * ```
+     */
+    getCurrent(): Promise<Account>;
+    /**
+     * Get all allowed accounts for the current user
+     *
+     * Returns all accounts the current API credentials have access to.
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.accounts.getAllowed();
+     * for (const account of results) {
+     *   console.log(account.name, account.account_id);
+     * }
+     * ```
+     */
+    getAllowed(): Promise<AllowedAccountsResponse>;
+    /**
+     * Get advertiser accounts in a network
+     *
+     * For network accounts, returns all advertiser accounts within the network.
+     *
+     * @param accountId - Network account ID
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.accounts.getNetworkAdvertisers('my-network');
+     * for (const advertiser of results) {
+     *   console.log(advertiser.name);
+     * }
+     * ```
+     */
+    getNetworkAdvertisers(accountId: string): Promise<NetworkAdvertisersResponse>;
+    /**
+     * Get a specific advertiser account
+     *
+     * @param accountId - Account ID to retrieve
+     *
+     * @example
+     * ```typescript
+     * const account = await client.accounts.get('my-account-id');
+     * console.log(account.currency);
+     * ```
+     */
+    get(accountId: string): Promise<AdvertiserAccount>;
+}
+
+/**
+ * Campaigns API for Taboola Backstage
+ */
+
+/**
+ * Options for listing campaigns
+ */
+interface ListCampaignsOptions {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of results per page */
+    pageSize?: number;
+    /** Filter by status */
+    status?: string;
+    /** Filter by approval state */
+    approvalState?: string;
+}
+/**
+ * Campaign management API
+ */
+declare class CampaignsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all campaigns for an account
+     *
+     * @param accountId - Account ID
+     * @param options - Pagination and filter options
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.campaigns.list('my-account');
+     * for (const campaign of results) {
+     *   console.log(campaign.name, campaign.status);
+     * }
+     * ```
+     */
+    list(accountId: string, options?: ListCampaignsOptions): Promise<CampaignListResponse>;
+    /**
+     * Get a single campaign by ID
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     *
+     * @example
+     * ```typescript
+     * const campaign = await client.campaigns.get('my-account', '12345');
+     * console.log(campaign.name, campaign.cpc);
+     * ```
+     */
+    get(accountId: string, campaignId: string): Promise<Campaign>;
+    /**
+     * Create a new campaign
+     *
+     * @param accountId - Account ID
+     * @param campaign - Campaign data
+     *
+     * @example
+     * ```typescript
+     * const campaign = await client.campaigns.create('my-account', {
+     *   name: 'My New Campaign',
+     *   branding_text: 'My Brand',
+     *   cpc: 0.50,
+     *   spending_limit: 1000,
+     *   spending_limit_model: 'MONTHLY',
+     *   marketing_objective: 'DRIVE_WEBSITE_TRAFFIC',
+     * });
+     * console.log('Created campaign:', campaign.id);
+     * ```
+     */
+    create(accountId: string, campaign: CreateCampaignRequest): Promise<Campaign>;
+    /**
+     * Update an existing campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param updates - Fields to update
+     *
+     * @example
+     * ```typescript
+     * const campaign = await client.campaigns.update('my-account', '12345', {
+     *   cpc: 0.75,
+     *   daily_cap: 500,
+     * });
+     * ```
+     */
+    update(accountId: string, campaignId: string, updates: UpdateCampaignRequest): Promise<Campaign>;
+    /**
+     * Delete a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     *
+     * @example
+     * ```typescript
+     * await client.campaigns.delete('my-account', '12345');
+     * ```
+     */
+    delete(accountId: string, campaignId: string): Promise<void>;
+    /**
+     * Duplicate a campaign
+     *
+     * Creates a copy of an existing campaign with a new name.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID to duplicate
+     * @param newName - Name for the new campaign
+     *
+     * @example
+     * ```typescript
+     * const newCampaign = await client.campaigns.duplicate(
+     *   'my-account',
+     *   '12345',
+     *   'My Campaign - Copy'
+     * );
+     * ```
+     */
+    duplicate(accountId: string, campaignId: string, newName: string): Promise<Campaign>;
+    /**
+     * Pause a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     *
+     * @example
+     * ```typescript
+     * await client.campaigns.pause('my-account', '12345');
+     * ```
+     */
+    pause(accountId: string, campaignId: string): Promise<Campaign>;
+    /**
+     * Unpause (resume) a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     *
+     * @example
+     * ```typescript
+     * await client.campaigns.unpause('my-account', '12345');
+     * ```
+     */
+    unpause(accountId: string, campaignId: string): Promise<Campaign>;
+    /**
+     * Bulk update multiple campaigns
+     *
+     * @param accountId - Account ID
+     * @param updates - Array of campaign updates
+     *
+     * @example
+     * ```typescript
+     * await client.campaigns.bulkUpdate('my-account', {
+     *   campaigns: [
+     *     { campaign_id: '12345', update: { is_active: false } },
+     *     { campaign_id: '12346', update: { is_active: false } },
+     *   ],
+     * });
+     * ```
+     */
+    bulkUpdate(accountId: string, updates: BulkCampaignUpdateRequest): Promise<CampaignListResponse>;
+    /**
+     * Patch a campaign collection (targeting, bid modifiers, etc.)
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param collection - Collection name (e.g., 'publisher_targeting')
+     * @param patches - Patch operations
+     *
+     * @example
+     * ```typescript
+     * await client.campaigns.patch('my-account', '12345', 'publisher_targeting', [
+     *   { op: 'ADD', path: '/value', value: ['pub-123'] },
+     * ]);
+     * ```
+     */
+    patch(accountId: string, campaignId: string, collection: string, patches: CampaignPatchRequest[]): Promise<Campaign>;
+    /**
+     * Get all campaigns across a network
+     *
+     * @param networkAccountId - Network account ID
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.campaigns.listNetwork('my-network');
+     * ```
+     */
+    listNetwork(networkAccountId: string): Promise<CampaignListResponse>;
+    /**
+     * Estimate campaign reach
+     *
+     * Get estimated impressions, clicks, and reach for a campaign configuration.
+     *
+     * @param accountId - Account ID
+     * @param params - Targeting and budget parameters
+     *
+     * @example
+     * ```typescript
+     * const estimate = await client.campaigns.estimateReach('my-account', {
+     *   country_targeting: ['US'],
+     *   platform_targeting: ['DESK', 'PHON'],
+     *   daily_cap: 100,
+     *   cpc: 0.50,
+     * });
+     * console.log('Estimated clicks:', estimate.estimated_clicks);
+     * ```
+     */
+    estimateReach(accountId: string, params: CampaignReachEstimatorRequest): Promise<CampaignReachEstimatorResponse>;
+}
+
+/**
+ * Campaign Items (Ads) API for Taboola Backstage
+ */
+
+/**
+ * Options for listing campaign items
+ */
+interface ListItemsOptions {
+    /** Page number (1-indexed) */
+    page?: number;
+    /** Number of results per page */
+    pageSize?: number;
+    /** Filter by status */
+    status?: string;
+    /** Filter by approval state */
+    approvalState?: string;
+}
+/**
+ * Campaign Items (Ads) management API
+ */
+declare class ItemsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all items for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param options - Pagination and filter options
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.items.list('my-account', '12345');
+     * for (const item of results) {
+     *   console.log(item.title, item.status);
+     * }
+     * ```
+     */
+    list(accountId: string, campaignId: string, options?: ListItemsOptions): Promise<CampaignItemListResponse>;
+    /**
+     * Get a single item by ID
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Item ID
+     *
+     * @example
+     * ```typescript
+     * const item = await client.items.get('my-account', '12345', '67890');
+     * console.log(item.title, item.url);
+     * ```
+     */
+    get(accountId: string, campaignId: string, itemId: string): Promise<CampaignItem>;
+    /**
+     * Create a new item (ad) in a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param item - Item data
+     *
+     * @example
+     * ```typescript
+     * const item = await client.items.create('my-account', '12345', {
+     *   url: 'https://example.com/landing-page',
+     *   title: 'Check Out Our Amazing Product!',
+     *   thumbnail_url: 'https://example.com/image.jpg',
+     *   description: 'Learn more about our product',
+     *   cta: { cta_type: 'LEARN_MORE' },
+     * });
+     * console.log('Created item:', item.id);
+     * ```
+     */
+    create(accountId: string, campaignId: string, item: CreateItemRequest): Promise<CampaignItem>;
+    /**
+     * Update an existing item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Item ID
+     * @param updates - Fields to update
+     *
+     * @example
+     * ```typescript
+     * const item = await client.items.update('my-account', '12345', '67890', {
+     *   title: 'Updated Title!',
+     *   is_active: true,
+     * });
+     * ```
+     */
+    update(accountId: string, campaignId: string, itemId: string, updates: UpdateItemRequest): Promise<CampaignItem>;
+    /**
+     * Delete an item from a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Item ID
+     *
+     * @example
+     * ```typescript
+     * await client.items.delete('my-account', '12345', '67890');
+     * ```
+     */
+    delete(accountId: string, campaignId: string, itemId: string): Promise<void>;
+    /**
+     * Pause an item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Item ID
+     *
+     * @example
+     * ```typescript
+     * await client.items.pause('my-account', '12345', '67890');
+     * ```
+     */
+    pause(accountId: string, campaignId: string, itemId: string): Promise<CampaignItem>;
+    /**
+     * Unpause (resume) an item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Item ID
+     *
+     * @example
+     * ```typescript
+     * await client.items.unpause('my-account', '12345', '67890');
+     * ```
+     */
+    unpause(accountId: string, campaignId: string, itemId: string): Promise<CampaignItem>;
+    /**
+     * Create multiple items at once (mass create)
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param items - Array of items to create
+     *
+     * @example
+     * ```typescript
+     * const response = await client.items.bulkCreate('my-account', '12345', {
+     *   items: [
+     *     { url: 'https://example.com/page1', title: 'Title 1', thumbnail_url: '...' },
+     *     { url: 'https://example.com/page2', title: 'Title 2', thumbnail_url: '...' },
+     *   ],
+     * });
+     * console.log('Created', response.results.length, 'items');
+     * ```
+     */
+    bulkCreate(accountId: string, campaignId: string, request: BulkCreateItemsRequest): Promise<BulkCreateItemsResponse>;
+    /**
+     * Bulk create items across multiple campaigns
+     *
+     * @param accountId - Account ID
+     * @param items - Array of items with campaign IDs
+     *
+     * @example
+     * ```typescript
+     * await client.items.bulkCreateAcrossCampaigns('my-account', [
+     *   { campaign_id: '12345', url: '...', title: '...' },
+     *   { campaign_id: '12346', url: '...', title: '...' },
+     * ]);
+     * ```
+     */
+    bulkCreateAcrossCampaigns(accountId: string, items: (CreateItemRequest & {
+        campaign_id: string;
+    })[]): Promise<BulkCreateItemsResponse>;
+    /**
+     * Bulk update items across multiple campaigns
+     *
+     * @param accountId - Account ID
+     * @param request - Bulk update request
+     *
+     * @example
+     * ```typescript
+     * await client.items.bulkUpdate('my-account', {
+     *   items: [
+     *     { id: '67890', campaign_id: '12345', update: { is_active: false } },
+     *     { id: '67891', campaign_id: '12346', update: { is_active: false } },
+     *   ],
+     * });
+     * ```
+     */
+    bulkUpdate(accountId: string, request: BulkUpdateItemsRequest): Promise<CampaignItemListResponse>;
+    /**
+     * Bulk delete items across multiple campaigns
+     *
+     * @param accountId - Account ID
+     * @param request - Bulk delete request
+     *
+     * @example
+     * ```typescript
+     * await client.items.bulkDelete('my-account', {
+     *   items: [
+     *     { id: '67890', campaign_id: '12345' },
+     *     { id: '67891', campaign_id: '12346' },
+     *   ],
+     * });
+     * ```
+     */
+    bulkDelete(accountId: string, request: BulkDeleteItemsRequest): Promise<void>;
+    /**
+     * Get children of an RSS item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Parent RSS item ID
+     *
+     * @example
+     * ```typescript
+     * const { results } = await client.items.listRSSChildren('my-account', '12345', '67890');
+     * ```
+     */
+    listRSSChildren(accountId: string, campaignId: string, itemId: string): Promise<RSSChildrenListResponse>;
+    /**
+     * Get a specific RSS child item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Parent RSS item ID
+     * @param childId - Child item ID
+     */
+    getRSSChild(accountId: string, campaignId: string, itemId: string, childId: string): Promise<RSSChildItem>;
+    /**
+     * Update an RSS child item
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param itemId - Parent RSS item ID
+     * @param childId - Child item ID
+     * @param updates - Fields to update
+     */
+    updateRSSChild(accountId: string, campaignId: string, itemId: string, childId: string, updates: UpdateItemRequest): Promise<RSSChildItem>;
+}
+
+/**
+ * Dictionary API
+ *
+ * Reference data and enum values for the Taboola Backstage API.
+ * Provides lists of countries, platforms, operating systems, browsers,
+ * audience segments, and other reference data needed for targeting.
+ */
+
+/**
+ * Dictionary API for reference data
+ */
+declare class DictionaryAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get list of all supported countries
+     */
+    getCountries(): Promise<Country[]>;
+    /**
+     * Get regions/states within a country
+     *
+     * @param countryCode - Country code (e.g., 'US', 'GB')
+     */
+    getRegions(countryCode: string): Promise<Region[]>;
+    /**
+     * Get DMAs (Designated Market Areas) for a country
+     * Note: Only available for US
+     *
+     * @param countryCode - Country code (typically 'US')
+     */
+    getDMAs(countryCode: string): Promise<DMA[]>;
+    /**
+     * Get postal codes for a country
+     *
+     * @param countryCode - Country code (e.g., 'US', 'GB')
+     * @param params - Optional search and pagination parameters
+     */
+    getPostalCodes(countryCode: string, params?: PostalCodeSearchParams): Promise<PostalCode[]>;
+    /**
+     * Get list of supported platforms
+     */
+    getPlatforms(): Promise<Platform[]>;
+    /**
+     * Get list of supported operating systems
+     */
+    getOperatingSystems(): Promise<OperatingSystemInfo[]>;
+    /**
+     * Get list of iOS versions for targeting
+     */
+    getIOSVersions(): Promise<OSVersion[]>;
+    /**
+     * Get list of Android versions for targeting
+     */
+    getAndroidVersions(): Promise<OSVersion[]>;
+    /**
+     * Get list of supported browsers
+     */
+    getBrowsers(): Promise<Browser[]>;
+    /**
+     * Get campaign property enums (statuses, bid strategies, etc.)
+     */
+    getCampaignEnums(): Promise<CampaignEnums>;
+    /**
+     * Get item property enums (statuses, types, etc.)
+     */
+    getItemEnums(): Promise<ItemEnums>;
+    /**
+     * Get days of week for activity scheduling
+     */
+    getDaysOfWeek(): Promise<DayOfWeek[]>;
+    /**
+     * Get possible values for campaign category
+     */
+    getCampaignCategories(): Promise<string[]>;
+    /**
+     * Get possible values for item status
+     */
+    getItemStatuses(): Promise<string[]>;
+    /**
+     * Get possible values for item CTA (call-to-action)
+     */
+    getItemCTAs(): Promise<string[]>;
+    /**
+     * Get minimum CPC values per country/platform
+     */
+    getMinimumCPCs(): Promise<MinimumCPC[]>;
+    /**
+     * Get supported languages for image library search
+     */
+    getImageLibraryLanguages(): Promise<ImageLibraryLanguage[]>;
+    /**
+     * Get image taxonomies for categorizing images
+     *
+     * @param accountId - Account ID
+     */
+    getImageTaxonomies(accountId: string): Promise<ImageTaxonomy[]>;
+    /**
+     * Get marketplace audience segments available for targeting
+     *
+     * @param accountId - Account ID
+     */
+    getMarketplaceAudiences(accountId: string): Promise<MarketplaceAudience[]>;
+    /**
+     * Get marketplace audience segments for a specific country
+     *
+     * @param accountId - Account ID
+     * @param countryCode - Country code (e.g., 'US', 'GB')
+     */
+    getMarketplaceAudiencesByCountry(accountId: string, countryCode: string): Promise<MarketplaceAudience[]>;
+    /**
+     * Get lookalike audiences available for targeting
+     *
+     * @param accountId - Account ID
+     */
+    getLookalikeAudiences(accountId: string): Promise<LookalikeAudience[]>;
+    /**
+     * Get lookalike audiences for a specific country
+     *
+     * @param accountId - Account ID
+     * @param countryCode - Country code (e.g., 'US', 'GB')
+     */
+    getLookalikeAudiencesByCountry(accountId: string, countryCode: string): Promise<LookalikeAudience[]>;
+    /**
+     * Get contextual segments available for targeting
+     *
+     * @param accountId - Account ID
+     */
+    getContextualSegments(accountId: string): Promise<ContextualSegment[]>;
+}
+
+/**
+ * Publishers API
+ *
+ * Manage publisher targeting and blocking for Taboola campaigns.
+ * Allows listing available publishers and managing blocked publishers
+ * at the account level.
+ */
+
+/**
+ * Publishers API for managing publisher targeting
+ */
+declare class PublishersAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all available publishers for an account
+     *
+     * @param accountId - Account ID
+     * @returns List of publishers with blocking status
+     *
+     * @example
+     * ```typescript
+     * const publishers = await client.publishers.list('my-account');
+     * console.log(`Found ${publishers.length} publishers`);
+     * ```
+     */
+    list(accountId: string): Promise<Publisher[]>;
+    /**
+     * Get blocked publishers at the account level
+     *
+     * @param accountId - Account ID
+     * @returns List of blocked publishers
+     *
+     * @example
+     * ```typescript
+     * const blocked = await client.publishers.getBlocked('my-account');
+     * console.log(`${blocked.length} publishers blocked at account level`);
+     * ```
+     */
+    getBlocked(accountId: string): Promise<BlockedPublisher[]>;
+    /**
+     * Update blocked publishers at the account level
+     *
+     * This replaces the current list of blocked publishers with the
+     * provided list. To add to existing blocks, first get the current
+     * list and append.
+     *
+     * @param accountId - Account ID
+     * @param sites - Array of site names to block
+     * @returns Updated list of blocked publishers
+     *
+     * @example
+     * ```typescript
+     * // Block specific publishers
+     * await client.publishers.updateBlocked('my-account', {
+     *   sites: ['site1.com', 'site2.com']
+     * });
+     *
+     * // Add to existing blocks
+     * const current = await client.publishers.getBlocked('my-account');
+     * const currentSites = current.map(p => p.site);
+     * await client.publishers.updateBlocked('my-account', {
+     *   sites: [...currentSites, 'newsite.com']
+     * });
+     * ```
+     */
+    updateBlocked(accountId: string, request: UpdateBlockedPublishersRequest): Promise<BlockedPublisher[]>;
+    /**
+     * Block a single publisher at the account level
+     *
+     * Convenience method that adds a publisher to the existing block list.
+     *
+     * @param accountId - Account ID
+     * @param site - Site name to block
+     * @returns Updated list of blocked publishers
+     */
+    blockPublisher(accountId: string, site: string): Promise<BlockedPublisher[]>;
+    /**
+     * Unblock a single publisher at the account level
+     *
+     * Convenience method that removes a publisher from the block list.
+     *
+     * @param accountId - Account ID
+     * @param site - Site name to unblock
+     * @returns Updated list of blocked publishers
+     */
+    unblockPublisher(accountId: string, site: string): Promise<BlockedPublisher[]>;
+    /**
+     * Clear all blocked publishers at the account level
+     *
+     * @param accountId - Account ID
+     * @returns Empty list
+     */
+    clearBlocked(accountId: string): Promise<BlockedPublisher[]>;
+}
+
+/**
+ * Targeting API
+ *
+ * Manage campaign-level targeting including postal codes,
+ * audience segments (marketplace, custom, lookalike), and
+ * contextual targeting.
+ */
+
+/**
+ * Targeting API for campaign-level targeting configuration
+ */
+declare class TargetingAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get postal code targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns Postal code targeting configuration
+     *
+     * @example
+     * ```typescript
+     * const targeting = await client.targeting.getPostalCodes('my-account', '12345');
+     * console.log(`Targeting type: ${targeting.type}`);
+     * console.log(`Postal codes: ${targeting.values.length}`);
+     * ```
+     */
+    getPostalCodes(accountId: string, campaignId: string): Promise<PostalCodeTargeting>;
+    /**
+     * Update postal code targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - Postal code targeting configuration
+     * @returns Updated targeting configuration
+     *
+     * @example
+     * ```typescript
+     * await client.targeting.updatePostalCodes('my-account', '12345', {
+     *   type: 'INCLUDE',
+     *   values: [
+     *     { postal_code: '10001', country: 'US' },
+     *     { postal_code: '10002', country: 'US' },
+     *   ]
+     * });
+     * ```
+     */
+    updatePostalCodes(accountId: string, campaignId: string, targeting: UpdatePostalCodeTargetingRequest): Promise<PostalCodeTargeting>;
+    /**
+     * Get marketplace audience targeting for a campaign
+     *
+     * Marketplace audiences are third-party audience segments
+     * available for targeting through Taboola's marketplace.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns Audience targeting configuration
+     */
+    getMarketplaceAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
+    /**
+     * Update marketplace audience targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - Audience targeting configuration
+     * @returns Updated targeting configuration
+     *
+     * @example
+     * ```typescript
+     * await client.targeting.updateMarketplaceAudiences('my-account', '12345', {
+     *   type: 'INCLUDE',
+     *   collection: [
+     *     { id: 'segment-1', name: null },
+     *     { id: 'segment-2', name: null },
+     *   ]
+     * });
+     * ```
+     */
+    updateMarketplaceAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
+    /**
+     * Get custom audience targeting for a campaign
+     *
+     * Custom audiences are audiences created from pixel data
+     * or uploaded lists.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns Audience targeting configuration
+     */
+    getCustomAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
+    /**
+     * Update custom audience targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - Audience targeting configuration
+     * @returns Updated targeting configuration
+     */
+    updateCustomAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
+    /**
+     * Get lookalike audience targeting for a campaign
+     *
+     * Lookalike audiences are modeled after your existing
+     * custom audiences to find similar users.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns Audience targeting configuration
+     */
+    getLookalikeAudiences(accountId: string, campaignId: string): Promise<AudienceTargeting>;
+    /**
+     * Update lookalike audience targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - Audience targeting configuration
+     * @returns Updated targeting configuration
+     */
+    updateLookalikeAudiences(accountId: string, campaignId: string, targeting: UpdateAudienceTargetingRequest): Promise<AudienceTargeting>;
+    /**
+     * Get contextual targeting for a campaign
+     *
+     * Contextual targeting allows you to target based on the
+     * content of the pages where your ads appear.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns Contextual targeting configuration
+     */
+    getContextual(accountId: string, campaignId: string): Promise<ContextualTargeting>;
+    /**
+     * Update contextual targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - Contextual targeting configuration
+     * @returns Updated targeting configuration
+     *
+     * @example
+     * ```typescript
+     * await client.targeting.updateContextual('my-account', '12345', {
+     *   type: 'INCLUDE',
+     *   collection: [
+     *     { id: 'context-1', name: null },
+     *     { id: 'context-2', name: null },
+     *   ]
+     * });
+     * ```
+     */
+    updateContextual(accountId: string, campaignId: string, targeting: UpdateContextualTargetingRequest): Promise<ContextualTargeting>;
+    /**
+     * Get first party audience targeting for a campaign
+     *
+     * First party audiences are your own uploaded audience data.
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @returns First party audience targeting configuration
+     */
+    getFirstPartyAudiences(accountId: string, campaignId: string): Promise<FirstPartyAudienceTargeting>;
+    /**
+     * Update first party audience targeting for a campaign
+     *
+     * @param accountId - Account ID
+     * @param campaignId - Campaign ID
+     * @param targeting - First party audience targeting configuration
+     * @returns Updated targeting configuration
+     */
+    updateFirstPartyAudiences(accountId: string, campaignId: string, targeting: UpdateFirstPartyAudienceTargetingRequest): Promise<FirstPartyAudienceTargeting>;
+}
+
+/**
+ * Combined Audiences API
+ *
+ * Manage combined audiences that combine multiple audience types
+ * (custom, lookalike, marketplace, first-party) with AND/OR logic.
+ */
+
+/**
+ * Combined Audiences API for managing combined audiences
+ */
+declare class CombinedAudiencesAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List available audiences for combining
+     *
+     * Returns all audiences that can be used in combined audience rules,
+     * including custom, lookalike, marketplace, and first-party audiences.
+     *
+     * @param accountId - Account ID
+     * @returns List of available audiences
+     *
+     * @example
+     * ```typescript
+     * const available = await client.combinedAudiences.listAvailable('my-account');
+     * console.log(`${available.length} audiences available for combining`);
+     * ```
+     */
+    listAvailable(accountId: string): Promise<AvailableAudience[]>;
+    /**
+     * List all combined audiences
+     *
+     * @param accountId - Account ID
+     * @returns List of combined audiences
+     *
+     * @example
+     * ```typescript
+     * const audiences = await client.combinedAudiences.list('my-account');
+     * for (const audience of audiences) {
+     *   console.log(`${audience.name}: ${audience.status}`);
+     * }
+     * ```
+     */
+    list(accountId: string): Promise<CombinedAudience[]>;
+    /**
+     * Get a single combined audience
+     *
+     * @param accountId - Account ID
+     * @param audienceId - Combined audience ID
+     * @returns Combined audience details
+     */
+    get(accountId: string, audienceId: string): Promise<CombinedAudience>;
+    /**
+     * Create a combined audience
+     *
+     * @param accountId - Account ID
+     * @param audience - Combined audience configuration
+     * @returns Created combined audience
+     *
+     * @example
+     * ```typescript
+     * const audience = await client.combinedAudiences.create('my-account', {
+     *   name: 'High-Value Engaged Users',
+     *   description: 'Users who are both high-value and engaged',
+     *   include_rules: [
+     *     {
+     *       audience_type: 'CUSTOM_AUDIENCE',
+     *       audiences: [{ id: 'custom-1', name: null }]
+     *     },
+     *     {
+     *       audience_type: 'LOOKALIKE_AUDIENCE',
+     *       audiences: [{ id: 'lookalike-1', name: null }]
+     *     }
+     *   ],
+     *   exclude_rules: [
+     *     {
+     *       audience_type: 'CUSTOM_AUDIENCE',
+     *       audiences: [{ id: 'converters', name: null }]
+     *     }
+     *   ]
+     * });
+     * ```
+     */
+    create(accountId: string, audience: CreateCombinedAudienceRequest): Promise<CombinedAudience>;
+    /**
+     * Update a combined audience
+     *
+     * @param accountId - Account ID
+     * @param audienceId - Combined audience ID
+     * @param updates - Fields to update
+     * @returns Updated combined audience
+     */
+    update(accountId: string, audienceId: string, updates: UpdateCombinedAudienceRequest): Promise<CombinedAudience>;
+}
+
+/**
+ * First Party Audiences API
+ *
+ * Manage first party audience onboarding, allowing you to upload
+ * your own customer data (email, phone, device IDs) for targeting.
+ */
+
+/**
+ * First Party Audiences API for audience onboarding
+ */
+declare class FirstPartyAudiencesAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all first party audiences
+     *
+     * @param accountId - Account ID
+     * @returns List of first party audiences
+     *
+     * @example
+     * ```typescript
+     * const audiences = await client.firstPartyAudiences.list('my-account');
+     * for (const audience of audiences) {
+     *   console.log(`${audience.name}: ${audience.status} (${audience.size} users)`);
+     * }
+     * ```
+     */
+    list(accountId: string): Promise<FirstPartyAudience[]>;
+    /**
+     * Get a single first party audience
+     *
+     * @param accountId - Account ID
+     * @param audienceId - Audience ID
+     * @returns First party audience details
+     */
+    get(accountId: string, audienceId: string): Promise<FirstPartyAudience>;
+    /**
+     * Create a first party audience
+     *
+     * After creation, use addUsers() to populate the audience with identifiers.
+     *
+     * @param accountId - Account ID
+     * @param audience - Audience configuration
+     * @returns Created audience
+     *
+     * @example
+     * ```typescript
+     * const audience = await client.firstPartyAudiences.create('my-account', {
+     *   name: 'High-Value Customers',
+     *   description: 'Customers with LTV > $1000',
+     *   source_type: 'CRM',
+     *   ttl_days: 90
+     * });
+     *
+     * // Then add users
+     * await client.firstPartyAudiences.addUsers('my-account', audience.id, {
+     *   add: [
+     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash1' },
+     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash2' },
+     *   ]
+     * });
+     * ```
+     */
+    create(accountId: string, audience: CreateFirstPartyAudienceRequest): Promise<FirstPartyAudience>;
+    /**
+     * Add or remove users from a first party audience
+     *
+     * Users are identified by hashed identifiers (email, phone, device ID).
+     * It's recommended to use SHA256 hashed values for privacy.
+     *
+     * @param accountId - Account ID
+     * @param audienceId - Audience ID
+     * @param request - Add/remove request with user identifiers
+     * @returns Operation result with counts
+     *
+     * @example
+     * ```typescript
+     * // Add users
+     * const result = await client.firstPartyAudiences.addUsers('my-account', 'audience-1', {
+     *   add: [
+     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash1' },
+     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash2' },
+     *   ]
+     * });
+     * console.log(`Added ${result.added_count} users`);
+     *
+     * // Remove users
+     * const result2 = await client.firstPartyAudiences.addUsers('my-account', 'audience-1', {
+     *   remove: [
+     *     { identifier_type: 'EMAIL_SHA256', identifier_value: 'sha256hash3' },
+     *   ]
+     * });
+     * console.log(`Removed ${result2.removed_count} users`);
+     * ```
+     */
+    addUsers(accountId: string, audienceId: string, request: AddRemoveUsersRequest): Promise<AddRemoveUsersResponse>;
+    /**
+     * Remove users from a first party audience
+     *
+     * Convenience method that wraps addUsers with only remove operations.
+     *
+     * @param accountId - Account ID
+     * @param audienceId - Audience ID
+     * @param request - Remove request with user identifiers
+     * @returns Operation result with counts
+     */
+    removeUsers(accountId: string, audienceId: string, request: Pick<AddRemoveUsersRequest, 'remove'>): Promise<AddRemoveUsersResponse>;
+}
+
+/**
+ * Pixel API
+ *
+ * Manage Taboola Universal Pixel conversion rules and custom audience rules.
+ * Conversion rules track conversions on your site, while custom audience
+ * rules build retargeting audiences based on pixel events.
+ */
+
+/**
+ * Pixel API for managing conversion and custom audience rules
+ */
+declare class PixelAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * List all conversion rules
+     *
+     * @param accountId - Account ID
+     * @returns List of conversion rules
+     *
+     * @example
+     * ```typescript
+     * const rules = await client.pixel.listConversionRules('my-account');
+     * for (const rule of rules) {
+     *   console.log(`${rule.display_name}: ${rule.status}`);
+     * }
+     * ```
+     */
+    listConversionRules(accountId: string): Promise<ConversionRule[]>;
+    /**
+     * Get a single conversion rule
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Conversion rule ID
+     * @returns Conversion rule details
+     */
+    getConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    /**
+     * List conversion rules with performance data
+     *
+     * Returns conversion rules with additional data like 30-day conversion
+     * counts and values.
+     *
+     * @param accountId - Account ID
+     * @returns List of conversion rules with data
+     */
+    listConversionRulesWithData(accountId: string): Promise<ConversionRuleWithData[]>;
+    /**
+     * Create a conversion rule
+     *
+     * @param accountId - Account ID
+     * @param rule - Conversion rule configuration
+     * @returns Created conversion rule
+     *
+     * @example
+     * ```typescript
+     * // URL-based conversion rule
+     * const rule = await client.pixel.createConversionRule('my-account', {
+     *   display_name: 'Purchase Completed',
+     *   type: 'URL_BASED',
+     *   category: 'PURCHASE',
+     *   conditions: [
+     *     {
+     *       type: 'URL',
+     *       operator: 'CONTAINS',
+     *       value: '/thank-you'
+     *     }
+     *   ],
+     *   effect: {
+     *     type: 'DYNAMIC_VALUE',
+     *     value: null,
+     *     currency: 'USD',
+     *     value_parameter: 'order_total'
+     *   },
+     *   conversion_window_days: 30,
+     *   view_through_window_days: 1
+     * });
+     *
+     * // Event-based conversion rule
+     * const eventRule = await client.pixel.createConversionRule('my-account', {
+     *   display_name: 'Add to Cart',
+     *   type: 'EVENT_BASED',
+     *   category: 'ADD_TO_CART',
+     *   event_name: 'add_to_cart',
+     *   conditions: [],
+     *   effect: {
+     *     type: 'FIXED_VALUE',
+     *     value: 10,
+     *     currency: 'USD',
+     *     value_parameter: null
+     *   }
+     * });
+     * ```
+     */
+    createConversionRule(accountId: string, rule: CreateConversionRuleRequest): Promise<ConversionRule>;
+    /**
+     * Update a conversion rule
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Conversion rule ID
+     * @param updates - Fields to update
+     * @returns Updated conversion rule
+     */
+    updateConversionRule(accountId: string, ruleId: string, updates: UpdateConversionRuleRequest): Promise<ConversionRule>;
+    /**
+     * Archive a conversion rule
+     *
+     * Archived rules stop tracking conversions but remain in the account
+     * for historical reporting.
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Conversion rule ID
+     * @returns Archived conversion rule
+     */
+    archiveConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    /**
+     * Unarchive a conversion rule
+     *
+     * Reactivates an archived conversion rule.
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Conversion rule ID
+     * @returns Reactivated conversion rule
+     */
+    unarchiveConversionRule(accountId: string, ruleId: string): Promise<ConversionRule>;
+    /**
+     * List all custom audience rules
+     *
+     * Custom audience rules build retargeting audiences based on pixel
+     * events and page visits.
+     *
+     * @param accountId - Account ID
+     * @returns List of custom audience rules
+     *
+     * @example
+     * ```typescript
+     * const rules = await client.pixel.listCustomAudienceRules('my-account');
+     * for (const rule of rules) {
+     *   console.log(`${rule.display_name}: ${rule.size} users`);
+     * }
+     * ```
+     */
+    listCustomAudienceRules(accountId: string): Promise<CustomAudienceRule[]>;
+    /**
+     * Get a single custom audience rule
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Custom audience rule ID
+     * @returns Custom audience rule details
+     */
+    getCustomAudienceRule(accountId: string, ruleId: string): Promise<CustomAudienceRule>;
+    /**
+     * Create a custom audience rule
+     *
+     * @param accountId - Account ID
+     * @param rule - Custom audience rule configuration
+     * @returns Created custom audience rule
+     *
+     * @example
+     * ```typescript
+     * // All visitors audience
+     * const allVisitors = await client.pixel.createCustomAudienceRule('my-account', {
+     *   display_name: 'All Visitors - 30 Days',
+     *   conditions: [],
+     *   ttl_days: 30
+     * });
+     *
+     * // Product page visitors
+     * const productViewers = await client.pixel.createCustomAudienceRule('my-account', {
+     *   display_name: 'Product Page Viewers',
+     *   conditions: [
+     *     {
+     *       type: 'URL',
+     *       operator: 'CONTAINS',
+     *       value: '/products/'
+     *     }
+     *   ],
+     *   ttl_days: 14
+     * });
+     *
+     * // Cart abandoners
+     * const cartAbandoners = await client.pixel.createCustomAudienceRule('my-account', {
+     *   display_name: 'Cart Abandoners',
+     *   conditions: [
+     *     {
+     *       type: 'EVENT_NAME',
+     *       operator: 'EQUALS',
+     *       value: 'add_to_cart'
+     *     }
+     *   ],
+     *   ttl_days: 7
+     * });
+     * ```
+     */
+    createCustomAudienceRule(accountId: string, rule: CreateCustomAudienceRuleRequest): Promise<CustomAudienceRule>;
+    /**
+     * Update a custom audience rule
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Custom audience rule ID
+     * @param updates - Fields to update
+     * @returns Updated custom audience rule
+     */
+    updateCustomAudienceRule(accountId: string, ruleId: string, updates: UpdateCustomAudienceRuleRequest): Promise<CustomAudienceRule>;
+    /**
+     * Pause a custom audience rule
+     *
+     * Paused rules stop adding new users but retain existing audience members.
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Custom audience rule ID
+     * @returns Paused custom audience rule
+     */
+    pauseCustomAudienceRule(accountId: string, ruleId: string): Promise<CustomAudienceRule>;
+    /**
+     * Resume a paused custom audience rule
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Custom audience rule ID
+     * @returns Resumed custom audience rule
+     */
+    resumeCustomAudienceRule(accountId: string, ruleId: string): Promise<CustomAudienceRule>;
+    /**
+     * Archive a custom audience rule
+     *
+     * Archived rules stop building and the audience becomes inaccessible
+     * for targeting.
+     *
+     * @param accountId - Account ID
+     * @param ruleId - Custom audience rule ID
+     * @returns Archived custom audience rule
+     */
+    archiveCustomAudienceRule(accountId: string, ruleId: string): Promise<CustomAudienceRule>;
+}
+
+/**
+ * Reports API
+ *
+ * Access Taboola Backstage reporting data including Campaign Summary,
+ * Top Campaign Content, and Realtime reports.
+ */
+
+/**
+ * Reports API for accessing reporting data
+ */
+declare class ReportsAPI {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Get Campaign Summary Report
+     *
+     * The Campaign Summary report provides aggregated performance metrics
+     * across various dimensions like day, week, month, campaign, site, etc.
+     *
+     * @param accountId - Account ID
+     * @param dimension - Report dimension (day, week, month, campaign, site, etc.)
+     * @param params - Report parameters including date range and filters
+     * @returns Campaign summary report with metrics
+     *
+     * @example
+     * ```typescript
+     * // Daily report for last 30 days
+     * const report = await client.reports.campaignSummary('my-account', 'day', {
+     *   start_date: '2024-01-01',
+     *   end_date: '2024-01-31',
+     * });
+     *
+     * for (const row of report.results) {
+     *   console.log(`${row.date}: ${row.clicks} clicks, $${row.spent} spent`);
+     * }
+     *
+     * // Campaign-level report with conversion data
+     * const campaignReport = await client.reports.campaignSummary('my-account', 'campaign', {
+     *   start_date: '2024-01-01',
+     *   end_date: '2024-01-31',
+     *   include_conversions: 'all',
+     * });
+     *
+     * // Filtered by specific campaign
+     * const filteredReport = await client.reports.campaignSummary('my-account', 'day', {
+     *   start_date: '2024-01-01',
+     *   end_date: '2024-01-31',
+     *   campaign: '12345',
+     * });
+     * ```
+     */
+    campaignSummary(accountId: string, dimension: ReportDimension, params: CampaignSummaryReportParams): Promise<CampaignSummaryReport>;
+    /**
+     * Get Top Campaign Content Report
+     *
+     * The Top Campaign Content report shows performance metrics for individual
+     * items (ads) across campaigns.
+     *
+     * @param accountId - Account ID
+     * @param params - Report parameters including date range and filters
+     * @returns Top campaign content report with item metrics
+     *
+     * @example
+     * ```typescript
+     * const report = await client.reports.topCampaignContent('my-account', {
+     *   start_date: '2024-01-01',
+     *   end_date: '2024-01-31',
+     *   limit: 100,
+     * });
+     *
+     * for (const item of report.results) {
+     *   console.log(`${item.item_name}: ${item.clicks} clicks, CTR: ${item.ctr}%`);
+     * }
+     * ```
+     */
+    topCampaignContent(accountId: string, params: TopCampaignContentReportParams): Promise<TopCampaignContentReport>;
+    /**
+     * Get Realtime Campaign Report
+     *
+     * The Realtime Campaign report shows current day performance metrics
+     * for campaigns, updated frequently throughout the day.
+     *
+     * @param accountId - Account ID
+     * @param params - Optional filter parameters
+     * @returns Realtime campaign report
+     *
+     * @example
+     * ```typescript
+     * const report = await client.reports.realtimeCampaign('my-account');
+     * console.log(`Data as of: ${report.timestamp}`);
+     *
+     * for (const campaign of report.results) {
+     *   console.log(`${campaign.campaign_name}: ${campaign.clicks} clicks today`);
+     * }
+     * ```
+     */
+    realtimeCampaign(accountId: string, params?: RealtimeReportParams): Promise<RealtimeCampaignReport>;
+    /**
+     * Get Realtime Ads Report
+     *
+     * The Realtime Ads report shows current day performance metrics
+     * for individual items (ads), updated frequently throughout the day.
+     *
+     * @param accountId - Account ID
+     * @param params - Optional filter parameters
+     * @returns Realtime ads report
+     *
+     * @example
+     * ```typescript
+     * const report = await client.reports.realtimeAds('my-account');
+     * console.log(`Data as of: ${report.timestamp}`);
+     *
+     * for (const ad of report.results) {
+     *   console.log(`${ad.item_name}: ${ad.clicks} clicks, ${ad.impressions} impressions`);
+     * }
+     * ```
+     */
+    realtimeAds(accountId: string, params?: RealtimeReportParams): Promise<RealtimeAdsReport>;
+}
+
+/**
+ * Taboola Backstage SDK Client
+ *
+ * Main entry point for the SDK. Creates and configures all API modules.
+ */
+
+/**
+ * Taboola Backstage API Client
+ *
+ * The main client for interacting with the Taboola Backstage API.
+ * Provides access to all API modules through namespaced properties.
+ *
+ * @example
+ * ```typescript
+ * import { TaboolaClient } from 'taboola-backstage-sdk';
+ *
+ * const client = new TaboolaClient({
+ *   clientId: 'your-client-id',
+ *   clientSecret: 'your-client-secret',
+ * });
+ *
+ * // Get current account
+ * const account = await client.accounts.getCurrent();
+ * console.log('Account ID:', account.account_id);
+ *
+ * // List campaigns
+ * const { results: campaigns } = await client.campaigns.list(account.account_id);
+ * console.log('Found', campaigns.length, 'campaigns');
+ *
+ * // Create a new campaign
+ * const campaign = await client.campaigns.create(account.account_id, {
+ *   name: 'My Campaign',
+ *   branding_text: 'My Brand',
+ *   cpc: 0.50,
+ *   spending_limit: 1000,
+ *   spending_limit_model: 'MONTHLY',
+ *   marketing_objective: 'DRIVE_WEBSITE_TRAFFIC',
+ * });
+ * ```
+ */
+declare class TaboolaClient {
+    /**
+     * Account management API
+     */
+    readonly accounts: AccountsAPI;
+    /**
+     * Campaign management API
+     */
+    readonly campaigns: CampaignsAPI;
+    /**
+     * Campaign items (ads) management API
+     */
+    readonly items: ItemsAPI;
+    /**
+     * Dictionary/reference data API
+     */
+    readonly dictionary: DictionaryAPI;
+    /**
+     * Publishers management API
+     */
+    readonly publishers: PublishersAPI;
+    /**
+     * Campaign targeting API
+     */
+    readonly targeting: TargetingAPI;
+    /**
+     * Combined audiences API
+     */
+    readonly combinedAudiences: CombinedAudiencesAPI;
+    /**
+     * First party audiences API
+     */
+    readonly firstPartyAudiences: FirstPartyAudiencesAPI;
+    /**
+     * Pixel conversion and custom audience rules API
+     */
+    readonly pixel: PixelAPI;
+    /**
+     * Reports and analytics API
+     */
+    readonly reports: ReportsAPI;
+    /**
+     * Internal OAuth manager (for advanced use cases)
+     */
+    private readonly authManager;
+    /**
+     * Internal HTTP client (for advanced use cases)
+     */
+    private readonly httpClient;
+    /**
+     * Create a new Taboola client
+     *
+     * @param config - Client configuration
+     */
+    constructor(config: TaboolaConfig);
+    /**
+     * Get the base URL used for API requests
+     */
+    get baseUrl(): string;
+    /**
+     * Force refresh the access token
+     *
+     * Useful if you need to ensure a fresh token before a series of operations.
+     */
+    refreshToken(): Promise<void>;
+    /**
+     * Clear the cached access token
+     *
+     * Forces a new token to be fetched on the next request.
+     */
+    clearToken(): void;
+}
+/**
+ * Create a new Taboola client
+ *
+ * Convenience function for creating a new client instance.
+ *
+ * @param config - Client configuration
+ *
+ * @example
+ * ```typescript
+ * import { createClient } from 'taboola-backstage-sdk';
+ *
+ * const client = createClient({
+ *   clientId: process.env.TABOOLA_CLIENT_ID!,
+ *   clientSecret: process.env.TABOOLA_CLIENT_SECRET!,
+ * });
+ * ```
+ */
+declare function createClient(config: TaboolaConfig): TaboolaClient;
+
+/**
+ * Custom error classes for Taboola Backstage SDK
+ */
+/**
+ * Base error class for all Taboola SDK errors
+ */
+declare class TaboolaError extends Error {
+    /** HTTP status code if applicable */
+    readonly statusCode: number | undefined;
+    /** Original error response body */
+    readonly response: unknown;
+    /** Request URL that caused the error */
+    readonly url: string | undefined;
+    constructor(message: string, options?: {
+        statusCode?: number;
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Authentication error (401)
+ * Thrown when OAuth token is invalid or expired
+ */
+declare class TaboolaAuthError extends TaboolaError {
+    constructor(message?: string, options?: {
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Validation error (400)
+ * Thrown when request parameters are invalid
+ */
+declare class TaboolaValidationError extends TaboolaError {
+    /** Specific field errors if available */
+    readonly fieldErrors: Record<string, string[]> | undefined;
+    constructor(message?: string, options?: {
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+        fieldErrors?: Record<string, string[]>;
+    });
+}
+/**
+ * Not found error (404)
+ * Thrown when requested resource doesn't exist
+ */
+declare class TaboolaNotFoundError extends TaboolaError {
+    /** The resource type that wasn't found */
+    readonly resourceType: string | undefined;
+    /** The resource ID that wasn't found */
+    readonly resourceId: string | undefined;
+    constructor(message?: string, options?: {
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+        resourceType?: string;
+        resourceId?: string;
+    });
+}
+/**
+ * Rate limit error (429)
+ * Thrown when API rate limits are exceeded
+ */
+declare class TaboolaRateLimitError extends TaboolaError {
+    /** Seconds until rate limit resets */
+    readonly retryAfter: number | undefined;
+    constructor(message?: string, options?: {
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+        retryAfter?: number;
+    });
+}
+/**
+ * Forbidden error (403)
+ * Thrown when access to resource is denied
+ */
+declare class TaboolaForbiddenError extends TaboolaError {
+    constructor(message?: string, options?: {
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Server error (5xx)
+ * Thrown when Taboola servers encounter an error
+ */
+declare class TaboolaServerError extends TaboolaError {
+    constructor(message?: string, options?: {
+        statusCode?: number;
+        response?: unknown;
+        url?: string;
+        cause?: Error;
+    });
+}
+/**
+ * Parse API error response and throw appropriate error class
+ */
+declare function parseApiError(statusCode: number, response: unknown, url: string): TaboolaError;
+
+export { type Account, type AccountType, AccountsAPI, type ActivitySchedule, type ActivityScheduleRule, type AddRemoveUsersRequest, type AddRemoveUsersResponse, type AdvertiserAccount, type AllowedAccountsResponse, type ApprovalState, type AudienceSegment, type AudienceTargeting, type AvailableAudience, type AvailableAudiencesResponse, type BidStrategy, type BlockedPublisher, type BlockedPublishersResponse, type BrandSafetyProvider, type Browser, type BulkCampaignUpdate, type BulkCampaignUpdateRequest, type BulkCreateItemsRequest, type BulkCreateItemsResponse, type BulkDeleteItemsRequest, type BulkUpdateItemsRequest, type CTA, type CTAType, type Campaign, type CampaignEnums, type CampaignItem, type CampaignItemListResponse, type CampaignListResponse, type CampaignPatchRequest, type CampaignReachEstimatorRequest, type CampaignReachEstimatorResponse, type CampaignStatus, type CampaignSummaryReport, type CampaignSummaryReportParams, type CampaignSummaryRow, type CampaignType, CampaignsAPI, type CombinedAudience, type CombinedAudienceListResponse, type CombinedAudienceRule, CombinedAudiencesAPI, type Condition, type ConditionOperator, type ConditionType, type ConnectionType, type ContextualSegment, type ContextualSegmentValue, type ContextualTargeting, type ConversionRule, type ConversionRuleListResponse, type ConversionRuleStatus, type ConversionRuleType, type ConversionRuleWithData, type ConversionRuleWithDataListResponse, type Coordinates, type Country, type CreateCampaignRequest, type CreateCombinedAudienceRequest, type CreateConversionRuleRequest, type CreateCustomAudienceRuleRequest, type CreateFirstPartyAudienceRequest, type CreateItemRequest, type CreativeFocus, type CreativeFocusType, type CurrencyCode, type CustomAudienceRule, type CustomAudienceRuleListResponse, type CustomAudienceRuleStatus, DEFAULT_BASE_URL, type DMA, type DailyAdDeliveryModel, type DateString, type DayOfWeek, DictionaryAPI, type Effect, type EffectType, type ExternalBrandSafety, type FirstPartyAudience, type FirstPartyAudienceTargeting, type FirstPartyAudienceUser, FirstPartyAudiencesAPI, HttpClient, type HttpClientOptions, type ImageLibraryItem, type ImageLibrarySearchParams, type ImageLibrarySearchResponse, type ImageUploadResponse, type ItemEnums, type ItemPolicyReview, type ItemStatus, type ItemType, type ItemVerificationPixel, type ItemViewabilityTag, ItemsAPI, type ListCampaignsOptions, type ListItemsOptions, type ListResponse, type LookalikeAudience, type MarketingObjective, type MarketplaceAudience, type MinimumCPC, type MultiTargeting, type MultiTargetingState, type NetworkAdvertisersResponse, OAuthManager, type OSVersion, type OperatingSystem, type OperatingSystemInfo, type PaginationParams, type PartnerType, type PatchOperation, PixelAPI, type Platform, type PlatformType, type PolicyReview, type PostalCode, type PostalCodeTargeting, type PostalCodeValue, type PricingModel, type Publisher, type PublisherBidModifier, type PublisherBidModifierCollection, type PublisherBidStrategyModifier, type PublisherBidStrategyModifierCollection, type PublisherListResponse, PublishersAPI, type RSSChildItem, type RSSChildrenListResponse, type RealtimeAdsReport, type RealtimeAdsRow, type RealtimeCampaignReport, type RealtimeCampaignRow, type RealtimeReportParams, type Region, type ReportDimension, type ReportMetadata, ReportsAPI, type SpendingLimitModel, type StoredToken, TaboolaAuthError, TaboolaClient, type TaboolaConfig, TaboolaError, TaboolaForbiddenError, TaboolaNotFoundError, TaboolaRateLimitError, TaboolaServerError, TaboolaValidationError, TargetingAPI, type TargetingType, type TargetingValue, type TokenResponse, type TopCampaignContentReport, type TopCampaignContentReportParams, type TopCampaignContentRow, type TrafficAllocationMode, type UpdateAudienceTargetingRequest, type UpdateBlockedPublishersRequest, type UpdateCampaignRequest, type UpdateCombinedAudienceRequest, type UpdateContextualTargetingRequest, type UpdateConversionRuleRequest, type UpdateCustomAudienceRuleRequest, type UpdateFirstPartyAudienceTargetingRequest, type UpdateItemRequest, type UpdatePostalCodeTargetingRequest, type VerificationPixel, type ViewabilityTag, createClient, parseApiError };