Short-Form Video Product/Mention Finder

The Creator Product Mention Miner is an Apify Actor that turns unstructured creator videos into structured brand and product intelligence. Feed it public Instagram Reels, TikTok videos, or YouTube content and receive a flat dataset of every product mentioned — with brand, sentiment, sponsorship signals, promo codes, and timestamps — ready for analytics, monitoring, and attribution pipelines.

---

Key Features

• Multi-platform: Works with Instagram Reels, TikTok, and YouTube (Shorts and standard watch URLs).
• Audio + visual analysis: Detects products mentioned in speech, on-screen overlays, packaging, and link stickers.
• Flat mention rows: One dataset row per product mention for easy filtering and aggregation.
• Creator metadata: Captures creator handle and display name when available.
• Sponsorship detection: Flags disclosed ads, gifts, and affiliate relationships per product.
• Promo capture: Extracts discount codes and price/deal text as stated in the video.
• Sentiment per mention: Positive, neutral, negative, or mixed tone toward each product.
• No login required: Processes any public video URL supported by the platform.

---

Why Mine Product Mentions from Creator Videos?

Brands spend billions on creator marketing, but most product mentions live only inside video — never indexed as structured data. Creators announce launches, reviews, and promo codes in Reels and TikToks faster than any spreadsheet can track. This Actor makes that content machine-readable for:

• Brand monitoring and share-of-voice tracking who mentions your products and competitors.
• Creator marketing attribution connecting unpaid UGC and paid partnerships to specific products.
• Affiliate and promo intelligence harvesting discount codes and offer language at scale.
• Competitive intelligence comparing how rivals are positioned in creator content.
• Market research studying category trends, sentiment, and pricing mentions in UGC.

---

Who Is It For?

• Brand and growth teams monitoring creator and influencer mentions across platforms.
• Affiliate and partnership managers tracking codes, offers, and sponsorship disclosures.
• Data and analytics teams building structured creator-economy datasets.
• Agencies reporting on campaign delivery and competitor activity for clients.

---

Input Schema

{
  "videoUrls": [
    "https://www.instagram.com/reel/DY8NM9WJfM8/",
    "https://www.tiktok.com/@scout2015/video/6718339390844675174",
    "https://www.youtube.com/shorts/VIDEO_ID"
  ],
  "maxItems": 10
}

videoUrls is required. All other fields are optional.

Field	Type	Default	Description
videoUrls	Array of strings	—	Public Instagram Reel, TikTok, or YouTube video URLs
maxItems	Integer	10	Maximum number of videos to process in a single run

Supported URL formats

Platform	Examples
Instagram	instagram.com/reel/..., instagram.com/p/..., instagr.am/...
TikTok	tiktok.com/@user/video/..., vm.tiktok.com/..., vt.tiktok.com/...
YouTube	youtube.com/shorts/..., youtube.com/watch?v=..., youtu.be/...

---

Output Schema

Each dataset row represents one product mention from a video:

{
  "videoUrl": "https://www.instagram.com/reel/DY8NM9WJfM8/",
  "platform": "instagram",
  "videoId": "DY8NM9WJfM8",
  "creatorHandle": "@creator",
  "creatorName": "Creator Name",
  "brand": "Nike",
  "productName": "Air Max 90",
  "category": "fashion",
  "mentionType": "both",
  "sentiment": "positive",
  "timestamp": "00:12",
  "context": "These are my daily runners — super comfortable",
  "discountCode": "CREATOR15",
  "priceText": "$129",
  "isSponsored": true,
  "confidence": "high",
  "scrapedAt": "2026-06-01T10:00:00.000Z"
}

Field	Description
videoUrl	Canonical URL of the source video
platform	instagram, tiktok, or youtube
videoId	Platform-specific video identifier
creatorHandle	Creator @handle when available — null otherwise
creatorName	Creator display name — null otherwise
brand	Brand or company name — null if unknown
productName	Specific product or offering mentioned
category	Coarse category (beauty, tech, food, etc.) — null if unclear
mentionType	spoken, on_screen, or both
sentiment	positive, neutral, negative, mixed — null if not expressed
timestamp	MM:SS when the mention starts — null if indeterminate
context	Brief quote or description of the mention — null if absent
discountCode	Promo code as stated or shown — null if none
priceText	Price or deal text as stated — null if none
isSponsored	true when paid partnership or ad is disclosed for this product
confidence	high, medium, or low extraction confidence
scrapedAt	ISO timestamp of when this mention was mined

---

How It Works

1. Validate inputs — each URL is checked against accepted Instagram, TikTok, and YouTube patterns.
2. Fetch video — the video is retrieved along with creator metadata when the platform exposes it.
3. AI mention mining — the full video (audio and visuals) is analyzed to identify every distinct brand or product mention.
4. Structured output — each mention is classified with sentiment, sponsorship signals, codes, and timestamps.
5. Push to dataset — one flat row is written per product mention for easy downstream analysis.

---

Notes and Limitations

• Public videos only: Private or login-gated content is not supported.
• Video availability: Deleted or geo-blocked videos are skipped with a warning.
• Mention accuracy: Brief background products or unclear audio may yield lower confidence extractions.
• Rate limiting: Platforms may rate-limit at high volume — reduce concurrency or spread runs if failures occur.
• Video size: Videos over 100 MB are skipped automatically.
• API key required: Set GOOGLE_AI_STUDIO_API_KEY in your Actor environment variables before running.