Instagram Influencer Deep Analyzer

A comprehensive Apify Actor for deep analysis of Instagram influencer profiles with AI-powered scoring, engagement metrics, fake follower detection, and extensive metadata extraction.

🚀 Features

• Profile Metadata Extraction: Follower count, following count, posts, verification status, bio, and more
• Deep Metadata: Join date estimation, verification date, location, username history
• Engagement Analysis: Calculate engagement rates from recent posts
• AI-Powered Scoring:
  • Fake follower probability detection
  • Audience quality scoring
  • Uses OpenAI embeddings for enhanced accuracy
• Post Insights: Detailed analysis of recent posts including engagement rates
• Posting Frequency: Calculate average posts per week
• Error Handling: Robust error handling with retry logic
• Proxy Support: Built-in Apify proxy integration
• Caching: LRU cache to avoid redundant API calls
• Slack Alerts (MCP connector): Optionally post a Slack message mid-run as soon as a profile crosses your fake-follower threshold, via an Apify MCP connector - no manual dataset checking required

📋 Input

The actor accepts the following input:

{
  "usernames": ["cristiano", "leomessi"],
  "getPosts": true,
  "deepMetadata": true,
  "maxPosts": 12,
  "useProxy": true,
  "proxyConfiguration": {}
}

Input Parameters

• usernames (required): Array of Instagram usernames to analyze (without @ symbol)
• getPosts (optional, default: true): Whether to fetch and analyze recent posts
• deepMetadata (optional, default: true): Enable deep metadata extraction
• maxPosts (optional, default: 12): Maximum number of recent posts to analyze (1-50)
• useProxy (optional, default: true): Use Apify proxy for scraping
• proxyConfiguration (optional): Advanced proxy configuration object
• sessionId (optional): An Instagram sessionid cookie value (from a logged-in browser session). Not required for normal operation, but if Instagram starts showing a login wall for anonymous requests again, supplying this lets the actor authenticate its requests instead of failing
• openaiApiKey (optional): Your own OpenAI API key to enable AI-enhanced fake-follower and audience-quality scoring. Without it, the actor uses rule-based scoring only
• slackConnector (optional): Apify Slack MCP connector ID. When set, the actor posts a Slack alert as soon as it finds a profile at or above fakeFollowerAlertThreshold
• slackChannel (optional, default: #instagram-alerts): Slack channel to post alerts to
• fakeFollowerAlertThreshold (optional, default: 60): Fake follower probability (0-100) that triggers a Slack alert

📤 Output

For each profile, the actor returns:

{
  "username": "cristiano",
  "profileMetadata": {
    "username": "cristiano",
    "fullName": "Cristiano Ronaldo",
    "biography": "...",
    "followers": 650000000,
    "following": 563,
    "posts": 3500,
    "isVerified": true,
    "isPrivate": false,
    "profilePictureUrl": "https://...",
    "externalUrl": "https://..."
  },
  "joinDate": "2014-01-01",
  "verificationDate": "2014-06-15",
  "location": "Portugal",
  "usernameHistory": ["cr7", "cristiano"],
  "engagementRate": 2.45,
  "fakeFollowerProbability": 15,
  "audienceQualityScore": 85,
  "postingFrequency": 3.2,
  "recentPostInsights": [
    {
      "postId": "123456789",
      "shortCode": "ABC123",
      "timestamp": "2024-01-15T10:00:00Z",
      "likes": 5000000,
      "comments": 50000,
      "caption": "...",
      "postType": "photo",
      "engagementRate": 0.78
    }
  ],
  "analyzedAt": "2024-01-15T12:00:00Z"
}

Output Fields

• username: Instagram username
• profileMetadata: Basic profile information
• joinDate: Estimated account creation date (if available)
• verificationDate: Account verification date (if available)
• location: Profile location (if available)
• usernameHistory: Historical usernames (if available)
• engagementRate: Average engagement rate percentage
• fakeFollowerProbability: AI-calculated fake follower probability (0-100)
• audienceQualityScore: AI-calculated audience quality score (0-100)
• postingFrequency: Average posts per week
• recentPostInsights: Detailed insights for recent posts
• analyzedAt: Timestamp of analysis

🛠️ Setup

Local Development

1. Clone or download this actor

2. Install dependencies:

   $npm install
   

3. Build the project:

   $npm run build
   

4. Run locally:

   $npm start
   

Apify Platform

1. Create a new actor in Apify Console
2. Upload the source code
3. Run the actor with your input - pass openaiApiKey in the input if you want AI-enhanced scoring

🔧 Configuration

AI Scoring

• openaiApiKey input field (optional, recommended over an actor-level env var since this is a public actor): each caller supplies their own OpenAI API key to enable AI-enhanced scoring, so no one's usage is billed to the actor owner. If omitted, the actor uses rule-based scoring only. An OPENAI_API_KEY environment variable is still supported as a fallback for local/private runs, but the input field takes precedence.

Proxy Configuration

The actor uses Apify's proxy by default. You can configure it via the proxyConfiguration input parameter:

{
  "proxyConfiguration": {
    "groups": ["RESIDENTIAL"],
    "countryCode": "US"
  }
}

📊 Scoring Algorithms

Engagement Rate

Calculated as: (Average Engagement / Followers) × 100

Where Average Engagement = (Total Likes + Total Comments) / Number of Posts

Fake Follower Probability

Combines multiple factors:

• Follower to following ratio
• Engagement rate patterns
• Posting consistency
• Account age indicators
• AI analysis (if OpenAI API key provided)

Audience Quality Score

Evaluates:

• Engagement rate
• Follower to following ratio
• Posting consistency
• Account verification status
• Bio quality
• AI analysis (if OpenAI API key provided)

🎯 Rising Star Eligibility

This actor is designed to be eligible for Apify's Rising Star placement by:

• ✅ Comprehensive feature set
• ✅ Well-structured code with TypeScript
• ✅ Proper error handling
• ✅ Proxy support
• ✅ Caching for efficiency
• ✅ AI-powered enhancements
• ✅ Detailed documentation
• ✅ Input/output schema validation
• ✅ Production-ready code quality

⚠️ Limitations

• Instagram's public API limitations may affect data availability; if Instagram tightens anonymous-request blocking again, requests may return a login wall until a sessionId cookie is supplied
• Some metadata (join date, verification date, username history) may not be available for all profiles
• Rate limiting may occur with high-volume scraping
• Private accounts cannot be fully analyzed

📝 License

Apache-2.0

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📧 Support

For issues and questions, please open an issue in the Apify Actor repository.

---

Note: This actor respects Instagram's Terms of Service and rate limits. Use responsibly and ethically.