{ "openapi": "3.0.1", "info": { "title": "TikTok Shop Creator Finder: Affiliates, Units Sold & Emails", "description": "Find TikTok Shop affiliate creators by keyword, or look up usernames: units sold, products in their showcase, shop categories, followers, average views and the email in their bio. Pay only for shop creators found: $4 per 1,000; accounts without a shop are free. No login.", "version": "0.0", "x-build-id": "haTXXaLcvdoPqwsmj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/memo23~tiktok-shop-creator-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-memo23-tiktok-shop-creator-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/memo23~tiktok-shop-creator-finder/runs": { "post": { "operationId": "runs-sync-memo23-tiktok-shop-creator-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/memo23~tiktok-shop-creator-finder/run-sync": { "post": { "operationId": "run-sync-memo23-tiktok-shop-creator-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", "properties": { "searchQueries": { "title": "Search keywords", "type": "array", "description": "Keywords to find creators by, one per line, for example \"tiktok shop finds\", \"skincare finds\" or \"kitchen gadgets\". Accounts matching each keyword are checked, and those selling on TikTok Shop (US) are saved. Shop-minded keywords find the most creators.", "items": { "type": "string" } }, "usernames": { "title": "TikTok usernames", "type": "array", "description": "Creators to look up directly: a username, @username or a tiktok.com/@username link, one per line. Accounts that are not TikTok Shop creators are skipped and not charged.", "items": { "type": "string" } }, "discovery": { "title": "Where to look for creators", "enum": [ "both", "videos", "accounts" ], "type": "string", "description": "\"both\" checks the authors of videos matching each keyword first, then accounts matching it. \"videos\" or \"accounts\" uses one of them. Video authors often turn up shop creators that account search misses, because people who post product videos are more likely to sell.", "default": "both" }, "maxProfilesPerQuery": { "title": "Accounts to check per keyword", "minimum": 1, "maximum": 5000, "type": "integer", "description": "How many accounts are checked per keyword (video authors and matching accounts together) for a TikTok Shop creator profile. Only the creators found are charged, so a higher number costs time, not money. About 1 in 10 accounts found for shop-minded keywords is an active shop creator; 100 accounts take about 2 minutes.", "default": 100 }, "maxCreators": { "title": "Max creators", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Most creator rows to save in this run, across all keywords and usernames. Free-plan runs save up to 25.", "default": 100 }, "minFollowers": { "title": "Minimum followers", "minimum": 0, "type": "integer", "description": "Keep only creators with at least this many followers. 0 keeps everyone.", "default": 0 }, "minUnitsSold": { "title": "Minimum units sold", "minimum": 0, "type": "integer", "description": "Keep only creators whose shop profile shows at least this many units sold. 0 keeps everyone.", "default": 0 }, "onlyWithEmail": { "title": "Only creators with an email in their bio", "type": "boolean", "description": "Keep only creators who wrote an email address in their TikTok bio. Creators left out are not charged.", "default": false }, "includeInactiveShops": { "title": "Include shops with no products or sales", "type": "boolean", "description": "Search finds some accounts with a TikTok Shop profile but no products in the showcase and no units sold. They are left out (and not charged) unless this is on. Usernames you enter yourself are always returned.", "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 } } } } } } } } } }