{
"openapi": "3.0.1",
"info": {
"title": "Instagram Similar Profiles & Lookalike Finder - Bulk",
"description": "Find similar and related Instagram profiles from any seed account - no login. Expand a few accounts into hundreds of lookalikes across multiple hops, filter by follower size, verified, business or bio keyword, and enrich with email and counts. Export to CSV, JSON or Excel.",
"version": "1.0",
"x-build-id": "Oer29hW0dA1I99icX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/zaver.api~instagram-similar-profiles-finder/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-zaver.api-instagram-similar-profiles-finder",
"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/zaver.api~instagram-similar-profiles-finder/runs": {
"post": {
"operationId": "runs-sync-zaver.api-instagram-similar-profiles-finder",
"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/zaver.api~instagram-similar-profiles-finder/run-sync": {
"post": {
"operationId": "run-sync-zaver.api-instagram-similar-profiles-finder",
"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": [
"seeds"
],
"properties": {
"seeds": {
"title": "Seed profiles",
"type": "array",
"description": "Instagram usernames or profile URLs to find similar accounts for. One per line, e.g. nike or https://www.instagram.com/nike/. The finder returns accounts Instagram considers related to these.",
"items": {
"type": "string"
}
},
"maxDepth": {
"title": "Search depth (hops)",
"minimum": 1,
"maximum": 3,
"type": "integer",
"description": "1 = only accounts directly similar to your seeds. 2-3 = also expand into accounts similar to those, building a much larger lookalike network from a few seeds. Higher depth returns (and bills for) far more profiles.",
"default": 1
},
"maxProfiles": {
"title": "Max profiles to return",
"minimum": 1,
"maximum": 50000,
"type": "integer",
"description": "Stop once this many unique profiles have been found. You are billed per profile delivered.",
"default": 200
},
"minFollowers": {
"title": "Minimum followers",
"minimum": 0,
"type": "integer",
"description": "Keep only accounts with at least this many followers. 0 = no minimum.",
"default": 0
},
"maxFollowers": {
"title": "Maximum followers",
"minimum": 0,
"type": "integer",
"description": "Keep only accounts with at most this many followers (useful for finding micro-influencers). 0 = no maximum.",
"default": 0
},
"onlyVerified": {
"title": "Verified accounts only",
"type": "boolean",
"description": "Keep only verified (blue-check) accounts.",
"default": false
},
"onlyBusiness": {
"title": "Business / creator accounts only",
"type": "boolean",
"description": "Keep only business or creator accounts. Requires enrichment, which is switched on automatically when this is set.",
"default": false
},
"bioKeywords": {
"title": "Bio must contain (optional)",
"type": "array",
"description": "Keep only accounts whose biography contains at least one of these keywords (case-insensitive). Requires enrichment, switched on automatically when set. Example: coach, agency, shop.",
"items": {
"type": "string"
}
},
"enrichProfiles": {
"title": "Enrich each profile with full data",
"type": "boolean",
"description": "Add follower/following/post counts, biography, external link, category, business flag and public email to every result. One extra lookup per profile, billed at the enriched rate (see pricing). Turned on automatically when a bio or business filter is used.",
"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
}
}
}
}
}
}
}
}
}
}