{ "openapi": "3.0.1", "info": { "title": "Instagram Related Profiles Crawler (Discovery Scraper)", "description": "Discover Instagram creator networks recursively. Start with seed accounts and automatically explore related profiles using BFS to uncover hundreds of creators. Tracks discovery paths, filters by followers, and respects your budget. Perfect for influencer discovery and competitive analysis.", "version": "0.0", "x-build-id": "nKrKqcAdinNqt9RYC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/elliotpadfield~instagram-related-profiles/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-elliotpadfield-instagram-related-profiles", "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/elliotpadfield~instagram-related-profiles/runs": { "post": { "operationId": "runs-sync-elliotpadfield-instagram-related-profiles", "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/elliotpadfield~instagram-related-profiles/run-sync": { "post": { "operationId": "run-sync-elliotpadfield-instagram-related-profiles", "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": [ "seedUsernames", "proxyConfiguration" ], "properties": { "seedUsernames": { "title": "Seed Usernames", "uniqueItems": true, "type": "array", "description": "Instagram usernames to start from. Use creator, brand, or competitor accounts whose nearby network you want to explore.", "items": { "type": "string" } }, "maxProfiles": { "title": "Maximum Profiles", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of profiles to process. Keep this small for tests, then increase once the seed and filters look right.", "default": 10 }, "maxDepth": { "title": "Maximum Crawl Depth", "minimum": 0, "maximum": 10, "type": "integer", "description": "How many hops away from the seed profiles to crawl. 0 = only seeds, 1 = seeds plus directly related profiles, 2 = one more related-profile layer.", "default": 1 }, "minFollowers": { "title": "Minimum Followers", "minimum": 0, "type": "integer", "description": "Only save successful profiles with at least this many followers. Use 0 to include every public profile found.", "default": 0 }, "skipPrivateProfiles": { "title": "Skip Private Profiles", "type": "boolean", "description": "Skip private profiles instead of saving private-profile errors to the dataset.", "default": true }, "onlyPostsNewerThan": { "title": "Only Include Posts Newer Than", "type": "string", "description": "Optional post date filter. Accepts relative values like '30 days' or '6 months', or a date like '2026-01-01'. This filters posts inside each profile, not which profiles are crawled." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Required for Instagram crawling. Residential Apify Proxy is recommended for better reliability." }, "delayBetweenRequests": { "title": "Delay Between Requests", "minimum": 500, "maximum": 30000, "type": "integer", "description": "Delay in milliseconds between profile requests. Higher values are slower but gentler.", "default": 2000 }, "maxRetries": { "title": "Max Retries Per Profile", "minimum": 1, "maximum": 10, "type": "integer", "description": "Maximum retry attempts for each profile after transient request failures.", "default": 3 } } }, "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 } } } } } } } } } }