{ "openapi": "3.0.1", "info": { "title": "YesStyle Scraper - K-Beauty, Fashion, Prices & Reviews", "description": "Scrape YesStyle products by keyword or URL. Extract prices, discounts, ratings, stock, images, categories, variants and customer reviews across K-beauty, fashion and lifestyle. Incremental mode tracks daily changes.", "version": "1.0", "x-build-id": "ARlQ5RzPF4l9GuMkq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~yesstyle-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-yesstyle-com-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/abotapi~yesstyle-com-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-yesstyle-com-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/abotapi~yesstyle-com-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-yesstyle-com-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": { "mode": { "title": "Mode", "enum": [ "search", "url" ], "type": "string", "description": "Choose 'search' to run one or more keywords through YesStyle's own search, or 'url' to scrape pasted links: product pages, browse (list.html) pages and search pages are all accepted.", "default": "search" }, "queries": { "title": "Search keywords", "type": "array", "description": "Only used when mode = search, ignored in url mode. One or more keywords, for example sheet mask, anua serum, korean dress.", "items": { "type": "string" } }, "sortBy": { "title": "Sort keywords by", "enum": [ "bestsellers", "new_arrivals", "price_low_high", "price_high_low", "best_value", "availability", "discount_high_low" ], "type": "string", "description": "Search mode only. Sort order applied to keyword searches, using the store's own sort codes. Pasted links in URL mode always keep their own ordering.", "default": "bestsellers" }, "urls": { "title": "YesStyle links", "type": "array", "description": "Only used when mode = url, ignored in search mode. Paste product page links, browse links (brand/category listings) or search links from yesstyle.com.", "items": { "type": "string" } }, "minPrice": { "title": "Minimum price", "type": "string", "description": "Both modes. Keep only products priced at or above this value (in the storefront currency your run reads). Leave empty for no lower bound." }, "maxPrice": { "title": "Maximum price", "type": "string", "description": "Both modes. Keep only products priced at or below this value. Leave empty for no upper bound." }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Both modes. Keep only products the product page marks as in stock. Needs Fetch product details enabled.", "default": false }, "fetchDetails": { "title": "Fetch product details", "type": "boolean", "description": "Read each product's own page for the description, availability, condition, selected variant, full image set and category trail. Costs one Detail enrichment unit per product returned.", "default": true }, "fetchReviews": { "title": "Fetch customer reviews", "type": "boolean", "description": "Attach the product's customer reviews to its record as a nested list. Costs one Review enrichment unit per review attached. Reviews are only read for products actually returned.", "default": true }, "reviewSort": { "title": "Review sort", "enum": [ "relevant", "newest", "highest", "helpful" ], "type": "string", "description": "Both modes. Which reviews come first, using the store's own review orderings.", "default": "relevant" }, "reviewFilter": { "title": "Review filter", "enum": [ "all", "five_star", "four_star", "three_star", "two_star", "one_star", "positive", "negative", "photo", "video" ], "type": "string", "description": "Both modes. Which reviews the store includes, using its own review filters.", "default": "all" }, "maxReviewsPerProduct": { "title": "Max reviews per product", "type": "integer", "description": "Both modes. Stop reading a product's reviews after this many. Use 0 to read every review the store returns for the product.", "default": 20 }, "maxItems": { "title": "Max products", "type": "integer", "description": "Stop after this many products. The run ends cleanly once the cap is reached.", "default": 20 }, "maxPages": { "title": "Max pages per listing", "type": "integer", "description": "Walk at most this many result pages per keyword or listing. Leave empty or 0 to walk every page of results." }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Continue an interrupted run: paste a previous run's ID (or a dataset ID) from this account and every product it already collected is skipped." }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Track the same search or links across scheduled runs and return only what changed: NEW, UPDATED, UNCHANGED (suppressed by default), REAPPEARED and EXPIRED products. The first run for a scope reports everything as NEW.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Optional name for the incremental baseline. Runs sharing a state key share one baseline; leave empty to derive it from the search configuration automatically." }, "emitUnchanged": { "title": "Emit unchanged products", "type": "boolean", "description": "Also return products that did not change since the last incremental run (changeType UNCHANGED) instead of suppressing them.", "default": false }, "emitExpired": { "title": "Emit expired products", "type": "boolean", "description": "After a complete scan, also return tracked products that are no longer in the results (changeType EXPIRED).", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields for change detection", "type": "array", "description": "Advanced. Top-level field names whose changes alone should not mark a product UPDATED (for example badges). The record's other fields still fingerprint normally.", "items": { "type": "string" } }, "proxy": { "title": "Connection", "type": "object", "description": "Apify Proxy is enabled by default on the residential pool - the store's edge refuses datacenter exits on listing pages. The exit country decides the regional storefront and currency (US default)." }, "mcpConnectors": { "title": "MCP connectors", "type": "array", "description": "Optional MCP connector IDs. Each returned product is also sent to the connector (for example a Notion database).", "items": { "type": "string" } }, "notionParentPageUrl": { "title": "Notion parent page URL", "type": "string", "description": "Used with a Notion MCP connector: the parent page or database the product pages are created under." }, "maxNotifyListings": { "title": "Max items sent to connectors", "type": "integer", "description": "Cap how many of the returned products are sent to MCP connectors.", "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 }, "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 } } } } } } } } } }