{ "openapi": "3.0.1", "info": { "title": "Instagram Related Profiles Scraper", "description": "Find Instagram accounts similar to any profile from Instagram's \"Suggested for you\" list, with followers, bio, emails and phones from bios and Linktree, category and engagement. Chain discovery, seed overlap and filters. No login.", "version": "1.1", "x-build-id": "Pa3PnukxoPrRNctxG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~instagram-related-profiles-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-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/parsebird~instagram-related-profiles-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-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/parsebird~instagram-related-profiles-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-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": [ "usernames" ], "properties": { "usernames": { "title": "Instagram accounts", "type": "array", "description": "Add the accounts to find lookalikes for: usernames (natgeo), @handles (@nasa) or profile links (https://www.instagram.com/nike). Post, reel and hashtag links aren't supported.", "items": { "type": "string" } }, "maxSimilarPerAccount": { "title": "Max related profiles per account", "minimum": 1, "type": "integer", "description": "Cap on lookalikes taken from each source account. Instagram suggests up to about 50 per account. Leave empty for all." }, "maxTotalProfiles": { "title": "Max profiles in total", "minimum": 1, "type": "integer", "description": "Hard cap on profiles saved (and charged) across the whole run. Recommended with chain discovery." }, "excludeUsernames": { "title": "Exclude accounts", "type": "array", "description": "Accounts never to return, such as your own brand or creators you already work with. They are dropped before any lookup and never charged.", "items": { "type": "string" } }, "minSeedOverlap": { "title": "Min shared seeds", "minimum": 1, "type": "integer", "description": "Keep only profiles Instagram suggests for at least this many of your accounts. 2 or more finds the lookalikes of the whole set. Turns chain discovery off.", "default": 1 }, "depth": { "title": "Chain discovery depth", "minimum": 1, "maximum": 5, "type": "integer", "description": "Follow the suggestion graph 1 to 5 levels deep. Level 2 also fetches the lookalikes of every profile found at level 1, and so on. Every profile appears only once per run. Set Max profiles in total to control size.", "default": 1 }, "enrichProfiles": { "title": "Add profile details", "type": "boolean", "description": "Look up each lookalike to add followers, following, posts, bio, links, emails and phones from the bio and Linktree/lnk.bio pages, category, business flag and median engagement. Charged as one enrichment per profile looked up. Any filter below that needs these fields turns this on.", "default": true }, "includeLatestPosts": { "title": "Include the 3 latest posts", "type": "boolean", "description": "Attach a preview of each profile's 3 latest posts (link, likes, comments, caption, image), when Instagram returns them.", "default": false }, "scrapeFacebookProfile": { "title": "Add the Facebook page link", "type": "boolean", "description": "Put the profile's linked Facebook page, or a Facebook link from its bio, on facebookProfileUrl. Facebook itself is not opened.", "default": false }, "contactInfoType": { "title": "Contact details required", "enum": [ "any", "emailOnly", "phoneOnly", "emailOrPhone", "emailAndPhone" ], "type": "string", "description": "Keep only profiles where an email and/or phone number was found in the bio or on its Linktree/lnk.bio page.", "default": "any" }, "minFollowers": { "title": "Min followers", "minimum": 0, "type": "integer", "description": "Drop lookalikes below this follower count." }, "maxFollowers": { "title": "Max followers", "minimum": 0, "type": "integer", "description": "Drop lookalikes above this follower count, for example to keep micro and mid-tier creators." }, "minEngagementRate": { "title": "Min engagement rate (%)", "minimum": 0, "type": "number", "description": "Median (likes + comments) / followers over the latest 12 posts, in percent. Profiles whose rate can't be measured are dropped." }, "maxEngagementRate": { "title": "Max engagement rate (%)", "minimum": 0, "type": "number", "description": "Upper bound of the median engagement rate, in percent. Profiles whose rate can't be measured are dropped." }, "minPosts": { "title": "Min posts", "minimum": 0, "type": "integer", "description": "Drop lookalikes with fewer posts." }, "maxPosts": { "title": "Max posts", "minimum": 0, "type": "integer", "description": "Drop lookalikes with more posts." }, "onlyVerified": { "title": "Only verified accounts", "type": "boolean", "description": "Return only accounts with a verification badge. Checked before any lookup, so dropped accounts cost nothing.", "default": false }, "onlyBusiness": { "title": "Only business and creator accounts", "type": "boolean", "description": "Keep only professional (business or creator) accounts. Profiles whose account type Instagram doesn't return are dropped.", "default": false }, "excludePrivate": { "title": "Skip private accounts", "type": "boolean", "description": "Drop private lookalikes. Private accounts never seed the next level of chain discovery either way.", "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }