{ "openapi": "3.0.1", "info": { "title": "Instagram Lookalike Search", "description": "🔮 Lookalike Instagram creators + 🍰 search IG engagement stats from 150M+ influencers.", "version": "1.0", "x-build-id": "dUjVfqYz5qewTxXpj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataovercoffee~instagram-lookalike-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataovercoffee-instagram-lookalike-search", "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/dataovercoffee~instagram-lookalike-search/runs": { "post": { "operationId": "runs-sync-dataovercoffee-instagram-lookalike-search", "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/dataovercoffee~instagram-lookalike-search/run-sync": { "post": { "operationId": "run-sync-dataovercoffee-instagram-lookalike-search", "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": [ "seed_usernames" ], "properties": { "seed_usernames": { "title": "Seed creators (usernames)", "type": "array", "description": "Instagram usernames to find lookalikes for. Provide 1-10 handles (e.g. hormozi) — a profile URL like https://www.instagram.com/hormozi works too (only profile links — post, reel and story links don't name a creator). More seeds = more precise results; creators common to several seeds rank highest. Public accounts only — a private account hides its posts, so there's nothing to match against.", "items": { "type": "string" } }, "limit": { "title": "Max results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of lookalike creators to return. The actual count is capped at whichever is lower: this value, or what your \"Maximum cost per run\" allows.", "default": 10 }, "min_followers": { "title": "Min followers", "minimum": 1000, "type": "integer", "description": "Only include creators with at least this many followers." }, "max_followers": { "title": "Max followers", "minimum": 1000, "type": "integer", "description": "Only include creators with at most this many followers." }, "min_avg_likes": { "title": "Min avg likes", "type": "integer", "description": "Minimum average likes per post." }, "max_avg_likes": { "title": "Max avg likes", "type": "integer", "description": "Maximum average likes per post." }, "min_avg_comments": { "title": "Min avg comments", "type": "integer", "description": "Minimum average comments per post." }, "max_avg_comments": { "title": "Max avg comments", "type": "integer", "description": "Maximum average comments per post." }, "min_post_count": { "title": "Min posts", "type": "integer", "description": "Only include creators with at least this many posts." }, "max_post_count": { "title": "Max posts", "type": "integer", "description": "Only include creators with at most this many posts." }, "only_has_email": { "title": "Has public email only", "type": "boolean", "description": "Only include creators with a public email (in bio or extracted). Great for outreach.", "default": false }, "genders": { "title": "Creator gender", "type": "array", "description": "Only include creators of these genders. Leave empty for every gender.", "items": { "type": "string", "enum": [ "female", "male" ], "enumTitles": [ "Female", "Male" ] } }, "only_verified": { "title": "Verified accounts only", "type": "boolean", "description": "Only include creators with the verified badge.", "default": false }, "primary_languages": { "title": "Primary languages", "type": "array", "description": "Only include creators whose main language is one of these. Leave empty for every language. Pick languages your SEED creators already post in — results are the creators most similar to your seeds, so seeding English creators and then asking for German leaves very little to match and you may get few or no results. Creators whose language isn't known are left out when you set this.", "items": { "type": "string", "enum": [ "en", "es", "id", "ar", "fr", "ru", "pt", "vi", "th", "de", "tr", "it", "ja", "pl", "ro", "uk", "nl", "ms", "km", "ko", "zh", "hu", "my", "sv", "el", "az", "he", "cs", "bg", "hr", "nb", "da", "fi", "hi", "bn", "sk", "uz", "kk", "lt", "gu", "fa", "sq", "ur", "mr", "sl", "ca", "kn", "et", "lv", "ta", "te", "si", "jv", "pa", "sw", "is", "ka", "ml", "mn", "ga", "be", "ceb", "sr", "af", "ne", "or", "tl", "yi" ], "enumTitles": [ "English", "Spanish", "Indonesian", "Arabic", "French", "Russian", "Portuguese", "Vietnamese", "Thai", "German", "Turkish", "Italian", "Japanese", "Polish", "Romanian", "Ukrainian", "Dutch", "Malay", "Khmer", "Korean", "Chinese", "Hungarian", "Burmese", "Swedish", "Greek", "Azerbaijani", "Hebrew", "Czech", "Bulgarian", "Croatian", "Norwegian", "Danish", "Finnish", "Hindi", "Bengali", "Slovak", "Uzbek", "Kazakh", "Lithuanian", "Gujarati", "Persian", "Albanian", "Urdu", "Marathi", "Slovenian", "Catalan", "Kannada", "Estonian", "Latvian", "Tamil", "Telugu", "Sinhala", "Javanese", "Punjabi", "Swahili", "Icelandic", "Georgian", "Malayalam", "Mongolian", "Irish", "Belarusian", "Cebuano", "Serbian", "Afrikaans", "Nepali", "Odia", "Filipino", "Yiddish" ] } }, "only_monetized": { "title": "Only creators monetizing", "type": "boolean", "description": "Makes money.", "default": false }, "only_not_monetized": { "title": "Only creators NOT yet monetizing", "type": "boolean", "description": "Doesn't make money yet.", "default": false }, "only_with_sponsorships": { "title": "Only creators with sponsorship history", "type": "boolean", "description": "Has done sponsored posts.", "default": false }, "only_without_sponsorships": { "title": "Only creators with NO sponsorship history", "type": "boolean", "description": "Hasn't done sponsored posts.", "default": false }, "exclude_usernames": { "title": "Exclude usernames", "maxItems": 500000, "type": "array", "description": "Usernames to exclude from results — paste the 'username' column from a previous run's output to skip creators you already have. Profile URLs work too. Up to 500,000.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }