UGC Ad research: sort UGC Videos and Ads by format and hook

TikTok, via REST API

POST /v1/research with intent "Beauty UGC ad-style creator videos for makeup brands", platforms tiktok, max_videos 50

{
  "intent": "Beauty UGC ad-style creator videos for makeup brands",
  "coverage": { "tiktok": "complete" },
  "lift_tables": {
    "set": { "video_count": 46, "median_views": 179061 },
    "visual_format": [
      { "value": "TUTORIAL", "views_lift": 1.36, "video_count": 19, "low_confidence": false },
      { "value": "TALKING_HEAD", "views_lift": 1.18, "video_count": 7, "low_confidence": false },
      { "value": "UNBOXING", "views_lift": 0.96, "video_count": 11, "low_confidence": false },
      { "value": "PRODUCT_DEMO", "views_lift": 0.11, "video_count": 6, "low_confidence": false },
      ...
    ],
    "hook_type": [
      { "value": "DIRECT_ADDRESS", "views_lift": 2.64, "video_count": 4, "low_confidence": false },
      { "value": "QUESTION", "views_lift": 2.59, "video_count": 2, "low_confidence": true },
      { "value": "CURIOSITY_GAP", "views_lift": 2, "video_count": 9, "low_confidence": false },
      { "value": "PROBLEM", "views_lift": 0.92, "video_count": 4, "low_confidence": false },
      { "value": "DEMONSTRATION", "views_lift": 0.69, "video_count": 23, "low_confidence": false },
      ...
    ],
    "length": [
      { "value": "180s+", "views_lift": 2.37, "video_count": 13, "low_confidence": false },
      { "value": "60-180s", "views_lift": 1.63, "video_count": 15, "low_confidence": false },
      { "value": "30-60s", "views_lift": 0.84, "video_count": 8, "low_confidence": false },
      { "value": "15-30s", "views_lift": 0.28, "video_count": 8, "low_confidence": false },
      ...
    ]
  },
  "digest": {
    "hooks": [
      {
        "text": "This is... This is ridiculous. Full face of new makeup launches.",
        "template": "This is... This is ridiculous. Full face of new [product].",
        "hook_type": "CURIOSITY_GAP",
        "why_it_works": "The creator's disbelief builds anticipation for the sheer volume or quality of the products being tested."
      },
      {
        "text": "Deinfluencing K-beauty makeup products.",
        "template": "Deinfluencing [product] makeup products.",
        "hook_type": "PROBLEM",
        "why_it_works": "It uses a trendy buzzword to promise honest, negative reviews, which builds immediate trust."
      },
      ...
    ],
    "gaps": [
      {
        "ask": "Viewers want mystery boxes to offer shade selections based on skin tone so they don't receive unusable products.",
        "angle": "A review of a mystery box that evaluates whether the included shades are universally flattering or a waste of money for certain skin tones."
      },
      ...
    ]
  }
}

Meta Ad Library, via REST API

GET /v1/ads/meta/1198358815416386?analyze=true (a fitness app Ad from a US Meta Ad search for fitness apps)

{
  "ad": {
    "advertiser": { "name": "Train Fitness" },
    "media_type": "video",
    "first_shown": "2025-05-13T07:00:00.000Z",
    "last_shown": "2026-07-10T07:00:00.000Z",
    "days_running": 423,
    "creative": {
      "body": "I was so skeptical but it actually detects keeps track of my exercises accurately!",
      "cta": "Install now"
    },
    "intelligence": {
      "hook": {
        "type": "CURIOSITY_GAP",
        "opening_line": "Cool gym hack. If you have an Apple Watch, you need this app.",
        "visual_hook": "man working out in the gym doing lat pulldowns"
      },
      "visual": {
        "format": "PRODUCT_DEMO",
        "face_visibility": "HANDS_ONLY",
        "on_screen_text": [
          "If you have an apple watch you need this app",
          "It automatically detects what exercise you're doing and counts how many reps you've completed",
          ...
          "It's free to download Go give it a try!"
        ]
      },
      "tone": { "speaking_style": "CONVERSATIONAL", "primary_emotion": "Joy" },
      "persuasion": {
        "sponsored": false,
        "call_to_action": { "type": "VISIT_SITE" }
      }
    }
  }
}

Meta Ad Library, via REST API

GET /v1/ads/meta/4309638865973296?analyze=true (a grocery delivery Ad from a US Meta Ad search for meal kits)

{
  "ad": {
    "advertiser": { "name": "Hungryroot" },
    "media_type": "video",
    "first_shown": "2026-04-28T07:00:00.000Z",
    "last_shown": null,
    "is_active": true,
    "days_running": 187,
    "variant_count": 12,
    "creative": {
      "body": "This is what happens when I decide I’m done thinking about groceries. Meals, snacks, breakfast, lunch ...",
      "cta": "See details"
    },
    "intelligence": {
      "hook": {
        "type": "CURIOSITY_GAP",
        "opening_line": "POV: This is what happens when you say yes to outsourcing",
        "visual_hook": "man aggressively dropping grocery packages on a counter"
      },
      "visual": {
        "format": "UNBOXING",
        "face_visibility": "CREATOR_ON_CAMERA",
        "on_screen_text": [
          "POV: This is what happens when you say yes to outsourcing",
          "This is only half of it. wait until you see what this actually costs",
          ...
        ]
      },
      "tone": { "speaking_style": "CONVERSATIONAL", "primary_emotion": "Joy" },
      "persuasion": {
        "sponsored": true,
        "sponsorship_signals": ["#HungryrootPartner in caption", "#ad in caption", ...],
        "call_to_action": { "type": "VISIT_SITE" }
      }
    }
  }
}