AI Gift Recommendation Engine

An intelligent Apify Actor that generates personalized gift ideas by analyzing public social media profiles using AI. Perfect for finding the perfect gift based on someone's interests, hobbies, and personality traits.

Features

• Multi-Platform Support: Extracts data from LinkedIn, Instagram, Facebook, and Twitter/X public profiles
• AI-Powered Analysis: Uses OpenAI GPT or Google Gemini to analyze interests and personality
• Personalized Recommendations: Generates 5 tailored gift suggestions based on:
  • Extracted interests and hobbies
  • Occasion (Birthday, Anniversary, Holiday, etc.)
  • Budget constraints
  • Gender and regional preferences (optional)
• Amazon Integration: Direct search links for each recommended gift
• Test Mode: Quick testing without API calls or scraping
• Fast Execution: Optimized for sub-5-minute runtime
• Privacy-First: Only uses publicly available data, no login required

Input Parameters

Parameter	Type	Required	Description
profileUrls	array	Yes	List of public social profile URLs (LinkedIn, Instagram, Facebook, Twitter)
occasion	string	Yes	Gift occasion (e.g., "Birthday", "Anniversary", "Holiday")
budgetUSD	number	Yes	Maximum budget in USD (minimum: 1)
modelProvider	string	Yes	AI provider: "openai" or "gemini"
apiKey	string	Yes	API key for selected AI provider
gender	string	No	Recipient's gender for better recommendations
country	string	No	Recipient's country for regional availability
testMode	boolean	No	Enable to return mock results without API calls (default: false)

Input Example

{
  "profileUrls": [
    "https://www.linkedin.com/in/john-doe",
    "https://www.instagram.com/johndoe"
  ],
  "occasion": "Birthday",
  "budgetUSD": 100,
  "gender": "Male",
  "country": "United States",
  "modelProvider": "openai",
  "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxx",
  "testMode": false
}

Output Format

{
  "profileSummary": "Combined text from all social profiles...",
  "interests": [
    "Technology",
    "Photography",
    "Fitness",
    "Travel",
    "Reading"
  ],
  "giftIdeas": [
    {
      "gift": "Portable Phone Camera Lens Kit",
      "reason": "Perfect for their interest in photography and technology. Great for Birthday and fits within the $100 budget.",
      "amazonSearchUrl": "https://www.amazon.com/s?k=portable+phone+camera+lens+kit"
    },
    {
      "gift": "Fitness Tracker Smart Watch",
      "reason": "Aligns with their fitness enthusiasm. A practical gift for Birthday.",
      "amazonSearchUrl": "https://www.amazon.com/s?k=fitness+tracker+smart+watch"
    }
  ],
  "metadata": {
    "executionTimeMs": 5234,
    "profilesProcessed": 2,
    "modelProvider": "openai",
    "occasion": "Birthday",
    "budgetUSD": 100
  }
}

How It Works

1. Profile Scraping: The Actor visits each provided social media URL and extracts publicly available information:

   • LinkedIn: Headline, bio, about section, skills
   • Instagram: Bio, recent post captions
   • Facebook: Page info, descriptions
   • Twitter/X: Bio, recent tweets

2. Profile Summary: Combines all extracted text into a single comprehensive profile summary

3. AI Analysis: Sends the profile summary to your chosen AI provider (OpenAI or Gemini) to:

   • Extract key interests and hobbies
   • Identify personality traits
   • Determine professional field
   • Understand lifestyle preferences

4. Gift Generation: Based on the analysis, the AI generates 5 personalized gift recommendations considering:

   • The recipient's interests
   • The occasion
   • Budget constraints
   • Regional availability (if country specified)

5. Amazon Links: Each gift includes a direct Amazon search URL with relevant keywords

Supported Platforms

LinkedIn

• Extracts: Name, headline, bio, about section, skills
• Best for: Professional interests, career-related gifts

Instagram

• Extracts: Username, bio, recent post captions
• Best for: Personal interests, hobbies, lifestyle

Facebook

• Extracts: Page/person name, descriptions, about info
• Best for: General interests, community involvement

Twitter/X

• Extracts: Display name, bio, recent tweets
• Best for: Current interests, opinions, tech-savvy users

Use Cases

• Personal Gifting: Find the perfect birthday or holiday gift for friends and family
• Corporate Gifting: Select appropriate gifts for clients or employees
• E-commerce: Generate gift suggestions for your customers
• Event Planning: Prepare welcome gifts for conference attendees or wedding guests

Pricing

This Actor uses Apify's compute units and requires:

• Apify subscription: For running the Actor
• AI API credits: OpenAI or Google Gemini API key required
  • OpenAI: ~$0.002-0.005 per run (GPT-3.5-turbo)
  • Gemini: ~$0.0005-0.001 per run (Gemini Pro)

Test Mode

Enable testMode: true to:

• Skip all web scraping
• Skip AI API calls
• Return instant mock results
• Perfect for testing input/output format

Error Handling

The Actor handles errors gracefully:

• Invalid URLs: Skips and continues with valid ones
• Private profiles: Extracts whatever public data is available
• API errors: Falls back to generic recommendations based on available data
• Timeouts: Retries failed requests up to 2 times

Limitations

• Only extracts publicly available data (no login required)
• Profile data extraction depends on the platform's public page structure
• Some platforms may rate-limit or block scraping attempts
• Recommendations quality depends on the amount of public profile data available

Privacy & Ethics

• This Actor only accesses publicly visible profile information
• No login credentials or private data is accessed
• Respects robots.txt and platform terms of service
• Data is processed in-memory and not stored permanently

Technical Details

• Runtime: Node.js 20
• Browser: Playwright with Chrome
• AI Models: OpenAI GPT-3.5-turbo or Google Gemini Pro
• Max Execution Time: 5 minutes
• Memory: 4GB recommended

Support

For issues or feature requests:

1. Check the Actor page for updates
2. Contact the developer through Apify Console
3. Review the source code on GitHub (if public)

Changelog

Version 1.0.3

• Improved scraping reliability with better timeout handling
• Added meta tag extraction for more reliable data
• Enhanced error handling and retry logic

Version 1.0.0

• Initial release
• Support for LinkedIn, Instagram, Facebook, Twitter
• OpenAI and Gemini integration
• Amazon search URL generation

---

Built with Apify | Crawlee | Playwright