Instagram Stats Actor An Apify actor that fetches statistical data from Instagram posts using the Apify Instagram Scraper. This actor retrieves view counts, play counts, likes, and comments for Instagram posts. ## Features - Fetches comprehensive statistics for Instagram posts - Handles timeouts and retries automatically - Provides structured output data - Supports both single post URLs and batch processing - Includes detailed error handling and logging ## Prerequisites - Python 3.7 or later - Apify SDK - Valid Apify API token - Instagram Apify API token ## Installation 1. Clone this repository or download the source files bash git clone <repository-url> cd instagram-stats-actor 2. Install required dependencies bash pip install apify-client httpx tenacity ## Usage ### Running as Apify Actor 1. Input Schema: json { "url": "https://www.instagram.com/p/example" } 2. Example output: json { "url": "https://www.instagram.com/p/example", "shortCode": "example", "statistics": { "views": 1000, "plays": 950, "likes": 500, "comments": 50 }, "success": true } ## Configuration Options | Parameter | Type | Description | Default | |-----------|------|-------------|---------| | timeout | int | Request timeout in seconds | 30 | | max_retries | int | Maximum number of retry attempts | 3 | ## Error Handling The actor implements comprehensive error handling: - Timeouts: Automatically retries with exponential backoff - API Errors: Detailed error messages in the output - Invalid URLs: Validation and meaningful error messages - Network Issues: Automatic retry mechanism ## Examples ### Basic Actor Input json { "url": "https://www.instagram.com/p/example" } ### Custom Configuration Input json { "url": "https://www.instagram.com/p/example", "timeout": 60, "maxRetries": 5 } ### Success Output Example json { "url": "https://www.instagram.com/p/example", "shortCode": "example", "statistics": { "views": 1000, "plays": 950, "likes": 500, "comments": 50 }, "success": true } ### Error Output Example json { "url": "https://www.instagram.com/p/example", "error": "Request timed out after 30 seconds", "success": false } ## License This project is licensed under the MIT License - see the LICENSE file for details.