{
"openapi": "3.0.1",
"info": {
"title": "Instagram Scraper",
"description": "One Instagram scraper for everything — profiles, contacts (emails & phones), posts, reels, comments, likers, followers, following, tagged, stories, highlights, hashtags, locations & search. No code: paste usernames or URLs, export to Excel, CSV, JSON or API. Public data needs no login.",
"version": "3.1",
"x-build-id": "bxgDojtYxY2xIAOqy"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/vortex_data~instagram-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-vortex_data-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/vortex_data~instagram-scraper/runs": {
"post": {
"operationId": "runs-sync-vortex_data-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/vortex_data~instagram-scraper/run-sync": {
"post": {
"operationId": "run-sync-vortex_data-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",
"properties": {
"resultsType": {
"title": "What do you want to scrape?",
"enum": [
"details",
"contacts",
"posts",
"reels",
"postDetail",
"comments",
"likes",
"followers",
"following",
"tagged",
"stories",
"highlights",
"hashtag",
"location",
"search"
],
"type": "string",
"description": "Choose what to scrape. Each line you paste below is read for this mode.
🔑 Modes with a key need your Instagram login cookie (see the 🔑 section below).",
"default": "posts"
},
"directUrls": {
"title": "Instagram URLs or usernames",
"maxItems": 1000,
"type": "array",
"description": "Paste one item per line:- Profile modes: a username,
@username or instagram.com/username/. A post URL works too: you get its author. - Post / Reel detail, Comments, Likers: a post or reel URL. Comments and Likers also accept a username: you get the comments or likers of that account's recent posts.
- Hashtag posts:
#tag, tag or instagram.com/explore/tags/tag/. - Location posts: a location ID or
instagram.com/explore/locations/ID/. - Search: leave empty and use the 🔎 Search section.
Lines that don't fit the mode are skipped, and the log says why.",
"items": {
"type": "string"
}
},
"resultsLimit": {
"title": "Results per input",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Enter how many results to get from each line. For example, 50 with 3 usernames gives up to 150 posts.
When you paste a username into Comments or Likers, the number is spread over the account's recent posts. Instagram shows at most about 100 likers per post.",
"default": 100
},
"search": {
"title": "Search phrase",
"type": "string",
"description": "Enter a word or name to search for on Instagram, for example bakery. Profile search matches account names and usernames, not the bio. Use one phrase per run."
},
"searchType": {
"title": "Search for",
"enum": [
"hashtag",
"profile",
"place"
],
"type": "string",
"description": "Choose what the search should find.",
"default": "hashtag"
},
"searchLimit": {
"title": "Search matches",
"minimum": 1,
"maximum": 50,
"type": "integer",
"description": "Enter how many search matches to scrape.",
"default": 10
},
"sessionCookies": {
"title": "Instagram login cookie",
"type": "string",
"description": "Paste the cookies of your logged-in Instagram session. Export them with the Cookie-Editor or EditThisCookie browser extension, or copy the Cookie header from your browser. The export must contain sessionid.
Use only your own account and never share your cookie: it gives access to your account. How to get your cookie"
},
"proxyCountry": {
"title": "Country you use Instagram from",
"enum": [
"",
"US",
"GB",
"DE",
"FR",
"ES",
"IT",
"NL",
"PL",
"SE",
"UA",
"TR",
"CA",
"BR",
"MX",
"AR",
"AU",
"IN",
"ID",
"JP",
"KR",
"AE",
"SA",
"ZA",
"CZ",
"PT",
"RO",
"VN",
"PH",
"TH",
"NG",
"EG",
"CO"
],
"type": "string",
"description": "Choose the country where you usually use Instagram. If your account is suddenly used from another country, Instagram may challenge the login and ask you to verify it. Leave Automatic if you don't use a cookie.",
"default": ""
},
"onlyPostsNewerThan": {
"title": "Only newer than",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^\\d+\\s*(minute|hour|day|week|month|year)s?$",
"type": "string",
"description": "Enter a date (2026-01-15) or a period (3 months) to keep only newer items. Works for posts, reels, tagged posts, hashtag and location posts, stories and highlights."
},
"onlyPostsOlderThan": {
"title": "Only older than",
"pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])(T[0-2]\\d:[0-5]\\d(:[0-5]\\d)?(\\.\\d+)?Z?)?$|^\\d+\\s*(minute|hour|day|week|month|year)s?$",
"type": "string",
"description": "Enter a date (2026-03-31) or a period (1 week) to keep only older items. Combine with Only newer than for a date range."
},
"addParentData": {
"title": "Add source info",
"type": "boolean",
"description": "Turn on to add columns saying where each row came from: dataSource and the source profile, hashtag, place, post or highlight. Every row already has inputUrl, the line it came from.",
"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
},
"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
}
}
}
}
}
}
}
}
}
}