{ "openapi": "3.0.1", "info": { "title": "TikTok Lookalike Search & Creator Finder", "description": "🔮 TikTok influencer & creator search: find lookalike creators + 📊 stats + verified emails from 300M+ accounts.", "version": "1.0", "x-build-id": "azpgxoQYSbbXyshyw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dataovercoffee~tiktok-lookalike-search/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dataovercoffee-tiktok-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~tiktok-lookalike-search/runs": { "post": { "operationId": "runs-sync-dataovercoffee-tiktok-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~tiktok-lookalike-search/run-sync": { "post": { "operationId": "run-sync-dataovercoffee-tiktok-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": "TikTok usernames to find lookalikes for. Provide 1-25 handles (e.g. ahormozi) — a profile URL like https://www.tiktok.com/@ahormozi works too (short vm.tiktok.com share links can't be resolved). More seeds = more precise results; creators common to several seeds rank highest.", "items": { "type": "string" } }, "limit": { "title": "Max results", "minimum": 1, "maximum": 1000, "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_heart_count": { "title": "Min total likes", "type": "integer", "description": "Only include creators with at least this many total likes (hearts) across all their videos." }, "max_heart_count": { "title": "Max total likes", "type": "integer", "description": "Only include creators with at most this many total likes." }, "min_video_count": { "title": "Min videos", "type": "integer", "description": "Only include creators with at least this many videos." }, "max_video_count": { "title": "Max videos", "type": "integer", "description": "Only include creators with at most this many videos." }, "min_avg_play_count": { "title": "Min typicalviews", "type": "integer", "description": "Minimum typical (median)views per recent video." }, "max_avg_play_count": { "title": "Max typicalviews", "type": "integer", "description": "Maximum typical (median)views per recent video." }, "min_avg_like_count": { "title": "Min typicallikes", "type": "integer", "description": "Minimum typical (median)likes per recent video." }, "max_avg_like_count": { "title": "Max typicallikes", "type": "integer", "description": "Maximum typical (median)likes per recent video." }, "min_avg_comment_count": { "title": "Min typicalcomments", "type": "integer", "description": "Minimum typical (median)comments per recent video." }, "max_avg_comment_count": { "title": "Max typicalcomments", "type": "integer", "description": "Maximum typical (median)comments per recent video." }, "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 }, "only_with_email": { "title": "Has a contact email only", "type": "boolean", "description": "Only include creators with a known contact email (from their bio/signature or links in their bio). Best for direct outreach.", "default": false }, "primary_languages": { "title": "Primary languages", "type": "array", "description": "Only include creators whose profile 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" ] } }, "countries": { "title": "Countries", "type": "array", "description": "Only return creators in these countries. SEED CREATORS FROM THAT REGION TOO — this filter makes the geography explicit, it does not go and find creators your seeds don't resemble, so seeding French creators and asking for US only will return very little. Leave empty to search every country; creators whose country isn't known are left out when you set this.", "items": { "type": "string", "enum": [ "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "CD", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "VI", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "enumTitles": [ "Afghanistan", "Åland Islands", "Albania", "Algeria", "American Samoa", "Andorra", "Angola", "Anguilla", "Antarctica", "Antigua and Barbuda", "Argentina", "Armenia", "Aruba", "Australia", "Austria", "Azerbaijan", "Bahamas", "Bahrain", "Bangladesh", "Barbados", "Belarus", "Belgium", "Belize", "Benin", "Bermuda", "Bhutan", "Bolivia", "Bonaire, Sint Eustatius and Saba", "Bosnia and Herzegovina", "Botswana", "Bouvet Island", "Brazil", "British Indian Ocean Territory", "British Virgin Islands", "Brunei", "Bulgaria", "Burkina Faso", "Burundi", "Cabo Verde", "Cambodia", "Cameroon", "Canada", "Cayman Islands", "Central African Republic", "Chad", "Chile", "China", "Christmas Island", "Cocos (Keeling) Islands", "Colombia", "Comoros", "Cook Islands", "Costa Rica", "Côte d'Ivoire", "Croatia", "Cuba", "Curaçao", "Cyprus", "Czechia", "Denmark", "Djibouti", "Dominica", "Dominican Republic", "DR Congo", "Ecuador", "Egypt", "El Salvador", "Equatorial Guinea", "Eritrea", "Estonia", "Eswatini", "Ethiopia", "Falkland Islands", "Faroe Islands", "Fiji", "Finland", "France", "French Guiana", "French Polynesia", "French Southern Territories", "Gabon", "Gambia", "Georgia", "Germany", "Ghana", "Gibraltar", "Greece", "Greenland", "Grenada", "Guadeloupe", "Guam", "Guatemala", "Guernsey", "Guinea", "Guinea-Bissau", "Guyana", "Haiti", "Heard Island and McDonald Islands", "Honduras", "Hong Kong", "Hungary", "Iceland", "India", "Indonesia", "Iran", "Iraq", "Ireland", "Isle of Man", "Israel", "Italy", "Jamaica", "Japan", "Jersey", "Jordan", "Kazakhstan", "Kenya", "Kiribati", "Kuwait", "Kyrgyzstan", "Laos", "Latvia", "Lebanon", "Lesotho", "Liberia", "Libya", "Liechtenstein", "Lithuania", "Luxembourg", "Macao", "Madagascar", "Malawi", "Malaysia", "Maldives", "Mali", "Malta", "Marshall Islands", "Martinique", "Mauritania", "Mauritius", "Mayotte", "Mexico", "Micronesia", "Moldova", "Monaco", "Mongolia", "Montenegro", "Montserrat", "Morocco", "Mozambique", "Myanmar", "Namibia", "Nauru", "Nepal", "Netherlands", "New Caledonia", "New Zealand", "Nicaragua", "Niger", "Nigeria", "Niue", "Norfolk Island", "North Korea", "North Macedonia", "Northern Mariana Islands", "Norway", "Oman", "Pakistan", "Palau", "Palestine", "Panama", "Papua New Guinea", "Paraguay", "Peru", "Philippines", "Pitcairn", "Poland", "Portugal", "Puerto Rico", "Qatar", "Republic of the Congo", "Réunion", "Romania", "Russia", "Rwanda", "Saint Barthélemy", "Saint Helena, Ascension and Tristan da Cunha", "Saint Kitts and Nevis", "Saint Lucia", "Saint Martin (French part)", "Saint Pierre and Miquelon", "Saint Vincent and the Grenadines", "Samoa", "San Marino", "Sao Tome and Principe", "Saudi Arabia", "Senegal", "Serbia", "Seychelles", "Sierra Leone", "Singapore", "Sint Maarten (Dutch part)", "Slovakia", "Slovenia", "Solomon Islands", "Somalia", "South Africa", "South Georgia and the South Sandwich Islands", "South Korea", "South Sudan", "Spain", "Sri Lanka", "Sudan", "Suriname", "Svalbard and Jan Mayen", "Sweden", "Switzerland", "Syria", "Taiwan", "Tajikistan", "Tanzania", "Thailand", "Timor-Leste", "Togo", "Tokelau", "Tonga", "Trinidad and Tobago", "Tunisia", "Turkey", "Turkmenistan", "Turks and Caicos Islands", "Tuvalu", "U.S. Virgin Islands", "Uganda", "Ukraine", "United Arab Emirates", "United Kingdom", "United States", "United States Minor Outlying Islands", "Uruguay", "Uzbekistan", "Vanuatu", "Vatican City", "Venezuela", "Vietnam", "Wallis and Futuna", "Western Sahara", "Yemen", "Zambia", "Zimbabwe" ] } }, "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 }, "only_commerce_users": { "title": "Commerce accounts only", "type": "boolean", "description": "Only include creators flagged as commerce (business) accounts.", "default": false }, "only_sellers": { "title": "TikTok Shop sellers only", "type": "boolean", "description": "Only include accounts that run their own TikTok Shop. To find creators who sell other brands' products, use the sales filters below.", "default": false }, "min_gmv_usd": { "title": "Min TikTok Shop sales (USD)", "minimum": 0, "type": "integer", "description": "Only include creators whose videos drove at least this much in TikTok Shop sales over the sales period, whether or not they run a shop." }, "max_gmv_usd": { "title": "Max TikTok Shop sales (USD)", "minimum": 0, "type": "integer", "description": "Only include creators whose videos drove at most this much in TikTok Shop sales over the sales period." }, "min_gpm_usd": { "title": "Min TikTok Shop sales per 1,000 views (USD)", "minimum": 0, "type": "integer", "description": "Only include creators whose videos drove at least this much in TikTok Shop sales per 1,000 views over the sales period." }, "max_gpm_usd": { "title": "Max TikTok Shop sales per 1,000 views (USD)", "minimum": 0, "type": "integer", "description": "Only include creators whose videos drove at most this much in TikTok Shop sales per 1,000 views over the sales period." }, "gmv_period": { "title": "Sales period", "enum": [ "7" ], "type": "string", "description": "The number of days the sales filters cover.", "default": "7" }, "exclude_usernames": { "title": "Exclude creators (usernames)", "type": "array", "description": "TikTok usernames to exclude from results — paste the 'unique_id' 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 } } } } } } } } } }