{ "openapi": "3.0.1", "info": { "title": "Instagram Related Person Scraper With Similar Audience Builder", "description": "Instagram Related Person Scraper finds related profiles connected to any public Instagram account. Capture usernames, bios, follower data, relevance signals, and metadata. Ideal for research, influencer discovery, audience mapping, and workflows needing structured related-profile insights.", "version": "0.1", "x-build-id": "QhpxMI66VUS0BBpa7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~instagram-related-person-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-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/api-empire~instagram-related-person-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-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/api-empire~instagram-related-person-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-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": { "seedProfiles": { "title": "🌱 Seed Profiles", "type": "array", "description": "Instagram profiles to grow a lookalike audience from. Each seed is the starting point of the graph walk. Supports mixed formats:\nβ€’ Full URL: https://www.instagram.com/username/\nβ€’ Handle: @username\nβ€’ Plain: username\n\nAdd several seeds to build a broader, cross-seed audience (accounts reached from more than one seed rank higher).", "items": { "type": "string" } }, "hopDepth": { "title": "πŸ•ΈοΈ Hop Depth (related-of-related)", "minimum": 1, "maximum": 3, "type": "integer", "description": "How many hops to expand outward. 1 = only the seed's direct related accounts. 2 = also fetch the related accounts of those (related-of-related). 3 = one more layer. Deeper = a much larger audience but many more requests.", "default": 2 }, "maxAudienceSize": { "title": "πŸ“Š Max Audience Size (total cap)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Hard cap on the total number of unique lookalike accounts collected across ALL hops and seeds. Stops the graph walk once reached. Recommended: 100–1000.", "default": 200 }, "minFrequency": { "title": "πŸ” Minimum Co-occurrence Frequency", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Only keep lookalike accounts reached by at least this many distinct paths. 1 = keep everything. 2+ = keep only accounts that multiple seeds/parents point at (a stronger, tighter lookalike core).", "default": 1 }, "concurrency": { "title": "⚑ Concurrent Fetches", "minimum": 1, "maximum": 8, "type": "integer", "description": "How many related-account fetches run in parallel per hop. Higher = faster but more likely to be rate-limited. Keep low for reliability.", "default": 3 }, "sessionId": { "title": "πŸ”‘ Instagram sessionId Cookie (optional)", "type": "string", "description": "Optional Instagram `sessionid` cookie value. Instagram login-walls the related/suggested-accounts endpoint when logged-out, so a fresh sessionid dramatically improves coverage. Paste the raw sessionid cookie from a logged-in browser (format `123456789%3A....`). Leave empty to try logged-out first." }, "proxyConfiguration": { "title": "πŸ”’ Proxy & Anti-Block", "type": "object", "description": "Enable Apify Proxy for reliable scraping. Residential proxies reduce blocks and rate limits. Strongly recommended for consistent results." } } }, "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 } } } } } } } } } }