📊 EngagementAnalyzer IG

LICENSE

Go beyond vanity metrics. EngagementAnalyzer IG calculates deep engagement quality for any Instagram profile — including comment authenticity, like velocity, saves estimation, fake engagement detection, and niche benchmarking.

---

🚀 What It Does

Most Instagram analytics tools only report a single engagement rate number. EngagementAnalyzer IG digs deeper:

• Real Engagement Rate — strips out fake/bot interactions for a true picture
• Comment Quality Score — measures depth and authenticity of comments (not just count)
• Like Velocity — how fast likes arrive (high velocity = viral / authentic audience)
• Saves Estimate — infers saves from engagement patterns (saves indicate genuine interest)
• Fake Engagement Detection — algorithmic detection of bot likes, generic comments, and suspicious patterns
• Niche Percentile — benchmarks the account against its tier (nano / micro / mid / macro / mega)
• Best Post Type & Time — identifies what content format and posting schedule drives most engagement
• AI Engagement Score — composite 0–10 quality score
• AI Insight — one-sentence computed insight per post

---

🎯 Use Cases

Use Case	Who It's For
Influencer vetting for brand deals	Marketing teams, agencies
Competitor engagement benchmarking	Social media managers
Detecting influencer fraud	Brands before paying sponsorships
Content strategy optimization	Creators, managers
Audience quality assessment	Investor due diligence
Platform trend analysis	Researchers, analysts

---

📥 Input Fields

Field	Type	Default	Description
username	string	(required)	Instagram username to analyze (with or without @)
maxPosts	number	12	Maximum number of posts to analyze (1–50)
includeSaves	boolean	true	Estimate saves from engagement patterns
detectFakeEngagement	boolean	true	Run fake engagement detection algorithm
benchmarkAgainstNiche	boolean	true	Compare against niche tier benchmarks

---

📤 Output Fields

Field	Type	Description
url	string	Post or profile URL analyzed
scrapedAt	string	ISO 8601 timestamp of scrape
actorVersion	string	Actor version (e.g. 0.1.0)
avgEngagementRate	number	Raw engagement rate % (likes+comments / followers)
realEngagementRate	number	Engagement rate adjusted for fake activity
commentQualityScore	number	Comment depth & authenticity score (0–10)
likeVelocity	number	Average likes per hour since posting
savesEstimate	number	Estimated number of saves
fakeEngagementPercent	number	Estimated % of engagement that is fake/bot
nichePercentile	number	Percentile ranking within account's tier
bestPostType	string	Best performing content type (feed/carousel/reel)
bestPostTime	string	Best day and time for posting
aiEngagementScore	number	Composite AI quality score 0–10
aiInsight	string	One-sentence computed insight about this record
aiScore	number	Overall relevance/quality score 0–10

---

📦 Example Output

{
  "url": "https://www.instagram.com/p/ABC123xyz/",
  "scrapedAt": "2024-07-15T10:32:41.000Z",
  "actorVersion": "0.1.0",
  "avgEngagementRate": 4.72,
  "realEngagementRate": 3.89,
  "commentQualityScore": 7.2,
  "likeVelocity": 342,
  "savesEstimate": 1240,
  "fakeEngagementPercent": 17.5,
  "nichePercentile": 82,
  "bestPostType": "carousel",
  "bestPostTime": "Tuesday 6:00 PM",
  "aiEngagementScore": 7.8,
  "aiInsight": "Top-tier performer in their niche (82nd percentile) with 4.72% engagement rate — carousel posts at Tuesday 6:00 PM drive the best results.",
  "aiScore": 7.8
}

---

🔍 How Fake Engagement Is Detected

The actor uses a multi-signal algorithm:

1. Engagement Rate Anomaly — suspiciously high ER for large accounts flags potential bought likes
2. Comment-to-Like Ratio — very low ratio suggests purchased likes without organic interaction
3. Comment Generic Score — high proportion of single-word/emoji comments ("nice!", "❤️", "🔥") indicates bot activity
4. Velocity Pattern — unnaturally uniform like velocity can indicate drip-purchased engagement

---

🧮 Engagement Tier Benchmarks

Tier	Follower Range	Avg Engagement Rate
Nano	< 1K	5.5%
Micro	1K – 10K	3.8%
Mid	10K – 100K	2.4%
Macro	100K – 1M	1.8%
Mega	1M+	1.2%

---

⚙️ Technical Details

• Built with Crawlee PlaywrightCrawler for robust JavaScript-rendered page scraping
• Uses residential proxies to avoid Instagram rate limiting
• Implements random delays (800–2000ms) between requests
• Stealth mode to bypass bot detection
• Automatic scroll-based pagination to load all posts
• Zod schema validation on every output record
• Pushes both per-post records AND an aggregated summary record

---

💡 Tips

• Start with maxPosts: 12 for a fast initial analysis (1–2 min)
• Use maxPosts: 30+ for a comprehensive historical audit
• The final record in the dataset with #summary in the URL contains aggregated metrics across all posts
• Compare multiple accounts by running the actor in sequence and using the nichePercentile field

---

⚠️ Disclaimer

This actor is for analytical and research purposes only. Always comply with Instagram's Terms of Service. Fake engagement percentages are estimates based on heuristic signals, not absolute measurements.