{ "openapi": "3.0.1", "info": { "title": "Instagram Stories & Highlights Scraper · Download · No Login", "description": "Instagram Stories & Highlights Scraper — pull active stories and permanent highlights from any public account. Image & video URLs, media type, timestamps, music, and highlight titles. Optional permanent file download. No login, no cookies. Stories, highlights, or both. JSON/CSV/Excel.", "version": "1.0", "x-build-id": "77xGJcNgLx3CHF2KS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~instagram-stories-highlights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-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/memo23~instagram-stories-highlights-scraper/runs": { "post": { "operationId": "runs-sync-memo23-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/memo23~instagram-stories-highlights-scraper/run-sync": { "post": { "operationId": "run-sync-memo23-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 accounts whose active stories and/or highlights you want to scrape. Accepts plain handles (nytimes), @-handles (@nytimes), or profile URLs (https://www.instagram.com/nytimes) — one per line, mixed formats are fine. Private accounts return an error item explaining why. Note that stories expire after 24 hours, so an account that has not posted recently returns no story rows; news accounts post around the clock and are a safe first test. Example: [\"nytimes\", \"https://www.instagram.com/cnn\"].", "items": { "type": "string" } }, "dataToScrape": { "title": "Data to scrape", "enum": [ "stories", "highlights", "both" ], "type": "string", "description": "Which to collect for each account: Stories (active 24h stories), Highlights (permanent highlight trays), or both.", "default": "stories" }, "maxHighlightsPerUser": { "title": "Max highlight trays per user", "minimum": 1, "type": "integer", "description": "Cap how many highlight trays to expand per account (each tray still returns all its items). Leave empty for all trays. Ignored for stories." }, "downloadMedia": { "title": "Download media files", "type": "boolean", "description": "Also download each image/video and save it permanently to storage, returning a non-expiring downloadUrl per item. Instagram's own media URLs expire after a few hours — enable this to keep the files. Adds run time and a small per-file charge. Default: off.", "default": false }, "includeHistorical": { "title": "Include historical (archived) stories", "type": "boolean", "description": "Also return stories and highlight items captured on earlier runs that a live scrape can no longer see — expired or deleted stories. Each historical row is tagged source:\"archive\" with firstSeenAt/lastSeenAt. Paying accounts only. Off by default. Example: enable to pull a creator's expired stories from the archive alongside what's live right now.", "default": false } } }, "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 } } } } } } } } } }