{ "openapi": "3.0.1", "info": { "title": "Instagram Stories Scraper — Instagram Highlights, No Start Fee", "description": "Instagram stories for any public account: media links, mentions, hashtags, link and poll sticker types, and when each story expires. No login. Saved highlight albums too if you ask for them, at $0.012 per album. From $8.00 per 1,000 story checks, no start fee. An empty account is never charged.", "version": "1.0", "x-build-id": "2f9UOj5JSIgufAOvL" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/steadyfetch~instagram-stories-highlights-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-steadyfetch-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/steadyfetch~instagram-stories-highlights-scraper/runs": { "post": { "operationId": "runs-sync-steadyfetch-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/steadyfetch~instagram-stories-highlights-scraper/run-sync": { "post": { "operationId": "run-sync-steadyfetch-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 accounts", "type": "array", "description": "Instagram account names, one per line — \"nasa\", \"@nasa\", https://www.instagram.com/nasa/ or https://www.instagram.com/stories/nasa/ all work. An account showing nothing, a private account and a handle that does not exist are never charged. A hashtag or a reel link is refused with a row naming the actor that does take it. Leave it empty and the run returns built-in sample rows instead of reading anything, so you can see the output shape at no result fee.", "default": [ "_demo" ], "items": { "type": "string" } }, "includeStories": { "title": "Active stories", "type": "boolean", "description": "ON (default): read the stories the account is showing right now. One charge per account whose stories question was answered, covering every story it is showing. An account showing nothing is answered honestly and is not charged.", "default": true }, "includeHighlights": { "title": "Highlights", "type": "boolean", "description": "OFF (default): also read the saved highlight albums on the account's profile and return every item inside them. Charged per album delivered, at one flat price whatever your Apify plan is, covering every item in that album. An account with no albums is answered honestly and is not charged.", "default": false }, "maxProfiles": { "title": "Max accounts", "minimum": 1, "type": "integer", "description": "Hard cap on how many accounts this run reads, counted from the top of your list. Accounts past it are never read and never charged, and the run summary says how many were left. This is the ceiling on what one run can cost you: an account is charged only if it had something to give, so the bill is at most this many charges and usually fewer. This actor reads at most 1,000 accounts in one run: ask for more and the run continues at 1,000, with one uncharged row saying so.", "default": 10 }, "maxHighlightsPerProfile": { "title": "Max highlight albums per account", "minimum": 1, "type": "integer", "description": "Hard cap on how many of one account's highlight albums are collected, newest tray order first. Only used when \"Highlights\" is on. Each album delivered is one charge, so this is also the most one account can cost you. This actor collects at most 50 albums from one account: ask for more and the run continues at 50, with one uncharged row saying so.", "default": 10 }, "maxRunSeconds": { "title": "Max run seconds", "type": "integer", "description": "The run stops cleanly before this many seconds and reports what is left, instead of being killed by a timeout. A time limit ends the reading, never the delivering: rows already in hand are always written out. One run lasts at most 3,600 seconds and needs at least 30: ask outside that and the run continues at the nearest of the two, with one uncharged row saying so.", "default": 600 } } }, "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 } } } } } } } } } }