🌟 Instagram Reel Scraper Actor

Instantly fetch Instagram Reel data — likes, comments, views, duration, and more — in seconds.

---

📖 Summary

This Apify Actor extracts detailed information from Instagram Reels, delivering ready-to-use JSON datasets and key-value outputs without requiring any coding.

---

💡 Use Cases / When to Use

• Track engagement metrics for marketing campaigns
• Collect content insights for research or analytics
• Monitor competitor posts and trends
• Aggregate media formats and metadata for dashboards

---

⚡ Quick Start (Console)

1. Go to the Apify Console.
2. Paste your Instagram Reel URLs into the input field under startUrls.
3. Click Run Actor.
4. Fetch results instantly.

---

⚙️ Quick Start (CLI + API)

CLI:

$apify run --input input.example.json

Python API:

from apify_client import ApifyClient

client = ApifyClient('<APIFY_TOKEN>')
run_input = {
    "startUrls": ["https://www.instagram.com/reel/EXAMPLE123/"]
}

run = client.actor('your-actor-name').call(run_input=run_input)
print(run['output'])

---

📝 Inputs

🔑 Field	📝 Type	❓ Required	⚙️ Default	📌 Example	🧠 Notes
startUrls	array	✅ Yes	[]	["https://www.instagram.com/reel/EXAMPLE123/"]	List of Instagram Reel URLs to scrape
proxyConfiguration	object	⚙️ Optional	{}	{"useApifyProxy": true}	Proxy settings if needed

Console setup example: Paste your Reel URLs into startUrls, optionally configure proxies, then click Run Actor.

---

📄 Outputs

• Dataset: JSON array with fields:

  • id, original_url, ownerUsername, ownerFullName
  • likesCount, commentsCount, videoViewCount
  • duration (seconds), upload_date, upload_time_ago
  • formats, hashtags, mentions, resolution_detail
  • randomExtraInfo for metadata enrichment

• Key-Value Store: All results stored under OUTPUT key for easy download.

Example Output:

[
  {
    "id": "123456789",
    "original_url": "https://www.instagram.com/reel/EXAMPLE123/",
    "ownerUsername": "creator123",
    "likesCount": 1500,
    "commentsCount": 45,
    "videoViewCount": 10000,
    "duration": 81.0,
    "upload_date": "5th October 2019",
    "upload_time_ago": "3 Years Ago",
    "formats": [{"type":"video","url":"..."}],
    "hashtags": ["fun"],
    "mentions": ["friend"],
    "resolution_detail": "HD (720p)",
    "randomExtraInfo": {"scrapeBatch":"Reel-Set-12","regionCode":"US"}
  }
]

---

🔑 Environment Variables

• IG_USER (optional) — Instagram login username for higher access limits
• IG_PASS (optional) — Instagram password
• <APIFY_TOKEN> — Your Apify API token

---

▶️ How to Run

• Console: Click Run Actor after pasting inputs.
• CLI: apify run --input input.example.json
• API: Use the Python snippet above.

---

⏰ Scheduling & Webhooks

• Schedule recurring runs in Console (e.g., daily monitoring)
• Configure webhooks to get automatic notifications on new output

---

🕾 Logs & Troubleshooting

• Access logs in the Apify Console
• Errors per item are returned in error field if scraping fails

---

🔒 Permissions & Storage Notes

• This Actor is privacy-safe — no scraping of private accounts
• Outputs stored in Apify Dataset / KV Store securely

---

🔟 Changelog / Versioning

• v1.0 — Initial public release with duration normalization and metadata extraction

---

🖌 Notes / TODOs

• Verify duration numeric handling after logic update
• Optional: Add CONFIG.md for advanced proxy setups

---

🌍 Proxy Configuration

• Enable Apify Proxy: One-click toggle in Console
• Custom Proxy Example:

{"useApifyProxy": false, "proxyUrls": ["<PROXY_USER:PASS@HOST:PORT>"]}

• Store credentials as secrets, never in plaintext
• TODO: Consider proxy rotation for large-scale scraping

---

📚 References

• Apify Actor README guidelines
• Input/Output schema documentation
• CLI & API usage docs

---

🤔 Inferred from main.py

• Normalizes duration to numeric seconds only
• Formats upload date, likes, comments, views
• Enriches output with random metadata for traceability
• Supports optional proxies and environment-based login