{ "openapi": "3.0.1", "info": { "title": "Instagram Stories & Highlights Scraper", "description": "Scrape public Instagram story highlights and the live 24-hour story tray for one or more usernames. Returns one record per story item with original media URLs, timestamps, captions, music, mentions and links as structured JSON. No login required for highlights.", "version": "0.1", "x-build-id": "mgb8yXLvdbw8neAMi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~instagram-stories-highlights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-instagram-stories-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/khadinakbar~instagram-stories-highlights-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-instagram-stories-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/khadinakbar~instagram-stories-highlights-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-instagram-stories-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", "required": [ "usernames" ], "properties": { "usernames": { "title": "Instagram usernames", "type": "array", "description": "Public Instagram usernames, profile URLs, or numeric user IDs to scan, for example 'instagram', 'https://www.instagram.com/natgeo/', or '25025320'. Entries are deduplicated and @ prefixes are stripped. NOT for private accounts, hashtags, post URLs, or story viewer lists.", "items": { "type": "string" } }, "includeStories": { "title": "Include live stories (24h tray)", "type": "boolean", "description": "Attempt to capture the ephemeral 24-hour story tray anonymously. Instagram increasingly requires a login for this route, so tray capture is best-effort and never charged when blocked; provide sessionCookie to improve it. Defaults to true. NOT a guarantee that every tray is readable without login.", "default": true }, "includeHighlights": { "title": "Include story highlights", "type": "boolean", "description": "List the permanent story highlight reels shown on each public profile and expand their items via managed data providers, with no login and no cookies. Defaults to true. NOT for private profiles or hidden story archives.", "default": true }, "expandHighlightItems": { "title": "Expand highlight items", "type": "boolean", "description": "Fetch the individual story items inside each highlight reel so every item becomes a record with its own media URL and timestamp. Defaults to true; when false, only one summary row per highlight album is saved. NOT related to downloading media files.", "default": true }, "maxHighlightsPerUser": { "title": "Max highlights per user", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum number of highlight reels expanded per username in one run, for example 10. Accepts 1 to 25; the default is 10, which bounds provider cost while covering most public profiles. NOT a limit on items inside each highlight.", "default": 10 }, "maxResults": { "title": "Maximum story items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of validated story or highlight item rows saved across the whole run, for example 200. Accepts 1 to 2000; the default is 200, and the actor stops and never charges for more rows than this cap. NOT a per-username limit.", "default": 200 }, "sessionCookie": { "title": "Instagram session cookie (optional)", "type": "string", "description": "Optional 'sessionid' value from your own logged-in Instagram browser session to make live 24-hour story tray reads reliable. Leave empty for provider-backed highlights only; the cookie is treated as a secret and used only for your run. NOT the place for usernames, passwords, or API keys." } } }, "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 } } } } } } } } } }