# Instagram Influencer Analyzer & Sponsored Post Tracker (`scrapemint/instagram-scraper`) Actor
Rank Instagram creators by real engagement rate. Flag sponsored posts and paid partnerships. Track brand mentions across posts, reels, comments, profiles, hashtags, places, and user search. For agencies, brand marketers, and ad intelligence teams. JSON. Pay per result.
- **URL**: https://apify.com/scrapemint/instagram-scraper.md
- **Developed by:** [Kennedy Mutisya](https://apify.com/scrapemint) (community)
- **Categories:** Automation, Developer tools, Social media
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet
## Pricing
Pay per usage
This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.
Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage
## What's an Apify Actor?
Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 Influencer Analyzer & Sponsored Post Tracker
Rank Instagram creators by real engagement rate. Flag sponsored and paid partnership posts. Track mentions of your brand across every profile, post, reel, and comment. Eight content types in one actor: posts, reels, comments, mentions, profiles, hashtags, places, user search. Every profile row ships with engagement rate and posting cadence. Every post row ships with a sponsored content flag. One clean JSON row per item. Pay only for what you keep.
Built for talent agencies, brand marketers, ad intelligence teams, FTC compliance auditors, and PR teams who need Instagram data without the official Graph API gate.
**Ranks for:** Instagram influencer analyzer, Instagram influencer finder, Instagram creator analytics, Instagram engagement rate calculator, Instagram sponsored post tracker, Instagram sponsored post detector, Instagram brand monitoring, Instagram paid partnership audit, Instagram influencer database, Instagram scraper, Instagram API alternative, Instagram API free, scrape Instagram posts, Instagram profile scraper, Instagram follower count, Instagram hashtag tracker, Instagram reels scraper, Instagram comments scraper, Instagram to CSV, Instagram to JSON.
---
### What makes this different
Most Instagram scrapers stop at raw data. This one computes the answers buyers actually want:
1. **Engagement rate and posting cadence** on every profile row. Average likes, average comments, engagement rate as a percent of followers, and posts per week. Ready for agency decks and influencer databases. Zero post processing.
2. **Sponsored post detection** on every post row. Flags `#ad`, `#sponsored`, `#paidpartnership`, Instagram's paid partnership label, and brand tag patterns. Returns a boolean plus the signal list. Perfect for ad intelligence and FTC compliance monitoring.
3. **One actor, every content type.** Posts, reels, comments, mentions, profile info, hashtag volume, place details, user search. No juggling five separate scrapers.
---
### How it works
```mermaid
flowchart LR
A[Pick content type] --> B[Paste URLs
or search query]
B --> C[Open in
headless Chromium]
C --> D[Parse JSON-LD
+ og tags
+ grid links]
D --> E[Compute engagement
detect sponsors
extract mentions]
E --> F[Push rows
to dataset]
F --> G[(JSON, CSV,
Excel, API)]
````
Pick one of eight content types in the dropdown. Drop matching Instagram URLs or enter search terms. The actor walks each page, reads embedded structured data, and returns one row per result.
***
### 8 content types in one actor
```mermaid
flowchart TD
CT[contentType] --> P[posts]
CT --> R[reels]
CT --> C[comments]
CT --> M[mentions]
CT --> PR[profile]
CT --> H[hashtag]
CT --> PL[place]
CT --> US[user-search]
P --> PO[Profile URL
Post URL
Hashtag URL]
R --> RO[Profile URL
Reel URL
Hashtag URL]
C --> CO[Post or reel URL]
M --> MO[Profile URL]
PR --> PRO[Profile URL]
H --> HO[Hashtag URL
or search query]
PL --> PLO[Location URL
or search query]
US --> USO[Search query]
```
***
### What works today
| Content type | Status | Input | What you get |
|---|---|---|---|
| `profile` | Reliable | Profile URL | Username, full name, bio, followers, following, post count, verified flag, recent posts sample, engagement rate, posts per week. |
| `posts` | Reliable | Profile URL | Post rows from the profile grid: caption, likes, comments, hashtags, mentions, media URL, sponsored flag. |
| `reels` | Reliable | Profile URL or reel URL | Same fields as posts plus kind reel. |
| `comments` | Reliable | Post or reel URL | Author, text, profile URL per comment. |
| `mentions` | Reliable | Profile URL | Ranked list of @ mentions from a profile's recent posts with count and post references. |
| `hashtag` | Limited | Hashtag URL or query | Instagram restricts anonymous hashtag pages. Expect partial data without a session. |
| `place` | Limited | Location URL or query | Same restriction as hashtag pages. |
| `user-search` | Limited | Search query | Anonymous topsearch often returns empty results. |
> **Best practice:** most agencies run `profile` with a list of creator URLs, get engagement rates out of the box, then run `posts` on the winners for deeper caption and media data.
***
### Quick start
**Creator audit with engagement rate:**
```json
{
"contentType": "profile",
"urls": [
"https://www.instagram.com/humansofny/",
"https://www.instagram.com/natgeo/"
],
"resultsLimit": 30,
"includeEngagementMetrics": true
}
```
**Track sponsored posts for a creator:**
```json
{
"contentType": "posts",
"urls": ["https://www.instagram.com/kyliejenner/"],
"resultsLimit": 50,
"detectSponsoredPosts": true
}
```
**Scrape comments for a single post:**
```json
{
"contentType": "comments",
"urls": ["https://www.instagram.com/p/SHORTCODE/"],
"resultsLimit": 200
}
```
**Find brands a creator tags most:**
```json
{
"contentType": "mentions",
"urls": ["https://www.instagram.com/chrissyteigen/"],
"resultsLimit": 25
}
```
***
### Sample output
Per profile row with engagement metrics:
```json
{
"type": "profile",
"id": "17841401870966586",
"username": "humansofny",
"fullName": "Humans of New York",
"biography": "Stories of people on the streets of New York.",
"verified": true,
"followers": 12400000,
"following": 8,
"postsCount": 9200,
"profilePicUrl": "https://scontent.cdninstagram.com/...",
"engagement": {
"avgLikes": 184000,
"avgComments": 3200,
"engagementRate": 1.511,
"postsPerWeek": 2.4,
"sampleSize": 30
},
"scrapedAt": "2026-04-24T12:00:00.000Z"
}
```
Per post row with sponsored detection:
```json
{
"type": "post",
"id": "CxYz123abc",
"shortcode": "CxYz123abc",
"url": "https://www.instagram.com/p/CxYz123abc/",
"caption": "loving this hydrator from @glossier #ad",
"hashtags": ["ad"],
"mentions": ["glossier"],
"likes": 42180,
"comments": 1822,
"createdAt": "2026-04-22T18:11:00.000Z",
"ownerUsername": "someuser",
"locationName": "New York, New York",
"image": "https://scontent.cdninstagram.com/...",
"isSponsored": true,
"sponsorSignals": ["#ad"]
}
```
Per mention row:
```json
{
"type": "mention",
"sourceProfile": "chrissyteigen",
"mentionedUsername": "cravingsbychrissy",
"count": 14,
"posts": [
{ "id": "Cabc", "url": "https://www.instagram.com/p/Cabc/", "createdAt": "2026-04-20T10:00:00.000Z" }
]
}
```
***
### What you get per row
```mermaid
flowchart LR
V[Post or reel row] --> V1[Content
caption, hashtags,
mentions, cover]
V --> V2[Stats
likes, comments,
createdAt]
V --> V3[Owner
username, verified,
follower count]
V --> V4[Detection
isSponsored,
signal list]
V --> V5[Media
image or video URL,
alt text, location]
```
***
### Who uses this
| Role | Use case |
|---|---|
| Talent agency | Rank creators by real engagement rate, not vanity follower counts. |
| Brand marketer | Monitor branded hashtag reach and UGC volume. |
| Social listening | Feed posts and comments into sentiment and share of voice models. |
| Ad intelligence | Track competitor sponsored posts with isSponsored flag. |
| FTC compliance | Audit paid partnership disclosures across a creator roster. |
| PR and crisis team | Watch mentions of a brand or public figure in near real time. |
| Data journalist | Pull structured Instagram data for investigations. |
| E commerce ops | Find creators tagging your brand and measure their audience overlap. |
***
### Input reference
| Field | Type | Purpose |
|---|---|---|
| `contentType` | enum | What to scrape. Drives URL and query parsing. |
| `urls` | string\[] | Instagram URLs. Priority over queries. |
| `searchQueries` | string\[] | Keywords for hashtag, place, or user search. |
| `resultsLimit` | integer | Cap per URL or query. Default 100. |
| `filterByDate` | string | `YYYY-MM-DD` or `7 days ago`. UTC. |
| `includeEngagementMetrics` | boolean | Compute avg likes, avg comments, engagement rate, posts per week. |
| `detectSponsoredPosts` | boolean | Flag `#ad`, `#sponsored`, `#paidpartnership`, partnership labels. |
| `downloadMedia` | boolean | Save images and videos to the key value store. |
| `scrapeCommentsPerPost` | integer | Top N comments per post. 0 disables. |
| `includeMediaMetadata` | boolean | Add dimensions, alt text, tagged location. |
| `dedupe` | boolean | Skip IDs from previous runs. |
| `maxItemsTotal` | integer | Hard cap across all sources. Default 500. |
| `proxyConfiguration` | object | Apify proxy. Residential recommended. |
***
### API example
```bash
curl -X POST \
"https://api.apify.com/v2/acts/YOUR_USER~instagram-scraper/runs?token=YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"contentType": "profile",
"urls": ["https://www.instagram.com/humansofny/"],
"resultsLimit": 30
}'
```
***
### How this compares
| | Official Instagram Graph API | Generic Instagram scrapers | **This actor** |
|---|---|---|---|
| Access | App review + business verification | Per actor setup | Anyone |
| Engagement rate | You calculate it | Separate tool | Built in |
| Sponsored post flag | No | Separate tool | Built in |
| All content types | Partial | Need 4 to 6 actors | One actor |
| Cost model | Per call quota | Often per run | Pay per result row |
| Setup time | Weeks | Days | 60 seconds |
***
### Pricing
First 10 items per run are free so you can try before paying. After that you pay per result row. Engagement metrics, sponsored detection, mention rollups, and hashtag arrays are included at no extra cost. Media downloads and comment scraping add a small per unit cost when enabled.
***
### FAQ
**Is there a free Instagram API?**
Instagram's Graph API is gated behind app review and a verified business account. This actor gives anyone public Instagram data with pay per use and no app approval needed.
**How do I scrape Instagram without an API key?**
Pick a content type, paste profile or post URLs, hit Start. Residential proxy and fingerprint rotation are handled.
**How do you calculate Instagram engagement rate?**
Engagement rate is the average of (likes + comments) per recent post divided by follower count, expressed as a percentage. The actor samples up to `resultsLimit` recent posts from the profile grid. Industry standard is 1 to 3 percent for mid tier creators and under 1 percent for mega creators.
**How accurate is the sponsored post flag?**
High precision on caption signals (`#ad`, `#sponsored`, `#paidpartnership`, paid partnership labels) and moderate precision on brand tag heuristics. Treat it as a fast filter, not a legal determination.
**Can I download Instagram photos and videos?**
Yes. Turn on `downloadMedia`. Each row includes a `downloadUrl` link to the source media.
**Can I scrape Instagram comments?**
Yes. Use `contentType: comments` with a post or reel URL, or set `scrapeCommentsPerPost` on a posts or reels run.
**Why do hashtag and place searches sometimes return empty?**
Instagram restricts anonymous access to hashtag and location pages. Use profile URLs for reliable results. Hashtag volume and top posts come back when Instagram serves the page to signed out visitors, which varies by region and IP reputation.
**Does it work for private accounts?**
No. Only public profiles, posts, reels, hashtags, and places that Instagram exposes to signed out visitors.
**Can I run this on a schedule?**
Yes. Use the Apify scheduler for hourly, daily, or weekly runs. Turn `dedupe` off if you want a fresh snapshot for trend tracking.
**Does it work in any country?**
Yes. The actor ships with residential proxy rotation. Your results reflect what a visitor in the proxy region sees.
**Is scraping Instagram allowed?**
This actor reads public HTML any web visitor can see. Respect Instagram's terms and rate limit sensibly. Do not store or redistribute content you do not have the right to use.
***
### Related actors
- **TikTok Scraper** for TikTok creator stats, reels, and music data
- **Reddit Brand Monitor & Lead Finder** for subreddit mentions and high intent leads
- **Google Maps Scraper** for local business data and reviews
- **TripAdvisor Review Intelligence** for hotel and restaurant review monitoring
- **Yelp Review Intelligence** for local service reviews
- **Amazon Review Intelligence** for product review tracking
# Actor input Schema
## `contentType` (type: `string`):
What kind of data you want. Each type expects a matching URL or search query.
## `urls` (type: `array`):
Instagram URLs to scrape. URLs take priority over search queries and cannot be combined. Use /p/ for posts, /reel/ for reels, /username/ for profiles, /explore/tags/ for hashtags, /explore/locations/ for places.
## `searchQueries` (type: `array`):
Keywords to search (hashtags, users, or places depending on content type). Enter multiple terms as separate items. Ignored when URLs are provided.
## `resultsLimit` (type: `integer`):
Cap on results returned per URL or query. Controls cost and runtime.
## `filterByDate` (type: `string`):
Only return posts newer than this date. UTC, not local time. Format YYYY-MM-DD for absolute, or a relative like '7 days ago', '1 month ago'. Leave blank for no filter.
## `includeEngagementMetrics` (type: `boolean`):
On profile and hashtag runs, compute avg likes per post, avg comments per post, engagement rate as a percentage of followers, and posts per week. Built in. No extra cost.
## `detectSponsoredPosts` (type: `boolean`):
Mark each post with isSponsored true or false based on #ad, #sponsored, #paidpartnership, Instagram's paid partnership label, and brand tag patterns. Built in. No extra cost.
## `downloadMedia` (type: `boolean`):
Save every image and video to the key value store and include a downloadUrl per post. Adds storage cost.
## `scrapeCommentsPerPost` (type: `integer`):
Pull the top N comments from each post or reel in the run. 0 disables. Only runs for posts and reels content types.
## `includeMediaMetadata` (type: `boolean`):
Enrich each row with width, height, alt text (accessibility caption), and tagged location when available.
## `dedupe` (type: `boolean`):
Skip post and profile IDs already pushed in previous runs. Turn off to refresh counts on the same items.
## `maxItemsTotal` (type: `integer`):
Hard cap across all URLs and queries. Controls total cost.
## `proxyConfiguration` (type: `object`):
Apify proxy. Residential strongly recommended. Instagram blocks datacenter IPs aggressively.
## Actor input object example
```json
{
"contentType": "posts",
"urls": [
"https://www.instagram.com/humansofny/"
],
"searchQueries": [],
"resultsLimit": 100,
"filterByDate": "",
"includeEngagementMetrics": true,
"detectSponsoredPosts": true,
"downloadMedia": false,
"scrapeCommentsPerPost": 0,
"includeMediaMetadata": true,
"dedupe": true,
"maxItemsTotal": 500,
"proxyConfiguration": {
"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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://www.instagram.com/humansofny/"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
};
// Run the Actor and wait for it to finish
const run = await client.actor("scrapemint/instagram-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"urls": ["https://www.instagram.com/humansofny/"],
"proxyConfiguration": {
"useApifyProxy": True,
"apifyProxyGroups": ["RESIDENTIAL"],
},
}
# Run the Actor and wait for it to finish
run = client.actor("scrapemint/instagram-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/humansofny/"
],
"proxyConfiguration": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}' |
apify call scrapemint/instagram-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=scrapemint/instagram-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Instagram Influencer Analyzer & Sponsored Post Tracker",
"description": "Rank Instagram creators by real engagement rate. Flag sponsored posts and paid partnerships. Track brand mentions across posts, reels, comments, profiles, hashtags, places, and user search. For agencies, brand marketers, and ad intelligence teams. JSON. Pay per result.",
"version": "0.1",
"x-build-id": "r4hvaldoAYo4GvjzY"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrapemint~instagram-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrapemint-instagram-scraper",
"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/scrapemint~instagram-scraper/runs": {
"post": {
"operationId": "runs-sync-scrapemint-instagram-scraper",
"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/scrapemint~instagram-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrapemint-instagram-scraper",
"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",
"properties": {
"contentType": {
"title": "Content to scrape",
"enum": [
"posts",
"reels",
"comments",
"mentions",
"profile",
"hashtag",
"place",
"user-search"
],
"type": "string",
"description": "What kind of data you want. Each type expects a matching URL or search query.",
"default": "posts"
},
"urls": {
"title": "Instagram URLs",
"type": "array",
"description": "Instagram URLs to scrape. URLs take priority over search queries and cannot be combined. Use /p/ for posts, /reel/ for reels, /username/ for profiles, /explore/tags/ for hashtags, /explore/locations/ for places.",
"default": [],
"items": {
"type": "string"
}
},
"searchQueries": {
"title": "Search queries",
"type": "array",
"description": "Keywords to search (hashtags, users, or places depending on content type). Enter multiple terms as separate items. Ignored when URLs are provided.",
"default": [],
"items": {
"type": "string"
}
},
"resultsLimit": {
"title": "Results limit per URL",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Cap on results returned per URL or query. Controls cost and runtime.",
"default": 100
},
"filterByDate": {
"title": "Filter by date",
"type": "string",
"description": "Only return posts newer than this date. UTC, not local time. Format YYYY-MM-DD for absolute, or a relative like '7 days ago', '1 month ago'. Leave blank for no filter.",
"default": ""
},
"includeEngagementMetrics": {
"title": "Include engagement rate + posting cadence",
"type": "boolean",
"description": "On profile and hashtag runs, compute avg likes per post, avg comments per post, engagement rate as a percentage of followers, and posts per week. Built in. No extra cost.",
"default": true
},
"detectSponsoredPosts": {
"title": "Flag sponsored and paid partnership posts",
"type": "boolean",
"description": "Mark each post with isSponsored true or false based on #ad, #sponsored, #paidpartnership, Instagram's paid partnership label, and brand tag patterns. Built in. No extra cost.",
"default": true
},
"downloadMedia": {
"title": "Download images and videos",
"type": "boolean",
"description": "Save every image and video to the key value store and include a downloadUrl per post. Adds storage cost.",
"default": false
},
"scrapeCommentsPerPost": {
"title": "Also scrape top comments per post",
"minimum": 0,
"maximum": 200,
"type": "integer",
"description": "Pull the top N comments from each post or reel in the run. 0 disables. Only runs for posts and reels content types.",
"default": 0
},
"includeMediaMetadata": {
"title": "Include image dimensions, alt text, and location",
"type": "boolean",
"description": "Enrich each row with width, height, alt text (accessibility caption), and tagged location when available.",
"default": true
},
"dedupe": {
"title": "Deduplicate across runs",
"type": "boolean",
"description": "Skip post and profile IDs already pushed in previous runs. Turn off to refresh counts on the same items.",
"default": true
},
"maxItemsTotal": {
"title": "Max items per run",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Hard cap across all URLs and queries. Controls total cost.",
"default": 500
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify proxy. Residential strongly recommended. Instagram blocks datacenter IPs aggressively.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```