{ "openapi": "3.0.1", "info": { "title": "Instagram Story Details Scraper With Highlights", "description": "Scrape Instagram Stories and Highlights to extract story details, media, captions, timestamps, usernames, engagement data, and highlight information. Ideal for competitor research, influencer monitoring, content analysis, audience insights, and Instagram marketing analytics.", "version": "0.1", "x-build-id": "tUUDofiW5Lx17NfgA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapier~instagram-story-details-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapier-instagram-story-details-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/scrapier~instagram-story-details-scraper/runs": { "post": { "operationId": "runs-sync-scrapier-instagram-story-details-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/scrapier~instagram-story-details-scraper/run-sync": { "post": { "operationId": "run-sync-scrapier-instagram-story-details-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": [ "urls" ], "properties": { "urls": { "title": "📇🔗 Instagram profiles to scan", "type": "array", "description": "One list, many profiles — paste full profile links or plain usernames (with or without @). Examples: `https://www.instagram.com/kyliejenner/` or just `kyliejenner`. Add more than one to batch a run across live stories and highlights alike.", "items": { "type": "string" } }, "sessionId": { "title": "🔓 Instagram session (optional — unlocks live 24h stories)", "type": "string", "description": "Your logged-in `sessionid` cookie from instagram.com. Highlight reels can be read without it, but the live (<=24h) story tray needs a session — leave blank to collect highlights only. Treat it like a password; don't share or commit it.", "default": "" }, "sessionid": { "title": "🔓 Instagram session (legacy alias)", "type": "string", "description": "Legacy alias for `sessionId`, accepted for backward compatibility with older input JSON. Prefer `sessionId` above; leave blank if you already filled that field.", "default": "" }, "includeLiveStories": { "title": "⏱️ Also include live (<=24h) stories", "type": "boolean", "description": "When on and a session is provided, the actor also collects the profile's current live story tray (the base behavior). Turn off to collect Highlights only. Default true.", "default": true }, "maxHighlights": { "title": "🔢 Max highlight trays per profile (0 = all)", "minimum": 0, "type": "integer", "description": "Caps how many of a profile's highlight trays are opened, in tray order. 0 collects every tray found. Example: maxHighlights=3 opens only the first 3 highlight trays per profile. Default 0.", "default": 0 }, "highlightTitleFilter": { "title": "🏷️ Only these highlight titles (optional)", "type": "string", "description": "Comma-separated text to match against highlight tray titles (case-insensitive, partial match). Example: `Travel, FAQ` only opens trays whose title contains \"travel\" or \"faq\". Leave blank to include every tray.", "default": "" }, "proxyConfiguration": { "title": "🌍🛡️ Proxy settings", "type": "object", "description": "Apify Proxy configuration for this run. Honored by every request the actor makes — leave defaults on for the most stable runs, or turn off for direct connections." } } }, "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 } } } } } } } } } }