{ "openapi": "3.0.1", "info": { "title": "Instagram Related Profiles Scraper — Similar Accounts & Leads", "description": "Turn one Instagram handle into a qualified list of the accounts around it. Reads Instagram's own Suggested for You graph, fetches each discovered account's full profile, and returns email, phone, website, category and followers. Filter by contact details, category or follower band. No login needed.", "version": "0.1", "x-build-id": "a5BgiByFFhQr1SQiU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/toolzerhub~instagram-related-profiles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-toolzerhub-instagram-related-profiles-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/toolzerhub~instagram-related-profiles-scraper/runs": { "post": { "operationId": "runs-sync-toolzerhub-instagram-related-profiles-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/toolzerhub~instagram-related-profiles-scraper/run-sync": { "post": { "operationId": "run-sync-toolzerhub-instagram-related-profiles-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": "Accounts", "type": "array", "description": "Instagram accounts to pull the list from", "items": { "type": "string" } }, "searchDepth": { "title": "Search Depth", "enum": [ "1", "2" ], "type": "string", "description": "How far to follow Instagram's suggestions. 1 stays on the accounts suggested for the handles you entered. 2 also asks about each account it found, which turns a shortlist into a whole niche and costs proportionally more.", "default": "1" }, "maxProfiles": { "title": "Max Profiles To Analyze", "minimum": 0, "type": "integer", "description": "Hard ceiling on how many accounts this run will analyze, and therefore what it can cost — every analyzed account is one billed event. 0 means no ceiling. A budget of $8 is roughly 1000 profiles.", "default": 200 }, "maxPerLevel": { "title": "Per-Level Cap", "minimum": 1, "type": "integer", "description": "How many accounts to keep from each account asked about, and carry into the next level. Only used at Search Depth 2.", "default": 10 }, "minFollowers": { "title": "Minimum Followers", "minimum": 0, "type": "integer", "description": "Drop accounts below this follower count. 0 disables it.", "default": 0 }, "maxFollowers": { "title": "Maximum Followers", "minimum": 0, "type": "integer", "description": "Drop accounts above this follower count. 0 disables it. A narrow band is the quickest way to an empty run — widen it before assuming something is broken.", "default": 0 }, "requireContact": { "title": "Require Contact Details", "enum": [ "any", "email", "phone", "email_or_phone", "website" ], "type": "string", "description": "Keep only accounts that publish a way to reach them. Checked against what the account actually exposes, so it is independent of which columns you keep.", "default": "any" }, "accountType": { "title": "Account Type", "enum": [ "any", "business", "personal" ], "type": "string", "description": "Business accounts carry a category and often a contact button; personal ones do not. Most outreach lists want business, influencer discovery usually wants personal.", "default": "any" }, "businessCategory": { "title": "Business Category", "type": "string", "description": "Keep only accounts whose Instagram business category matches this exactly — for example Photographer, Restaurant, Beauty Salon, Public Figure. Leave empty to skip.", "default": "" }, "keywords": { "title": "Keyword Filter", "type": "array", "description": "Keep only accounts whose text contains one of these terms. Case-insensitive, and any one match is enough. Leave empty to skip.", "default": [], "items": { "type": "string" } }, "keywordSearchIn": { "title": "Search Keywords In", "enum": [ "bio_or_name", "bio", "name", "category" ], "type": "string", "description": "Which part of the account the keyword filter reads.", "default": "bio_or_name" }, "hasWebsite": { "title": "Has A Website", "type": "boolean", "description": "Keep only accounts with a link in their bio — usually the sign of a brand or a creator running their own funnel.", "default": false }, "verifiedOnly": { "title": "Verified Only", "type": "boolean", "description": "Keep only accounts carrying the blue badge. This excludes the large majority of accounts.", "default": false }, "skipPrivate": { "title": "Skip Private", "type": "boolean", "description": "Drop private accounts.", "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 } } }, "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 } } } } } } } } } }