{ "openapi": "3.0.1", "info": { "title": "Instagram Related Person Scraper With Profile Enrichment", "description": "Instagram Related Person Scraper finds and extracts profiles related to any public Instagram user, capturing usernames, bios, follower counts, profile URLs, and relevance connections. Ideal for influencer discovery, audience analysis, competitor research, and automated Instagram network insights.", "version": "0.1", "x-build-id": "c6ToMhJUHSCZULAY3" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~instagram-related-person-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-instagram-related-person-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/simpleapi~instagram-related-person-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-instagram-related-person-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/simpleapi~instagram-related-person-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-instagram-related-person-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": { "profileUrls": { "title": "🎯 Seed Profiles", "type": "array", "description": "Instagram profiles to pull related / suggested accounts from. Accepts full URLs, @handles, or plain usernames — mix freely (e.g. https://www.instagram.com/ishowspeed/, @ishowspeed, ishowspeed). Backward compatible: the base `urls` key still works.", "items": { "type": "string" } }, "maxRelated": { "title": "🔢 Max Related per Seed", "minimum": 0, "maximum": 10000, "type": "integer", "description": "How many related profiles to collect (and enrich) per seed profile. Backward compatible: the base `max_profiles` key still works.", "default": 50 }, "enrichProfiles": { "title": "✨ Enrich Each Related Profile", "type": "boolean", "description": "When ON, each related profile gets an extra fetch to add followersCount, biography, isVerified, isPrivate and externalUrl. Turn OFF for a faster, discovery-only run.", "default": true }, "minFollowers": { "title": "📉 Minimum Followers", "minimum": 0, "type": "integer", "description": "Keep only enriched profiles with at least this many followers. 0 = keep all (profiles whose follower count is unknown are dropped only when this is above 0).", "default": 0 }, "sortBy": { "title": "↕️ Sort Enriched Profiles By", "enum": [ "followers", "username" ], "type": "string", "description": "Order of the enrichedProfiles list.", "default": "followers" }, "sessionId": { "title": "🔐 Instagram sessionId (optional)", "type": "string", "description": "Optional Instagram `sessionid` cookie. Instagram login-walls the related/enrichment endpoints when logged out; supply a fresh sessionid to unlock real data. Leave empty to try logged-out first. Never share this — it is your login token." }, "proxyConfiguration": { "title": "🔒 Proxy & Anti-Block", "type": "object", "description": "Enable Apify Proxy. Residential proxies reduce blocks and rate limits. Strongly recommended." } } }, "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 } } } } } } } } } }