tiktok_adLibrary_ads_search_get

Parameters schema

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "likes": {
      "enum": [
        "top-1-20",
        "top-21-40",
        "top-41-60",
        "top-61-80",
        "top-81-100"
      ],
      "type": "string",
      "description": "Likes percentile filter for Top Ads."
    },
    "query": {
      "type": "string",
      "maxLength": 4096,
      "description": "Optional keyword to search ad titles and content."
    },
    "cursor": {
      "type": "string",
      "minLength": 1,
      "description": "Opaque pagination cursor from a previous response."
    },
    "period": {
      "enum": [
        "7",
        "30",
        "180"
      ],
      "type": "string",
      "description": "Time window in days for Top Ads."
    },
    "region": {
      "enum": [
        "DZ",
        "AR",
        "AU",
        "AT",
        "AZ",
        "BH",
        "BD",
        "BY",
        "BE",
        "BO",
        "BR",
        "BG",
        "KH",
        "CA",
        "CL",
        "CO",
        "CR",
        "HR",
        "CY",
        "CZ",
        "DK",
        "DO",
        "EC",
        "EG",
        "EE",
        "FI",
        "FR",
        "DE",
        "GR",
        "GT",
        "JO",
        "HU",
        "ID",
        "IQ",
        "IE",
        "IL",
        "IT",
        "JP",
        "KZ",
        "KE",
        "KW",
        "LV",
        "LB",
        "MY",
        "MX",
        "MA",
        "NL",
        "NZ",
        "NG",
        "NO",
        "OM",
        "PK",
        "PA",
        "PY",
        "PE",
        "PH",
        "PL",
        "PT",
        "PR",
        "QA",
        "LT",
        "RO",
        "SA",
        "RS",
        "SG",
        "SK",
        "SI",
        "ZA",
        "KR",
        "ES",
        "LK",
        "SE",
        "CH",
        "TW",
        "TH",
        "TR",
        "AE",
        "GB",
        "US",
        "UY",
        "VN"
      ],
      "type": "string",
      "description": "Country code for Top Ads results. Defaults to US when omitted."
    },
    "orderBy": {
      "enum": [
        "for-you",
        "impression",
        "play-2s-rate",
        "play-6s-rate",
        "cvr",
        "ctr",
        "like"
      ],
      "type": "string",
      "description": "Sort metric for Top Ads. Defaults to for-you when omitted."
    },
    "adFormat": {
      "enum": [
        "spark-ads",
        "non-spark-ads"
      ],
      "type": "string",
      "description": "Ad format filter for Top Ads."
    },
    "duration": {
      "enum": [
        "under-10s",
        "10-20s",
        "20-30s",
        "30-40s",
        "40-50s",
        "over-50s"
      ],
      "type": "string",
      "description": "Video duration filter for Top Ads."
    },
    "industry": {
      "enum": [
        "apparel-accessories",
        "appliances",
        "apps",
        "baby-kids-maternity",
        "beauty-personal-care",
        "business-services",
        "ecommerce-non-app",
        "education",
        "financial-services",
        "food-beverage",
        "games",
        "health",
        "home-improvement",
        "household-products",
        "life-services",
        "news-entertainment",
        "pets",
        "sports-outdoor",
        "tech-electronics",
        "travel",
        "vehicle-transportation"
      ],
      "type": "string",
      "description": "Industry filter for Top Ads."
    },
    "objective": {
      "enum": [
        "app-installs",
        "conversions",
        "lead-generation",
        "product-sales",
        "reach",
        "traffic",
        "video-views"
      ],
      "type": "string",
      "description": "Campaign objective filter for Top Ads."
    },
    "adLanguage": {
      "enum": [
        "en",
        "es",
        "ar",
        "vi",
        "th",
        "de",
        "id",
        "pt",
        "fr",
        "ms",
        "nl",
        "ja",
        "it",
        "ro",
        "zh-Hant",
        "ko"
      ],
      "type": "string",
      "description": "Ad language filter for Top Ads."
    },
    "advertiserName": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "Search the public TikTok Ads Library by advertiser name. When set, results come from the public Ads Library instead of Top Ads."
    }
  }
}

No endpoints wrapped at confidence ≥ 0.70.

Parent server