{ "openapi": "3.0.1", "info": { "title": "Tirabeauty Product Search Scraper", "description": "Extract detailed product information from Tira Beauty search pages in seconds. This scraper captures prices, ratings, variants, promotions, and 30+ fields per product—perfect for price monitoring, market research, and beauty e-commerce analytics.", "version": "0.0", "x-build-id": "Gf89t2Ls5xTCurVdN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~tirabeauty-product-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-tirabeauty-product-search-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/stealth_mode~tirabeauty-product-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-tirabeauty-product-search-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/stealth_mode~tirabeauty-product-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-tirabeauty-product-search-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": { "urls": { "title": "URLs of the product search list urls to scrape", "type": "array", "description": "Add the URLs of the product search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "keyword": { "title": "Keyword to search", "type": "string", "description": "Enter the keyword to search for items" }, "sort_by": { "title": "Sort Items by options", "enum": [ "", "discount_dsc", "attributes.customaveragerating_desc", "price_asc", "price_desc" ], "type": "string", "description": "Sort items by options" }, "category": { "title": "Category", "enum": [ "", "foundation", "lipstick", "liquid-lipstick", "shampoo", "face-moisturizer", "womens-perfumes-edt-edp", "mens-perfumes-edt-edp", "serums-essence", "concealer", "lip-gloss", "nail-polish", "blush", "face-wash", "eye-shadow", "lip-balm", "conditioner", "hair-brushes", "body-lotions-moisturizers", "eyeliner", "body-wash-shower-gel", "face-sunscreen", "lip-liner", "unisex-perfumes-edt-edp", "face-brush", "eye-brow-enhancers", "toners", "hair-serum", "lip-stain", "highlighters", "skin-cleanser", "compact", "hair-masks", "mascara", "masks-peels", "eye-brush", "face-primer", "mens-deodorants-roll-ons", "hair-combs", "sponges-applicators", "kajal", "hair-spray", "sheet-masks", "body-sunscreen", "hair-oil", "lip-crayon", "hair-color", "setting-powder", "eye-cream-serums", "womens-deodorants-roll-ons", "soaps", "womens-body-mist-sprays", "bb-cc-cream", "hair-creams", "night-cream", "makeup-remover", "hair-accessories", "body-scrubs-exfoliants", "trimmers", "setting-spray", "bronzer", "brush-sets", "hair-dryers", "loose-powder", "false-eyelashes", "scrubs-exfoliators", "manicure-pedicure-kits", "all-other-supplements", "eye-palettes", "nail-art-kits", "hair-straighteners", "face-oil", "gels-waxes", "hand-creams-masks", "lip-plumper", "hair-stylers", "lip-oils", "razors-cartridges", "foot-cares", "unisex-body-mist-sprays", "face-makeup-palettes", "facial-kits", "rollers-curlers", "body-wash", "massage-tool", "contour", "makeup-pouches", "wipes-buds", "mist", "lip-masks", "massage-oil", "lotions-creams", "hair-stylings", "kids-care-lotions-creams", "shower-gels", "hand-wash", "candles", "essential-oil", "nail-polish-remover", "nail-care", "mens-body-mist-sprays", "loofahs-sponges", "body-butters", "lotions-cream", "gift-sets", "lip-brush", "unisex-deodorants-roll-ons", "baby-powder", "colognes", "eye-masks", "hair-scalp-treatments", "face-wipes", "files-buffers", "gua-shas-rollers", "hair-mousse-pomade", "dermarollers", "multivitamins", "baby-oil", "hair-sets-kits", "collagen-skin", "bath-kits-sets", "epilators", "mirrors", "dry-shampoo", "shavers", "tweezers", "eye-primer", "aftershave-lotion", "body-scrubbers-brushes", "eyelash-curlers", "hair-texturiser", "acne-removal", "lip-scrubs", "makeup-kits-sets", "stretch-mark-creams-oils", "talc", "beard-oil", "intimate-hygiene", "immunity-boosters-vitamin-c", "tools-bathing-accessories", "bath-brushes", "biotin-hair", "face-eyebrow-razors", "body-lotions", "brush-cleaners", "eye-makeup-remover", "eye-bases-primers", "under-eye-concealer", "wax-wax-strips", "bath-salts", "blush-brush", "body-groomers", "cleansing-tools", "grooming-kits", "shaving-creams", "baby-care-sunscreen", "beard-colour", "diffuser", "intimate-care", "shaving-gels", "gift-sets-combos", "sharpeners", "shower-caps", "beard-comb", "eye-care-eye-masks", "hair-removal-creams", "magnesium-zinc", "shaving-brushes", "all-other-beauty-supplements", "beard-balm", "beard-cream", "beard-wax", "bikini-trimmers", "pre-post-shaves", "refillables", "toothpaste", "anti-stretch-mark-creams", "beard-serum", "cleansing-brushes", "firming-gels-and-creams", "floss-tongue-cleaners", "hair-fragrance", "omega-3-fish-oil", "shaving-foams", "bath-tools", "beard-softener", "beard-wash", "detanning-packs", "kids-care-sunscreen", "nail-tools", "sexual-enhancers" ], "type": "string", "description": "Enter the category to search for items" }, "brand": { "title": "Brand", "enum": [ "", "kiko-milano", "lakme", "pac", "m-a-c", "daily-life-forever52", "maybelline-new-york", "insight-cosmetics", "nars", "fenty-beauty", "vega", "clinique", "majestique", "l-oreal-paris", "character", "mamaearth", "tirtir", "plum", "kryolan", "renee", "babila", "faces-canada", "pilgrim", "huda-beauty", "estee-lauder", "oulac", "makeup-revolution", "swiss-beauty", "benefit-cosmetics", "bobbi-brown", "miss-claire", "l-occitane", "laura-mercier", "too-faced", "beardo", "minimalist", "forest-essentials", "kiro", "nivea", "the-body-shop", "mcaffeine", "yves-saint-laurent", "moroccanoil", "anastasia-beverly-hills", "colorbar", "etude-house", "essence", "mars", "dove", "sheglam", "bareminerals", "o3", "ajmal", "fixderma", "the-derma-co", "lancome", "foxtale", "lovechild-masaba", "smashbox", "dolce-gabbana", "charmacy-milano", "pixi", "innisfree", "the-face-shop", "alan-truman", "gubb", "bronson-professional", "sugar-cosmetics", "kama-ayurveda", "bioderma", "europe-girl", "l-a-girl", "fae-beauty", "ras-luxury-skincare", "schwarzkopf-professional", "hyue-beauty", "allure", "wishcare", "love-beauty-planet", "vaadi-herbals", "kylie-cosmetics", "skin1004", "chicco", "the-man-company", "clarins", "pond-s", "vega-professional", "jo-malone-london", "tom-ford", "ikonic-professional", "wild-stone", "laneige", "wellbeing-nutrition", "the-natural-wash", "giorgio-armani", "kimirica", "make-up-for-ever", "palmer-s", "police", "brillare", "aqualogica", "cetaphil", "guess", "beauty-garage", "givenchy", "milk-shake", "bblunt", "nike", "prada", "the-ordinary", "house-of-beauty", "mixsoon", "sol-de-janeiro", "wella-professionals", "matt-look", "rom-nd", "elizabeth-arden", "tresemme", "elle-18", "garnier", "typsy-beauty", "vaseline", "ouai", "salvatore-ferragamo", "aravi-organic", "sebastian-professional", "simple", "keune", "moxie-beauty", "neutrogena", "dr-sheth-s", "l-oreal-professionnel", "by-terry", "paese-cosmetics", "sebamed", "biotop-professional", "muzigae-mansion", "samer-khouzami", "akind", "cotril", "medicube", "sadhev", "tira", "cerave", "chantecaille", "caudalie", "hince", "soulflower", "gk-hair", "streax", "skin-cottage", "burberry", "aveda", "kerastase", "sugar-pop", "focallure", "milani", "moody", "alfaparf-milano", "la-mer", "philips", "streax-professional", "house-of-makeup", "adidas", "ikonic-me", "kilian-paris", "winston", "letsshave", "parul-garg-beauty", "the-love-co", "beauty-of-joseon", "embark", "mario-badescu", "protouch", "stila-cosmetics", "the-earth-collective", "be-bodywise", "mercedes-benz", "orangewood", "thalgo", "deconstruct", "inde-wild", "neesh", "olaplex", "tulips", "arata", "carolina-herrera", "hair-pure", "jaguar", "o-p-i", "ustraa", "blur", "cadiveu", "calvin-klein", "fenty-skin", "house-of-hur", "kayali", "lador", "real-techniques", "farmacy-beauty", "gush-beauty", "sulwhasoo", "bvlgari", "chloe", "hyphen", "jean-paul-gaultier", "nuse", "skinn-by-titan", "augustinus-bader", "johnson-s-baby", "manetain", "puraveda", "pyunkang-yul", "schwarzkopf", "bie-beauty-in-everything", "giovanni", "ktein", "la-prairie", "lamel", "novology", "paco-rabanne", "re-equil", "secret-temptation", "tfit", "banderas", "bombay-shaving-company", "dermalogica", "iconic-london", "mancode", "tommy-hilfiger", "versace", "anua", "beautiliss-professional", "denman", "dream-beauty", "layer-r", "ln-pro", "paulas-choice", "ph-labotories", "redken", "aveeno", "belif", "cacharel", "kundal", "roberto-cavalli", "sirona", "tangle-teezer", "boss", "davidoff", "embryolisse", "fix-my-curls", "ga-de", "marc-jacobs", "mizon", "amouage", "bella-vita-organic", "celimax", "kt-professional", "asaya", "chopard", "dream-immerse-play", "dear-klairs", "matrix", "united-colors-of-benetton", "aplb", "clayco", "cos-iq", "dkny", "engage", "gucci", "milk-touch", "nautica", "round-lab", "st-john", "allies-of-skin", "half-n-half", "mcm", "pigment-play", "sp", "thank-you-farmer", "the-good-bug", "the-skin-story", "cristiano-ronaldo", "daniel-sandler", "fixderma-cosmetic-laboratories", "haru-haru-wonder", "insight-professional", "pears", "treaclemoon", "axis-y", "bluesky", "chambor", "de-fabulous", "giordano", "hair-resq", "kin-cosmetics", "the-sass-bar", "urban-yog", "axe", "dralthea", "drmelaxin", "maison-margiela", "nacific", "pattern", "seva-home", "3tenx", "armaf", "azzaro", "just-herbs", "nexxus", "ogx", "plix-the-plant-fix", "ruby-s-organics", "9skin", "arencia", "biluma", "d-you", "dear-dahlia", "nouba", "the-formularx", "torriden", "viktor-rolf", "zlade", "bombae", "conscious-chemist", "cosrx", "k18", "tuco", "biodance", "curlyshyll", "dashing-diva", "idun-minerals", "jrl-professional", "kocostar", "kt-men", "milk-baobab", "purearth", "ralph-lauren", "sachajuan", "wildly-pure", "amazon-series", "diam-beauty", "gillette", "natio", "naturally-european", "oziva", "passion-indulge", "pierre-cardin-paris", "valentino", "anillo", "baby-forest", "bigen", "jeffree-star-cosmetics", "jumiso", "sungboon-editor", "the-pink-foundry", "what-s-up-wellness", "and", "biolage", "crazy-color", "dyson", "hask", "lolita-lempicka", "love-momma", "mugler", "qod-professional", "rexona", "the-english-soap-company", "the-vintage-cosmetic-company", "tocobo", "urban-gabru", "xo-curls", "agaro", "banana-republic", "braun", "coxir", "dalba-piedmont", "dr-batra-s", "dsquared2", "eclipse-solaire", "fcl", "heliocare", "inglot", "legend-1942", "michael-kors", "missha", "profusion-cosmetics", "revlon", "sacred-grove", "thick-fiber", "abu-jani-sandeep-khosla", "bentley", "dorall-collection", "elie-saab", "episoft", "everpure-life", "la-shield", "layer-r-shot", "mannlich", "miss-kay", "neud", "qraa-men", "revolution-pro", "tree-hut", "truefitt-hill", "antonio-banderas", "aromas-artesanales-de-antigua", "clinic-plus", "dr-jart", "fastrack", "franck-olivier", "hugo-boss", "inja", "it-s-a-10", "john-varvatos", "jovan", "kaine", "kevyn-aucoin", "petal-fresh", "proarte", "shiseido", "treecell", "vlcc", "youth-to-the-people", "abercrombie-fitch", "anessa", "clean-clear", "david-beckham", "jacques-bogart", "juicy-couture", "man-arden", "maryaj", "patchology", "purna-gummies", "thriveco", "vi-john", "yourhappylife", "chicnutrix", "dermafique", "emporio-armani", "i-m-from", "la-french", "mermade-hair", "mom-world", "oceglow", "praush-beauty", "resolve", "s-oliver", "st-ives", "tash-hair", "whiskers", "xx-revolution", "yardley-london", "alfaparf-alta-moda", "basicare", "bondi-boost", "dhc", "diego-dalla-palma-milano", "diesel", "elle", "first-aid-beauty", "gatsby", "grande-cosmetics", "hackett", "head-shoulders", "isdin", "kaya", "mars-by-ghc", "max-care", "nails-our-way", "paradyes", "park-avenue", "pinkflash", "ramsons", "ras-luxury-oils", "villain", "wet-n-wild", "afnan", "alfa-romeo", "avimee-herbal", "beauty-people", "beyond", "dafni", "ducati", "fogg", "hollister", "jovees", "la-martina", "lyla-blanc", "moschino", "pinky-goat", "pure-sense", "screen", "solinotes", "sunsilk", "suva-beauty", "swisse", "the-beard-story", "tikitoro", "tumi", "vera-wang", "wow-skin-science", "aigner", "albatross", "baldessarini", "barcode-professional", "beardburys", "coloressence", "djokr", "dromen-co", "ecotools", "elizabeth-taylor", "enn", "fiama", "finishing-touch-flawless", "french-essence", "guy-laroche", "himalaya", "india-grooming-club", "indulekha", "invisibobble", "it-s-skin", "jaquline-usa", "kevin-murphy", "lalique", "lattafa", "lotus-botanicals", "love-earth", "lux", "moncler", "murshmallow", "newsha", "pantene", "rodial", "royal-mirage", "set-wet", "sixam-glow", "spritz-by-typsy", "tabac", "tonino-lamborghini", "votre", "vt-cosmetics", "a-fragrance-story", "aaranyaa", "alyssa-ashley", "archies-parfum", "asa-beauty", "aspen", "aya", "beebaby", "beverly-hills-polo-club", "biore", "boucheron", "c-a-l-los-angeles", "coach", "colour-me", "courreges", "ellement-co", "essential-souls", "evaflor", "facegym", "flicka", "fran-wilson-moodmatcher", "furla", "globus-naturals", "goddess", "hajamat", "hnk-hair-n-kraft", "justhuman", "keya-seth-aromatherapy", "khadlaj", "kraftpro", "lacto-calamine", "lanvin", "liquid-iv", "lottie-london", "lotus-herbals", "lotus", "lotus-organics", "marc-anthony", "menhood", "messi", "minus-417", "miss-nails", "mua", "myglamm", "nirvasa", "old-spice", "pupa-milano", "reebok", "replay", "sanosan-baby", "saturn-by-ghc", "setu", "sigma-beauty", "star-struck-by-sunny-leone", "swiss-army", "the-moms-co", "tymo", "uncle-tony", "vedic-valley", "vitamins-and-sea-beauty", "yves-rocher" ], "type": "string", "description": "Enter the brand to search for items" }, "gender": { "title": "Gender", "enum": [ "", "Unisex", "Women", "Men", "Boy", "Girl" ], "type": "string", "description": "The gender of the products to scrape." }, "discount": { "title": "Discount", "enum": [ "", "5", "10", "15", "20", "25", "30", "35", "40", "45", "50", "55", "60", "65", "70", "75", "80" ], "type": "string", "description": "The discount of the products to scrape." }, "rating": { "title": "Rating", "enum": [ "", "4", "3", "2", "1" ], "type": "string", "description": "The rating of the products to scrape." }, "price_min": { "title": "Price min", "type": "integer", "description": "The minimum price of the products to scrape." }, "price_max": { "title": "Price max", "type": "integer", "description": "The maximum price of the products to scrape." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } }