{ "openapi": "3.0.1", "info": { "title": "Instagram Profile Posts Scraper — Post History by Profile", "description": "The posts of public Instagram profiles — photos, carousels, reels — newest first, page by page: caption, hashtags, mentions, kind, image, approximate time. On request each post's likes, comments, exact time, tagged accounts, carousel items and topics. Only-new mode. No login, no cookies.", "version": "0.1", "x-build-id": "AGGeINKlunSmOTg2h" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/foxlabs~instagram-profile-posts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-foxlabs-instagram-profile-posts-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/foxlabs~instagram-profile-posts-scraper/runs": { "post": { "operationId": "runs-sync-foxlabs-instagram-profile-posts-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/foxlabs~instagram-profile-posts-scraper/run-sync": { "post": { "operationId": "run-sync-foxlabs-instagram-profile-posts-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": [ "profiles" ], "properties": { "profiles": { "title": "Profiles", "type": "array", "description": "One profile per line: a user name (natgeo), an @name (@natgeo) or a profile address (https://www.instagram.com/natgeo/). The three forms can be mixed; a profile written twice is read once. Only public profiles can be read.", "items": { "type": "string" } }, "maxPostsPerProfile": { "title": "Maximum posts per profile", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many posts to deliver for each profile, from the top of its list: the posts its owner pinned come first, then the newest. The list is read 12 posts a request, as far as Instagram shows it: use a large number for a whole archive.", "default": 100 }, "maxPosts": { "title": "Maximum posts in total", "minimum": 1, "maximum": 1000000, "type": "integer", "description": "The run stops when this many rows have been delivered. You are charged only for delivered rows.", "default": 100000 }, "postTypes": { "title": "Kinds of post (optional)", "type": "array", "description": "Leave empty for every kind. Choose one or two to get only those: a post of another kind is skipped before anything more is read for it, and is not charged.", "items": { "type": "string", "enum": [ "photo", "carousel", "video" ], "enumTitles": [ "Photos", "Carousels (several photos or videos in one post)", "Videos and reels" ] } }, "includeDetails": { "title": "Read each post's details", "type": "boolean", "description": "Off: rows come from the profile's list alone — caption, kind, image, author and two approximate times (the moment the post's ID was made, and the day Instagram's image description names). The list carries NO like count, NO comment count and no exact time. On: one more request per post adds like and comment counts, the exact time, location, co-authors, tagged accounts, the items of a carousel, topics, and for a video its length, file address and music. Slower, and charged as a different event.", "default": false }, "onlyNewPosts": { "title": "Only posts not delivered before", "type": "boolean", "description": "Remember delivered posts under the list name below and skip them in later runs. Schedule the same profiles daily and each run brings only the posts it has not delivered before. With this on, \"Maximum posts per profile\" is how far down each profile the Actor looks: of the first 100 (or whatever you set) it delivers the ones it has not delivered before, and it does not go further back.", "default": false }, "listName": { "title": "List name", "pattern": "^[A-Za-z0-9]([A-Za-z0-9-]{0,38}[A-Za-z0-9])?$", "type": "string", "description": "Name of the memory used by \"Only posts not delivered before\" (looked at only when that is on). Use a different name for each project. Letters, digits and hyphens (a hyphen not first or last), up to 40 characters; capitals are read as lower case.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Nothing to change for normal use: requests leave from the run's own address, and the Actor moves to Apify Proxy by itself if Instagram turns that address away. Turn a proxy on here to send every request through it: the run then stays on that proxy, and a setting the platform refuses ends the run with a message before anything is read.", "default": { "useApifyProxy": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }