{ "openapi": "3.0.1", "info": { "title": "Instagram Scraper - Posts, Reels, Profiles & Followers", "description": "Scrape public Instagram in 14 modes: profile posts, Reels and tagged posts, profiles with bio and business contacts, comments and replies, followers, following, post likers, hashtag, location and audio feeds, search, stories and highlights. Flat JSON, no login or cookies needed.", "version": "0.1", "x-build-id": "sZfBy1PHZabSb1skJ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/clover_folktale~instagram-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-clover_folktale-instagram-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/clover_folktale~instagram-scraper/runs": { "post": { "operationId": "runs-sync-clover_folktale-instagram-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/clover_folktale~instagram-scraper/run-sync": { "post": { "operationId": "run-sync-clover_folktale-instagram-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "userPosts", "profiles", "userReels", "comments", "hashtagPosts", "postDetails", "search", "followers", "taggedPosts", "locationPosts", "stories", "similarAccounts", "postLikers", "audioPosts" ], "type": "string", "description": "What to scrape. Each mode reads the list field named in its title below.", "default": "userPosts" }, "usernames": { "title": "Usernames (modes: userPosts, profiles, userReels, followers, taggedPosts, stories, similarAccounts)", "type": "array", "description": "Profiles as nasa, @nasa or a link (https://www.instagram.com/nasa/). Falls back to \"nasa\" when empty.", "items": { "type": "string" } }, "postUrls": { "title": "Posts (modes: comments, postDetails, postLikers)", "type": "array", "description": "Post or Reel links (https://www.instagram.com/p/DeTUk4sDSp-/) or shortcodes. Falls back to a sample post when empty.", "items": { "type": "string" } }, "hashtags": { "title": "Hashtags (mode: hashtagPosts)", "type": "array", "description": "Hashtags as nasa, #nasa or a link (https://www.instagram.com/explore/tags/nasa/). Falls back to \"nasa\" when empty.", "items": { "type": "string" } }, "keywords": { "title": "Keywords (mode: search)", "type": "array", "description": "Search keywords; each keyword is a separate search. Falls back to \"travel\" when empty.", "items": { "type": "string" } }, "locations": { "title": "Locations (mode: locationPosts)", "type": "array", "description": "Location IDs (115963528414384) or links such as https://www.instagram.com/explore/locations/115963528414384/houston-texas/. Find IDs with search type locations. Falls back to a sample location when empty.", "items": { "type": "string" } }, "audios": { "title": "Audios (mode: audioPosts)", "type": "array", "description": "Audio page IDs (18294184831034406) or links such as https://www.instagram.com/reels/audio/18294184831034406/. Falls back to a sample audio when empty.", "items": { "type": "string" } }, "followType": { "title": "List (mode: followers)", "enum": [ "followers", "following" ], "type": "string", "description": "Whether to list the accounts that follow the profile or the accounts it follows.", "default": "followers" }, "searchType": { "title": "Search for (mode: search)", "enum": [ "users", "posts", "reels", "hashtags", "locations", "audio" ], "type": "string", "description": "What the keyword searches: accounts, posts, Reels, hashtags, locations or audios.", "default": "users" }, "storyType": { "title": "Stories (mode: stories)", "enum": [ "stories", "highlights", "highlightStories" ], "type": "string", "description": "Current stories, the list of highlight reels, or the stories inside each highlight reel (reels with a single story are skipped).", "default": "stories" }, "hashtagFeed": { "title": "Feed (mode: hashtagPosts)", "enum": [ "top", "recent", "reels" ], "type": "string", "description": "Top posts, latest posts or Reels only.", "default": "top" }, "commentSort": { "title": "Sort (mode: comments)", "enum": [ "recent", "popular" ], "type": "string", "description": "Newest or most popular comments first.", "default": "recent" }, "includeReplies": { "title": "Include replies (mode: comments)", "type": "boolean", "description": "Also fetch the replies of comments that have two or more. Replies count toward maxResults.", "default": false }, "maxResults": { "title": "Max results per input", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum items for each username, post, hashtag, location, audio or keyword (up to 5000). Ignored by modes profiles and postDetails, which return one record per input. You are charged $0.0023 per item ($0.0007 per account in followers, postLikers and similarAccounts), plus a $0.0025 start fee for each input (not in profiles and postDetails, which have one start fee per run).", "default": 20 } } }, "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 } } } } } } } } } }