{ "openapi": "3.0.1", "info": { "title": "Instagram Profile Scraper With Bio Link & Email Extraction", "description": "Scrapes full data from any public Instagram profile, capturing bio, username, follower and following counts, posts, Reels, highlights, profile image, engagement stats, and URLs. Ideal for influencer research, competitor analysis, brand insights, and large-scale Instagram profiling", "version": "0.1", "x-build-id": "aCa3VhPNHkbJullrY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~instagram-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-instagram-profile-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/scrapio~instagram-profile-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-instagram-profile-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/scrapio~instagram-profile-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-instagram-profile-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": { "profileTargets": { "title": "📇 Profiles to mine for contacts", "type": "array", "description": "📥 **Instagram profiles whose bio + external link you want contact data from.**\n\nAccepts any of:\n• 🌐 Full URL: `https://www.instagram.com/username/`\n• 👤 Username only: `username`\n• 🔗 `instagram.com/username` or `@username`\n\nExamples: `natgeo`, `https://www.instagram.com/gymshark/`\n\n💡 Backward-compatible: a legacy `startUrls` array is still accepted if you supply it instead.", "items": { "type": "string" } }, "expandLinks": { "title": "🔗 Expand link-aggregators (Linktree / Beacons / …)", "type": "boolean", "description": "🔗 **When ON, if a profile's external link is a link-aggregator** (linktr.ee, beacons.ai, linkin.bio, campsite.bio, msha.ke, taplink, allmylinks, …) **the actor fetches that page and returns its destination links** in `expandedLinks`.\n\nThe aggregator page is a normal website (not Instagram), so this fetch is independent of Instagram's login-wall. If the fetch is blocked, `expandedLinks` is emitted as `null` — never fabricated.", "default": true }, "includeAboutSection": { "title": "📅 Include account About info", "type": "boolean", "description": "🔍 When enabled, also emits the account's join date and country (from Instagram's response), in addition to the contact fields.", "default": false }, "sessionId": { "title": "🔑 Instagram sessionid cookie (optional — not required)", "type": "string", "description": "🔑 **Optional. Leave this empty unless you need the extra fields below.**\n\nWithout a session the Actor reads Instagram's public server-rendered profile page and returns: `username`, `fullName`, `biography`, `externalUrl` + `externalUrls` (link-in-bio), `followersCount`, `followsCount`, `postsCount`, `verified`, `private`, `profilePicUrl`, `highlightReelCount` — plus all the contact fields (`emails`, `phoneNumbers`, `socialHandles`, `expandedLinks`).\n\n➕ Adding a valid `sessionid` cookie (format `:xxxxx…`) additionally fills these, which are **null** when logged out: `isBusinessAccount`, `businessCategoryName`, `hasChannel`, `joinedRecently`, `igtvVideoCount`, `profilePicUrlHD`, `latestPosts`, `latestIgtvVideos`, `relatedProfiles`.\n\nEvery row reports `dataSource` (`public-html` / `authenticated-graphql`) and `partialData` so you always know which you got.\n\n⚠️ Treat a session cookie as a secret." }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "⚙️ Proxy configuration. Defaults to residential proxy with automatic retries for reliability; supply your own Apify proxy groups or custom proxy URLs here to use them instead." } } }, "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 } } } } } } } } } }