{ "openapi": "3.0.1", "info": { "title": "TikTok Shop GMV Analyzer | Sellers, Products & Creators | $5/1K", "description": "Analyze TikTok Shop sellers, products, niches, and affiliate creators. Estimate GMV, profit, portfolio concentration, creator contribution, and product opportunities from public marketplace signals. No login or cookies. Pay per result from $5/1K.", "version": "1.0", "x-build-id": "at3bozL8BPBpjK1Vd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apivault_labs~tiktok-shop-seller-product-creator-gmv-analyzer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apivault_labs-tiktok-shop-seller-product-creator-gmv-analyzer", "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/apivault_labs~tiktok-shop-seller-product-creator-gmv-analyzer/runs": { "post": { "operationId": "runs-sync-apivault_labs-tiktok-shop-seller-product-creator-gmv-analyzer", "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/apivault_labs~tiktok-shop-seller-product-creator-gmv-analyzer/run-sync": { "post": { "operationId": "run-sync-apivault_labs-tiktok-shop-seller-product-creator-gmv-analyzer", "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": { "mode": { "title": "Analysis mode", "enum": [ "keyword", "seller", "product", "creator" ], "type": "string", "description": "Choose whether to research product keywords, seller portfolios, individual products, or creator contribution.", "default": "keyword" }, "searchQueries": { "title": "Product keywords", "type": "array", "description": "Keywords used in Keyword mode and to discover public creator-product relationships in Creator mode.", "items": { "type": "string" } }, "sellerUrls": { "title": "TikTok Shop seller URLs or IDs", "type": "array", "description": "Public TikTok Shop store URLs or numeric seller IDs used in Seller mode.", "items": { "type": "string" } }, "productUrls": { "title": "TikTok Shop product URLs", "type": "array", "description": "Public TikTok Shop PDP links used in Product mode.", "items": { "type": "string" } }, "productIds": { "title": "TikTok Shop product IDs", "type": "array", "description": "Numeric product IDs used in Product mode.", "items": { "type": "string" } }, "creatorIds": { "title": "Creator IDs or names (optional)", "type": "array", "description": "In Creator mode, return only matching public creator IDs or names. Leave empty to rank every creator discovered for the supplied keywords.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum results", "minimum": 1, "maximum": 100, "type": "integer", "description": "Hard limit for unique products scanned or returned. Set this before a large run to control cost.", "default": 30 }, "maxConcurrency": { "title": "Processing concurrency", "minimum": 1, "maximum": 8, "type": "integer", "description": "Parallel product processing. The default balances speed and reliability.", "default": 4 }, "timeoutSeconds": { "title": "Request timeout", "minimum": 15, "maximum": 50, "type": "integer", "description": "Maximum time allowed for one public page request.", "default": 35 }, "costOfGoodsPercent": { "title": "Cost of goods, %", "minimum": 0, "maximum": 100, "type": "number", "description": "Your estimated sourcing cost as a percentage of sale price.", "default": 30 }, "platformFeePercent": { "title": "Marketplace fees, %", "minimum": 0, "maximum": 100, "type": "number", "description": "Assumed TikTok Shop marketplace and transaction fees.", "default": 6 }, "creatorCommissionPercent": { "title": "Creator commission, %", "minimum": 0, "maximum": 100, "type": "number", "description": "Assumed affiliate creator commission per attributed order.", "default": 10 }, "advertisingPercent": { "title": "Advertising cost, %", "minimum": 0, "maximum": 100, "type": "number", "description": "Estimated paid-media cost as a percentage of product revenue.", "default": 10 }, "refundRatePercent": { "title": "Refund allowance, %", "minimum": 0, "maximum": 100, "type": "number", "description": "Estimated returns and refunds allowance.", "default": 2 }, "shippingCostPerOrder": { "title": "Shipping cost per order", "minimum": 0, "type": "number", "description": "Seller-paid fulfillment and shipping cost per unit in USD.", "default": 0 } } }, "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 } } } } } } } } } }