{ "openapi": "3.0.1", "info": { "title": "Creator Commerce Competitor Finder — LTK & ShopMy", "description": "Find the creators who promote a brand (yours or a competitor's) on LTK and ShopMy. Enter brand names or domains, get one row per creator with profile link, products linked, clicks, last post date, bio, Instagram and other public links. Schedule with 'only new' to catch new affiliates.", "version": "0.1", "x-build-id": "nvHk4IdIQy9cjXqCw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/latentlark~creator-commerce-competitor-finder/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-latentlark-creator-commerce-competitor-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/latentlark~creator-commerce-competitor-finder/runs": { "post": { "operationId": "runs-sync-latentlark-creator-commerce-competitor-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/latentlark~creator-commerce-competitor-finder/run-sync": { "post": { "operationId": "run-sync-latentlark-creator-commerce-competitor-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": [ "brands" ], "properties": { "brands": { "title": "Brands", "type": "array", "description": "One per line. A brand name as shoppers know it (Rhode, Summer Fridays) or the brand's website (glossier.com). Competitors or your own brand.", "items": { "type": "string" } }, "platforms": { "title": "Platforms", "type": "array", "description": "Where to look for creators promoting the brand.", "items": { "type": "string", "enum": [ "shopmy", "ltk" ], "enumTitles": [ "ShopMy", "LTK (LIKEtoKNOW.it)" ] }, "default": [ "shopmy", "ltk" ] }, "maxCreatorsPerBrand": { "title": "Max creators per brand and platform", "minimum": 0, "type": "integer", "description": "Top creators first (ShopMy: by monthly clicks on the brand's products; LTK: by number of brand products linked). Keeps cost predictable. 0 = no limit.", "default": 50 }, "maxProductsPerCreator": { "title": "Max product links per creator", "minimum": 0, "maximum": 50, "type": "integer", "description": "Brand products listed in each creator row (title, link, price, image). Each returned link is a 'product-link' event. 0 = counts only, no links.", "default": 5 }, "includeProfileDetails": { "title": "Include profile details", "type": "boolean", "description": "Adds name, bio, Instagram/TikTok/YouTube/website links, emails written in the public bio and (LTK) the date of the latest brand post. One light extra request per creator (LTK: batched).", "default": true }, "includeLtkFollowers": { "title": "LTK follower count", "type": "boolean", "description": "Reads the LTK follower count from each creator's public LTK page. Slower (one page per creator) but no extra charge.", "default": false }, "onlyNew": { "title": "Only new creators since last run", "type": "boolean", "description": "Outputs (and charges for) only creators not seen in earlier runs with the same Monitor key. The first run saves a baseline.", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Name for this watch list, e.g. skincare-competitors. Runs with the same key share the 'seen' list.", "default": "default" } } }, "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 } } } } } } } } } }