🚀 ViralityScorer IG — AI Virality Prediction Engine for Instagram

Predict whether your next Instagram post will go viral — before you hit publish. ViralityScorer IG uses a multi-factor AI engine to analyze your caption, hashtags, content type, posting time, and account context to deliver a precise virality score (0–100) along with predicted engagement metrics and actionable optimization tips.

---

🎯 What Does It Do?

ViralityScorer IG reverse-engineers the Instagram algorithm by combining content analysis, temporal analysis, and account context scraping to generate a comprehensive Viral Probability Score and full engagement forecast for any upcoming post.

Key capabilities:

• 🔢 Virality Score (0-100): A weighted composite score across hashtag quality, caption engagement signals, content format, and posting time
• 📊 Predicted Engagement: Estimated likes, comments, shares, and total reach before you post
• 💪 Strength/Weakness Analysis: Understand exactly what's working and what's not
• 🛠️ Actionable Improvements: Specific, algorithm-informed suggestions to boost performance
• ⏰ Best Time to Post: Personalized timing recommendations based on your scheduled time
• 🤖 AI Viral Prediction: Natural-language summary of your post's viral potential

---

🏆 Use Cases

Use Case	Who Benefits	Expected Outcome
Pre-publish content audit	Content creators	Optimize before posting for 2-5x more reach
Hashtag strategy testing	Social media managers	Identify best hashtag mix for discoverability
Posting schedule optimization	Brand marketers	Maximize engagement by timing posts correctly
A/B caption testing	Growth hackers	Compare multiple caption variations by score
Influencer campaign planning	Agencies & brands	Predict campaign ROI before launch
Reel vs. Photo decision	Individual creators	Choose content format with highest viral potential
Content calendar optimization	Marketing teams	Batch-analyze weeks of planned content

---

📥 Input Fields

Field	Type	Required	Default	Description
captionText	String	No	""	📝 The full caption text for your post
hashtags	Array	No	[]	#️⃣ Array of hashtags (with or without # prefix)
contentType	String	No	"photo"	🎬 Content type: photo, reel, video, carousel, story, live, igtv
scheduledTime	String	No	Current time	⏰ ISO 8601 datetime string for planned post time
accountUsername	String	No	""	👤 Instagram username for account context scraping

---

📤 Output Fields

Field	Type	Description
url	String	Source URL analyzed
scrapedAt	String	ISO timestamp of analysis
actorVersion	String	Actor version
aiInsight	String	One-sentence AI insight about this post
aiScore	Number (0-10)	Overall quality/relevance score
viralityScore	Number (0-100)	Composite viral probability score
predictedLikes	Number	Estimated likes this post will receive
predictedComments	Number	Estimated comment count
predictedReach	Number	Estimated total reach (unique accounts)
predictedShares	Number	Estimated shares/saves
strengthFactors	Array	List of positive content signals
weaknessFactors	Array	List of areas needing improvement
suggestedImprovements	Array	Specific actionable recommendations
bestTimeToPost	String	Optimal posting time recommendation
aiViralPrediction	String	Full AI narrative viral probability assessment

---

💡 Example Output

{
  "url": "https://www.instagram.com/natgeo/",
  "scrapedAt": "2024-01-15T14:32:00.000Z",
  "actorVersion": "0.1.0",
  "aiInsight": "@natgeo's reel has a 82/100 virality score — projected 487,000 reach with strong algorithmic promotion potential.",
  "aiScore": 8.2,
  "viralityScore": 82,
  "predictedLikes": 34250,
  "predictedComments": 3920,
  "predictedReach": 487000,
  "predictedShares": 2450,
  "strengthFactors": [
    "Optimal hashtag count and mix",
    "Engaging caption with strong call-to-action",
    "High-performing content type: reel",
    "Posted at peak engagement time",
    "Using 15 targeted hashtags"
  ],
  "weaknessFactors": [
    "No major weaknesses detected"
  ],
  "suggestedImprovements": [
    "Great content plan! A/B test caption variations to optimize further",
    "Engage with 10-20 similar posts before and after publishing to boost initial visibility"
  ],
  "bestTimeToPost": "Your scheduled time is optimal. Keep it at Mon, 15 Jan 2024 12:00:00 GMT",
  "aiViralPrediction": "VIRAL PROBABILITY: HIGHLY LIKELY (Score: 82/100). Reels are currently Instagram's most promoted format. Your 15 hashtags provide good discoverability surface. Caption strength is solid with good length. Algorithm indicators suggest strong initial push from explore page."
}

---

🧠 How the AI Scoring Works

The virality score is computed using a weighted multi-factor model:

Factor	Weight	What We Analyze
Caption Quality	30%	Length, CTAs, emojis, questions, engagement triggers
Hashtag Strategy	25%	Count, diversity, niche vs broad mix
Content Type	25%	Format algorithmic priority (Reels > Carousels > Video > Photo)
Posting Timing	20%	Hour of day, day of week vs. peak engagement windows

All scores are normalized to 0-100 with slight variance simulation to reflect real-world unpredictability.

---

💰 Pricing

This actor is priced on a pay-per-use compute unit model:

• Single analysis run: 0.05 compute units ($0.02)
• Bulk analysis (100 posts): 5 compute units ($2.00)
• With profile scraping: ~0.1-0.2 compute units per run

Runs complete in 30-90 seconds depending on whether profile/hashtag scraping is enabled.

---

🚀 Quick Start

{
  "captionText": "Golden hour never gets old 🌅 Drop a ❤️ if you agree! Tag someone who needs to see this view. Save this for your next travel inspo!",
  "hashtags": ["travel", "goldenhour", "sunset", "travelphotography", "wanderlust", "landscapephotography", "nature", "travelgram", "explore", "adventure"],
  "contentType": "reel",
  "scheduledTime": "2024-06-15T18:00:00Z",
  "accountUsername": "natgeo"
}

---

⚠️ Important Notes

• Instagram may require authentication for profile scraping. The actor gracefully falls back to caption/hashtag-only analysis if profile data is unavailable.
• Results are predictions based on algorithmic signals — actual performance depends on follower quality, community engagement, and algorithm updates.
• For best results, provide all 5 input fields.

---

🔗 Related Actors

• Instagram Hashtag Scraper
• Instagram Profile Analyzer
• Instagram Post Extractor