# Instagram Video Analytics Scraper (`datapilot/instagram-video-analytics-scraper`) Actor

📊 Instagram Video Analytics Tool
This  script uses Instaloader to extract Instagram Reel or video analytics such as views, likes, and comments without downloading media. It displays clean stats in a table format, making it useful for developers, marketers, and content creators. 🚀

- **URL**: https://apify.com/datapilot/instagram-video-analytics-scraper.md
- **Developed by:** [Data Pilot](https://apify.com/datapilot) (community)
- **Categories:** Videos
- **Stats:** 39 total users, 1 monthly users, 97.1% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

$7.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Instagram Video Analytics Scraper

🚀 **Instagram Video Analytics Scraper** is an advanced Apify Actor designed to scrape **Instagram Video Analytics data** from Instagram post URLs. This tool provides comprehensive **Instagram Video Analytics**, including view counts, likes, comments, and owner details for reels and posts. Whether you're analyzing Instagram Video Analytics for content performance, influencer research, or social media insights, the Instagram Video Analytics Scraper delivers detailed **Instagram Video Analytics** efficiently.

With residential proxy support, the Instagram Video Analytics Scraper ensures reliable and undetected scraping of **Instagram Video Analytics**. It focuses on key **Instagram Video Analytics metrics** like engagement rates and viewer data, making it an essential tool for **Instagram Video Analytics analysis** and content strategy.

### 🔥 Features

- **Comprehensive Instagram Video Analytics Extraction** – Scrapes detailed **Instagram Video Analytics**, including views, likes, comments, and captions for any Instagram post or reel URL.
- **Multi-Format Support** – Handles **Instagram Video Analytics** for reels, posts, and other Instagram content types.
- **Batch Processing** – Processes multiple **Instagram Video Analytics URLs** in a single run for efficient **Instagram Video Analytics data collection**.
- **Residential Proxy Support** – Utilizes Apify's residential proxies to bypass restrictions and ensure high success rates for **Instagram Video Analytics scraping**.
- **Metadata Retrieval** – Extracts **Instagram Video Analytics metadata** like owner usernames and shortcodes for in-depth **Instagram Video Analytics analysis**.
- **Error Handling** – Robust logging and fallback mechanisms for failed **Instagram Video Analytics scrapes**.
- **Dataset Integration** – Automatically uploads **Instagram Video Analytics data** to your Apify dataset for easy export and analysis.

***

### ⚙️ How It Works

The Instagram Video Analytics Scraper takes one or more Instagram post URLs as input and uses instaloader to fetch **Instagram Video Analytics data**. It extracts shortcodes from URLs, retrieves post metrics like views and likes, and handles proxy configurations for reliable scraping. The scraper returns structured **Instagram Video Analytics data** on success or error details on failure, providing a fast way to gather **Instagram Video Analytics**.

**Key benefits for Instagram Video Analytics analysis:**

- Track Instagram Video Analytics engagement metrics like views and likes.
- Analyze Instagram Video Analytics performance for content optimization.
- Build Instagram Video Analytics databases for influencer and brand research.
- Monitor content performance trends over time.
- Research audience engagement patterns.

***

### 📥 Input

The Actor accepts the following input parameters:

| Field                | Type    | Default              | Description |
|----------------------|---------|----------------------|-------------|
| `urls`               | string  | required             | List of Instagram post URLs to scrape Instagram Video Analytics from, one per line (e.g., `"https://www.instagram.com/p/..."`). |
| `useApifyProxy`      | boolean | `true`               | Enable residential proxies for Instagram Video Analytics scraping. |
| `apifyProxyGroups`   | array   | `["RESIDENTIAL"]`    | Proxy groups to use (e.g., `["RESIDENTIAL"]`). |

**Example input JSON:**

```json
{
  "urls": "https://www.instagram.com/reel/example1\nhttps://www.instagram.com/p/example2",
  "useApifyProxy": true,
  "apifyProxyGroups": ["RESIDENTIAL"]
}
```

***

### 📤 Output

The scraper outputs detailed **Instagram Video Analytics** in JSON format for each URL. Each record includes:

| Field       | Type    | Description |
|-------------|---------|-------------|
| `url`       | string  | Original Instagram post URL. |
| `shortcode` | string  | Shortcode of the Instagram post. |
| `views`     | integer | Number of views for the Instagram Video Analytics (if video). |
| `likes`     | integer | Number of likes for the Instagram Video Analytics. |
| `comments`  | integer | Number of comments for the Instagram Video Analytics. |
| `owner`     | string  | Username of the Instagram Video Analytics owner. |
| `caption`   | string  | Caption text of the Instagram Video Analytics (truncated to 150 characters). |
| `scraped_at`| string  | ISO timestamp of the Instagram Video Analytics scrape. |

**Example output for successful Instagram Video Analytics:**

```json
{
  [
  {
    "url": "https://www.instagram.com/reel/DRkzBLRktBK/?utm_source=ig_web_button_share_sheet",
    "shortcode": "DRkzBLRktBK",
    "views": 1285641,
    "likes": 303159,
    "comments": 2192,
    "owner": "hailiejade",
    "caption": "happy thanksgiving 💕",
    "scraped_at": "2026-02-15T17:51:13.394366"
  }
]
}
```

**Example error response:**

```json
{
  "url": "https://www.instagram.com/p/invalid",
  "status": "failed",
  "error": "Post not accessible or has been deleted",
  "scraped_at": "2025-02-14T12:00:00Z"
}
```

***

### 🧰 Technical Stack

- **Core Library:** instaloader – Instagram data extraction library.
- **Proxy:** Apify Proxy with RESIDENTIAL support for reliable access.
- **Platform:** Apify Actor – serverless, scalable, integrated with Dataset and Key‑Value Store.
- **Deployment:** One‑click run on Apify Console or via REST API.

***

### 🎯 Use Cases

- **Content Performance Analysis** – Analyze Instagram Video Analytics to understand content performance.
- **Influencer Research** – Evaluate influencer engagement through Instagram Video Analytics.
- **Content Strategy** – Use Instagram Video Analytics to inform content creation strategy.
- **Engagement Benchmarking** – Compare engagement metrics across different content types.
- **Brand Monitoring** – Track Instagram Video Analytics for brand-related content.
- **Competitor Analysis** – Analyze competitor Instagram Video Analytics for competitive insights.
- **Audience Insights** – Understand audience preferences through Instagram Video Analytics.
- **Campaign Measurement** – Measure campaign effectiveness through Instagram Video Analytics.
- **Trend Analysis** – Identify trending content through Instagram Video Analytics.
- **Creator Research** – Research creator performance and engagement patterns.
- **Social Media Research** – Collect Instagram Video Analytics for social media studies.
- **Academic Research** – Gather Instagram Video Analytics data for research purposes.
- **Market Research** – Conduct market research using Instagram Video Analytics.
- **ROI Analysis** – Analyze return on investment for Instagram marketing efforts.

***

### 🚀 Quick Start

1. **Open in Apify Console** – visit the Actor page and click Try for free.
2. **Enter Instagram post URLs** – provide one or more Instagram post URLs (one per line).
3. **Enable residential proxies** – enabled by default for reliable scraping.
4. **Click Start** – the Actor will scrape Instagram Video Analytics.
5. **View Results** – check the dataset for analytics data.
6. **Analyze Data** – use the metrics for content analysis.
7. **Export** – download the results as JSON, CSV, or Excel.

You can also call this Actor programmatically via Apify SDK or REST API – ideal for automated Instagram Video Analytics collection and analysis pipelines.

***

### 💎 Why This Actor?

| Feature | Benefit |
|---------|---------|
| ✅ Comprehensive metrics | Get views, likes, comments, and captions. |
| ✅ Batch processing | Analyze multiple posts in one run. |
| ✅ Multi-format support | Works with reels, posts, and other content. |
| ✅ Residential proxies | Bypass restrictions – reliable Instagram access. |
| ✅ Owner information | Track content creators and ownership. |
| ✅ Fast scraping | Get analytics quickly with optimized requests. |
| ✅ Error handling | Robust fallback mechanisms for reliability. |
| ✅ Apify ecosystem | Seamless integration with other Actors, triggers, and webhooks. |

### 📦 Changelog

- Initial release with Instagram Video Analytics scraping.
- Support for reels, posts, and other Instagram content formats.
- Comprehensive metrics extraction (views, likes, comments).
- Owner and caption information retrieval.
- Batch processing for multiple URLs.
- Residential proxy support for reliability.
- Shortcode extraction and tracking.
- Error handling with detailed error messages.
- Automatic dataset integration.
- Full Apify Actor integration.

***

### 🧑‍💻 Support & Feedback

- **Issues & Ideas:** Open a ticket on the Apify Actor issue tracker.
- **Documentation:** Visit Apify Docs for platform guides.
- **Community:** Join the Apify community forum for discussions and support.

***

### 💰 Pricing

- **Free** for basic usage on Apify platform.
- **Paid plans** available for higher limits and priority support.
- Proxy credits consumed based on residential proxy usage.

***

# Actor input Schema

## `urls` (type: `string`):

Provide one or more Instagram Reel/Video URLs, one per line.

## `useApifyProxy` (type: `boolean`):

Enables the use of Apify proxies to prevent IP blocking.

## `apifyProxyGroups` (type: `array`):

Select the proxy groups to use.

## Actor input object example

```json
{
  "urls": "https://www.instagram.com/reels/C8U5-pSstX7/",
  "useApifyProxy": true,
  "apifyProxyGroups": [
    "RESIDENTIAL"
  ]
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "urls": "https://www.instagram.com/reels/C8U5-pSstX7/"
};

// Run the Actor and wait for it to finish
const run = await client.actor("datapilot/instagram-video-analytics-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "urls": "https://www.instagram.com/reels/C8U5-pSstX7/" }

# Run the Actor and wait for it to finish
run = client.actor("datapilot/instagram-video-analytics-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "urls": "https://www.instagram.com/reels/C8U5-pSstX7/"
}' |
apify call datapilot/instagram-video-analytics-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datapilot/instagram-video-analytics-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/NqXulEhDK9KYE0vdb/builds/f2fjlZMHCpfjj0QFC/openapi.json
