# Instagram Competitor Analysis & Content Report (`davidbenittah/instagram-competitor-content-report`) Actor Analyze up to 10 public Instagram accounts and get one report per handle: posts per week, format mix of reels, carousels and images, engagement rate by format, top 5 posts with URLs, recurring caption hooks and best posting hours, plus a summary comparing every competitor. - **URL**: https://apify.com/davidbenittah/instagram-competitor-content-report.md - **Developed by:** [David](https://apify.com/davidbenittah) (community) - **Categories:** Social media, Marketing - **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $15.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use 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 Competitor Analysis & Content Report Give this Actor up to 10 public Instagram handles and it returns one Instagram content report per competitor account: how often they post, which formats they publish, which formats actually get interactions, their five best posts, the caption hooks that keep coming back, and the hours they publish at. A final item puts every account side by side. It reads public Instagram data only, with no login and no private profiles. ### Who this Instagram competitor analysis is for - Agencies producing weekly competitor content reports. - Brands tracking which competitor formats get the most interaction. - Founders preparing a quick Instagram content benchmark before a launch. - Social media managers replacing manual spreadsheet copy-paste. ### What is inside the Instagram content report - Analyze up to 10 public Instagram business or creator handles per run. - Output one `account_report` per handle with cadence, format mix, ER by format, top hooks, top 5 posts, and best posting hours. - Output one `competitive_summary` comparing all handles. - Bound post collection per account so run cost stays predictable. - Use the official `apify/instagram-scraper` as the upstream collector, then transform raw rows into strategy-ready reporting. ### Input ```json { "handles": ["nike", "adidas"], "maxPostsPerHandle": 25, "lookbackDays": 90, "includeTopPostUrls": true } ```` Hard limits: - 10 handles per run. - 100 posts per handle maximum. - 365 lookback days maximum. - Public Instagram accounts only. No login, no private profiles, no comments scraping. ### Output The Actor writes one `account_report` item per handle and one `competitive_summary` item. ### Data you get | Field | What it holds | | --- | --- | | `handle` | The public account analyzed | | `postCount` | Posts kept after the lookback filter | | `cadence` | Posts per week and active days | | `formatMix` | Number of reels, carousels and images | | `engagementByFormat` | Posts, average interactions and average engagement rate, per format | | `topHooks` | Recurring caption hooks, with count and average interactions | | `topPosts` | Top 5 posts by engagement score, with format, hook and public URL | | `bestPostingHours` | Hours ranked by posts and average interactions | | `competitive_summary` | One extra item comparing every handle in the run | Example account row: ```json { "type": "account_report", "handle": "brand_a", "postCount": 25, "cadence": { "postsPerWeek": 3.5, "activeDays": 49 }, "formatMix": { "reel": 12, "carousel": 8, "image": 5 }, "engagementByFormat": { "reel": { "posts": 12, "avgInteractions": 2400, "avgEngagementRate": 0.012 } }, "topHooks": [{ "hook": "summer starts here", "count": 3, "avgInteractions": 3100 }], "topPosts": [{ "format": "reel", "engagementScore": 5400, "captionHook": "summer starts here" }], "bestPostingHours": [{ "hour": 18, "posts": 6, "avgInteractions": 2900 }] } ``` ### Pricing Recommended pay-per-event pricing: `$0.005` per account report item plus a small Actor start fee. One paid result equals one competitor account analyzed; the cross-account summary is supporting output. ### FAQ #### Does it scrape private Instagram accounts? No. Public accounts only. #### Does it scrape comments or commenter identity? No. v1 analyzes public post-level metadata and captions only. #### Why use this instead of the raw Instagram scraper? The raw scraper gives rows. This Actor gives the report a marketer or agency can send to a team: cadence, format performance, hooks, winners, and posting-time patterns. #### Is this an Instagram API or an Instagram scraper? Neither on its own. It calls `apify/instagram-scraper` to collect the public Instagram data, then turns those raw rows into the report. You get the analysis, not a dump of posts. #### Can I export the report to CSV or Google Sheets? Yes. Every run writes to a standard Apify dataset, so the report exports as CSV, JSON or Excel, or goes to Google Sheets through an Apify integration. ### Disclaimer > This is an unofficial tool and is not affiliated with, endorsed by, or sponsored by Instagram or Meta. # Actor input Schema ## `handles` (type: `array`): Public Instagram business or creator handles to analyze. Hard maximum: 10 handles. ## `maxPostsPerHandle` (type: `integer`): Safety cap for posts collected per account. Hard maximum: 100. ## `lookbackDays` (type: `integer`): Posts older than this are excluded from the report. 0 means all collected posts. ## `includeTopPostUrls` (type: `boolean`): Include public post URLs for the top 5 posts in each report. ## `upstreamActorId` (type: `string`): Advanced: upstream Actor used to collect public Instagram post rows. ## `upstreamInputOverrides` (type: `object`): Advanced: extra fields merged into the upstream scraper input. ## Actor input object example ```json { "handles": [ "nike", "adidas" ], "maxPostsPerHandle": 25, "lookbackDays": 90, "includeTopPostUrls": true, "upstreamActorId": "apify/instagram-scraper" } ``` # Actor output Schema ## `results` (type: `string`): Structured result items. # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "handles": [ "nike", "adidas" ] }; // Run the Actor and wait for it to finish const run = await client.actor("davidbenittah/instagram-competitor-content-report").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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "handles": [ "nike", "adidas", ] } # Run the Actor and wait for it to finish run = client.actor("davidbenittah/instagram-competitor-content-report").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 '{ "handles": [ "nike", "adidas" ] }' | apify call davidbenittah/instagram-competitor-content-report --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=davidbenittah/instagram-competitor-content-report", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Instagram Competitor Analysis & Content Report", "description": "Analyze up to 10 public Instagram accounts and get one report per handle: posts per week, format mix of reels, carousels and images, engagement rate by format, top 5 posts with URLs, recurring caption hooks and best posting hours, plus a summary comparing every competitor.", "version": "1.0", "x-build-id": "1AZoIRBSn58aag6eQ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/davidbenittah~instagram-competitor-content-report/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-davidbenittah-instagram-competitor-content-report", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/davidbenittah~instagram-competitor-content-report/runs": { "post": { "operationId": "runs-sync-davidbenittah-instagram-competitor-content-report", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/davidbenittah~instagram-competitor-content-report/run-sync": { "post": { "operationId": "run-sync-davidbenittah-instagram-competitor-content-report", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "handles" ], "properties": { "handles": { "title": "Instagram handles", "type": "array", "description": "Public Instagram business or creator handles to analyze. Hard maximum: 10 handles.", "items": { "type": "string" } }, "maxPostsPerHandle": { "title": "Max posts per handle", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap for posts collected per account. Hard maximum: 100.", "default": 25 }, "lookbackDays": { "title": "Only posts from last N days", "minimum": 0, "maximum": 365, "type": "integer", "description": "Posts older than this are excluded from the report. 0 means all collected posts.", "default": 90 }, "includeTopPostUrls": { "title": "Include top post URLs", "type": "boolean", "description": "Include public post URLs for the top 5 posts in each report.", "default": true }, "upstreamActorId": { "title": "Upstream Instagram scraper Actor", "type": "string", "description": "Advanced: upstream Actor used to collect public Instagram post rows.", "default": "apify/instagram-scraper" }, "upstreamInputOverrides": { "title": "Upstream input overrides", "type": "object", "description": "Advanced: extra fields merged into the upstream scraper input." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```