{ "openapi": "3.0.1", "info": { "title": "Tiktok Shop Category Scraper", "description": "The only reliable TikTok Shop scraper on Apify. Extract product data, prices, sales counts, ratings, and images from any TikTok Shop category.", "version": "1.0", "x-build-id": "wf9mpfbFVxv8x3sRm" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~tiktok-shop-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-tiktok-shop-scraper", "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/webdatalabs~tiktok-shop-scraper/runs": { "post": { "operationId": "runs-sync-webdatalabs-tiktok-shop-scraper", "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/webdatalabs~tiktok-shop-scraper/run-sync": { "post": { "operationId": "run-sync-webdatalabs-tiktok-shop-scraper", "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": { "category": { "title": "Category", "enum": [ "beauty-personal-care/601450", "hand-foot-care/849032", "eye-ear-care/849544", "personal-care-appliances/849416", "makeup/848648", "skincare/848776", "haircare-styling/848904", "nasal-oral-care/849672", "bath-body-care/849160", "fragrance/856208", "special-personal-care/981128", "men-s-care/849288", "feminine-care/849800", "womenswear-underwear/601152", "women-s-underwear/842888", "women-s-suits-sets/842760", "women-s-dresses/842504", "women-s-tops/842248", "women-s-sleepwear-loungewear/843016", "women-s-bottoms/842376", "women-s-special-clothing/842632", "menswear-underwear/824328", "men-s-tops/839944", "men-s-bottoms/840072", "men-s-suits-sets/840712", "men-s-underwear-socks/840456", "men-s-sleepwear-loungewear/840584", "men-s-special-occasion-clothing/840328", "phones-electronics/601739", "mobile-phone-accessories/909064", "audio-video/909320", "smart-wearable-devices/909576", "cameras-photography/909192", "universal-accessories/978952", "gaming-consoles/909448", "phones-tablets/995976", "tablet-computer-accessories/984584", "refurbished-electronics/2109072", "education-devices/909704", "fashion-accessories/605248", "eyewear/905352", "hair-accessories/905864", "costume-jewelry-accessories/905608", "hair-extensions-wigs/810128", "clothes-accessories/905224", "fashion-watches-accessories/905480", "dressmaking-fabrics/843144", "wedding-accessories/888592", "collectibles/951432", "trading-cards-accessories/810000", "sports-collectibles/937736", "entertainment/953352", "cultural-items/809872", "home-supplies/600001", "home-care-supplies/852232", "bathroom-supplies/851976", "home-organizers/851848", "home-decor/852104", "festive-party-supplies/852488", "laundry-tools-accessories/852360", "miscellaneous-home/852616", "kitchenware/600024", "drinkware/859400", "kitchen-utensils-gadgets/859528", "bakeware/859016", "kitchen-knives/858632", "cookware/859144", "bar-wine-utensils/858888", "cutlery-tableware/859272", "barbecue/858760", "tea-coffeeware/858504", "shoes/601352", "shoe-accessories/900744", "women-s-shoes/900488", "men-s-shoes/900616", "sports-outdoor/603014", "sports-outdoor-accessories/834824", "sport-outdoor-clothing/834568", "fitness/835336", "swimwear-surfwear-wetsuits/846224", "sports-footwear/834696", "camping-hiking/835464", "ball-sports/834952", "water-sports/835080", "leisure-outdoor-recreation-equipment/835592", "winter-sports/835208", "fan-shop/936712", "lawn-games/2108816", "luggage-bags/824584", "women-s-bags/902408", "men-s-bags/902536", "functional-bags/902792", "luggage-travel-bags/902664", "bag-accessories/902920", "toys-hobbies/604206", "classic-novelty-toys/860296", "dolls-stuffed-toys/859656", "games-puzzles/860168", "sports-outdoor-play/859912", "educational-toys/859784", "diy/951560", "electric-remote-control-toys/860040", "musical-instruments-accessories/860552", "automotive-motorcycle/605196", "car-interior-accessories/930184", "car-washing-maintenance/940808", "car-repair-tools/940296", "car-electronics/929928", "car-lights/940424", "car-exterior-accessories/930056", "motorcycle-accessories/940936", "quads-motorhomes-boats/940680", "auto-replacement-parts/809488", "motorcycle-parts/809616", "kids-fashion/802184", "girls-footwear/806024", "boys-clothes/802312", "girls-clothes/803592", "kids-fashion-accessories/806792", "boys-footwear/805128", "computers-office-equipment/601755", "office-stationery-supplies/831112", "data-storage-software/828168", "computer-accessories/826760", "office-equipment/830344", "desktop-laptop-components/825352", "network-components/829192", "desktop-computers-laptops-tablets/824840", "baby-maternity/602284", "baby-care-health/879112", "baby-clothing-shoes/877320", "baby-furniture/878216", "maternity-supplies/880008", "baby-toys/878984", "baby-safety/878600", "baby-travel-gear/877576", "baby-fashion-accessories/961928", "nursing-feeding/877832", "tools-hardware/604579", "measuring-tools/871816", "power-tools/871560", "garden-tools/871944", "hardware/872328", "soldering-equipment/872072", "hand-tools/871688", "pumps-plumbing/980488", "tool-organizers/872200", "textiles-soft-furnishings/600154", "bedding-and-linens/808328", "household-textiles/809992", "fabrics-sewing-supplies/811016", "pet-supplies/602118", "dog-cat-grooming/816392", "dog-cat-litter/815624", "dog-cat-accessories/818696", "fish-aquatic-supplies/819848", "dog-cat-healthcare/818184", "small-animal-supplies/822792", "dog-cat-clothing/813960", "dog-cat-food/812168", "farm-animal-poultry-supplies/1001992", "dog-cat-furniture/812808", "bird-supplies/821896", "reptile-amphibian-supplies/821000", "home-improvement/604968", "bathroom-fixtures/873096", "garden-supplies/873352", "lights-lighting/872456", "building-supplies/872968", "kitchen-fixtures/872712", "electrical-equipment-supplies/872584", "security-safety/873224", "smart-home-systems/872840", "solar-wind-power/808208", "food-beverages/700437", "pantry-food/914952", "drinks/914824", "snacks/915336", "staples-cooking-essentials/915080", "baking/915208", "milk-dairy/809744", "fresh-frozen-food/915464", "beer-wine-spirits/914696", "muslim-fashion/601303", "hijabs/601304", "women-s-islamic-clothing/601310", "men-s-islamic-clothing/601325", "islamic-accessories/601343", "prayer-attire-equipment/601348", "islamic-sportswear/838920", "outerwear/601331", "kids-islamic-clothing/601339", "umroh-equipment/839176", "books-magazines-audio/801928", "humanities-social-sciences/927112", "lifestyle-hobbies/992392", "literature-art/986760", "education-schooling/992904", "children-s-infants-books/989704", "economics-management/989320", "science-technology/990216", "magazines-newspapers/985736", "video-music/997384", "household-appliances/600942", "home-appliances/844808", "kitchen-appliances/844168", "large-home-appliances/845064", "commercial-appliances/845320", "health/700645", "nutrition-wellness/700646", "alternative-medications-treatments/950792", "medical-supplies/924424", "furniture/604453", "commercial-furniture/871432", "outdoor-furniture/871176", "indoor-furniture/871048", "children-s-furniture/871304", "home-furniture/604454", "jewelry-accessories-derivatives/953224", "natural-crystal/955400", "artificial-gemstones/964360", "platinum-carat-gold/954888", "silver/955144", "non-natural-crystal/961800", "jade/963848", "semiprecious-stones/964232", "pearl/964488", "mellite/964744", "amber/964616", "gold/955016", "diamond/955272", "ruby-sapphire-emerald/964104", "pre-owned/856720", "footwear/857360", "bags/857232", "fashion-accessories/857104", "luggage-travel/864656", "collectible-trading-cards/856976", "refurbished-phones-electronics/857744" ], "type": "string", "description": "Select a TikTok Shop category to scrape. All main categories and subcategories are available.", "default": "beauty-personal-care/601450" }, "maxItems": { "title": "Maximum Products", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many products to scrape (1-1000)", "default": 50 } } }, "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 } } } } } } } } } }