Youtube Influencer Finder

A production-ready Apify Actor that finds the top 10 relevant YouTube influencers to promote a given product or service using AI and the official YouTube Data API v3.

Features

• Uses AI to analyze product descriptions and extract relevant content themes/keywords
• Searches YouTube channels via the official YouTube Data API v3 (no scraping)
• Ranks creators by relevance (AI reasoning + subscriber count)
• Returns only public data
• Includes test mode for Apify auto-tests
• Handles errors gracefully and respects API quotas

Input Schema

• productDescription (string, required): Description of the product or service to promote

• country (string, optional): Target country from a dropdown list of all countries

• language (string, optional): Target language from a dropdown list of all languages

• budgetUSD (number, optional): Marketing budget in USD

• openaiApiKey (string, required): User-provided OpenAI API key

• model (string, optional, default "gpt-4o-mini"): OpenAI model to use for analysis (gpt-4o-mini, gpt-4o, gpt-3.5-turbo)

• testMode (boolean, optional, default false): Enable test mode

API Key Configuration

• The OpenAI API key should be provided as a secret input by the user
• The YouTube API key is provided by the Apify actor creator as an environment variable (ACTOR_YOUTUBE_API_KEY)
• Users only need to provide their OpenAI API key - no YouTube API key is required from users

Output

Returns an array of exactly 10 influencers with:

• channelName: Name of the YouTube channel
• channelUrl: URL of the YouTube channel
• subscriberCount: Number of subscribers to the channel
• reasonForRecommendation: Short AI-generated explanation

Test Mode

When testMode is true:

• Skips OpenAI calls
• Skips YouTube API calls
• Pushes 1 mock dataset item
• Exits successfully within 1 second

Requirements

• Node.js 18+
• Apify SDK
• Valid OpenAI API key
• Valid YouTube Data API v3 key

Deployment

To deploy this actor to Apify:

1. Create a new actor in your Apify account
2. Upload all files in this repository
3. Configure the input and output schemas
4. Build and run the actor

Architecture

The actor follows a clear separation of concerns:

1. AI analysis: Understanding the product and extracting themes
2. YouTube search: Finding relevant channels using extracted keywords
3. Ranking: Using AI to evaluate relevance and rank channels
4. Output: Formatting and returning results