{ "openapi": "3.0.1", "info": { "title": "Instagram Highlights Scraper With Profile Analytics", "description": "Instagram Highlights Scraper collects data from Instagram Highlights, capturing highlight titles, story URLs, timestamps, media types, and metadata. Ideal for analytics, content archiving, monitoring brand activity, or automating Instagram research with clean, structured output", "version": "0.1", "x-build-id": "MhbMtG2a1AqWEmxGR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~instagram-highlights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-instagram-highlights-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/simpleapi~instagram-highlights-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-instagram-highlights-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/simpleapi~instagram-highlights-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-instagram-highlights-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": { "targetProfiles": { "title": "📥 Target Instagram Profiles (URLs / Usernames)", "type": "array", "description": "🔗 Add one or more targets — each line is one profile. Accepted: full profile URL (https://www.instagram.com/username), username (username or @username), or highlight shortcode (ABC123DEF45). Each profile's highlights are scraped and rolled up into a per-profile analytics summary + a final cross-profile leaderboard. Also accepts the base actor's 'startUrls' key as a fallback.", "items": { "type": "string" } }, "maxHighlightsPerProfile": { "title": "📄 Max Highlights Per Profile", "minimum": 0, "type": "integer", "description": "Cap on how many highlights to fetch per profile, across ALL pages of the tray. 0 = unlimited (fetch every page until Instagram reports no more highlights).", "default": 0 }, "archiveCoverImages": { "title": "🖼️ Archive Full-Resolution Covers to Key-Value Store", "type": "boolean", "description": "When enabled, the actor resolves each highlight's genuinely full-resolution cover photo (via Instagram's reels_media endpoint, matched to the tray thumbnail by CDN asset ID) and downloads a permanent copy into this run's Key-Value Store, so the cover survives after Instagram's CDN link (`oe=` timestamp) expires.", "default": true }, "proxySettings": { "title": "🛡️ Proxy Settings", "type": "object", "description": "Choose which proxies to use. Strategy: start with your selection (e.g. no proxy or Apify proxy). On HTTP 429 or 403 (platform block), the actor fails fast and falls back: first to datacenter, then to residential (sticky for the rest of the run). Also accepts the base actor's 'proxyConfiguration' key as a fallback." }, "enableProfileSummary": { "title": "🧮 Enable Per-Profile Analytics Summary", "type": "boolean", "description": "When ON (default), the actor pushes one extra, uncharged summary row per profile: total highlight count, the full highlight title list, first/last highlight ID, and the profile's success rate — so you get profile-level analytics without manually aggregating the per-highlight rows.", "default": true }, "enableLeaderboard": { "title": "🏆 Enable Cross-Profile Leaderboard", "type": "boolean", "description": "When ON (default), after every profile in the run finishes, the actor pushes one uncharged leaderboard row per profile — ranked highest-to-lowest by highlight count — for batch competitor/influencer comparison across the whole target list.", "default": true } } }, "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 } } } } } } } } } }