{
"openapi": "3.0.1",
"info": {
"title": "Olive Young Global Scraper — Rankings & Ingredients [💰 $6/1K]",
"description": "Olive Young Global (global.oliveyoung.com) best-seller top 100, keyword search and category listings in English: USD prices, discounts, ratings, review counts, live stock, skin-type and ingredient tags — plus full ingredient lists, barcodes and options per product. No login, fast and cheap.",
"version": "0.1",
"x-build-id": "1gGmAcwUeddwUDZ0N"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cocomoon~oliveyoung-global-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cocomoon-oliveyoung-global-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/cocomoon~oliveyoung-global-scraper/runs": {
"post": {
"operationId": "runs-sync-cocomoon-oliveyoung-global-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/cocomoon~oliveyoung-global-scraper/run-sync": {
"post": {
"operationId": "run-sync-cocomoon-oliveyoung-global-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",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"bestsellers",
"search",
"details"
],
"type": "string",
"description": "What to scrape: bestsellers — Olive Young Global's official best-seller chart (top 100 overall or per category); search — products by keyword and/or category, sorted the way you choose; details — full details for specific products: complete English ingredient list, volume, shelf life, manufacturer, country of manufacture, options and barcodes.",
"default": "bestsellers"
},
"keywords": {
"title": "Search keywords",
"type": "array",
"description": "Search mode: keywords in English — a product type (sunscreen, toner pad), an ingredient (PDRN, centella) or a brand (anua, medicube). Combine with categories to search inside a category.",
"items": {
"type": "string"
}
},
"categories": {
"title": "Categories",
"type": "array",
"description": "Best sellers mode: one chart per selected category (leave empty for the overall chart). Search mode: browse these categories, or limit keywords to them.",
"items": {
"type": "string",
"enum": [
"skincare",
"moisturizers",
"cleansers",
"faceMasks",
"sheetMasks",
"suncare",
"sunscreen",
"makeup",
"faceMakeup",
"eyeMakeup",
"lipMakeup",
"bathBody",
"hair",
"tools",
"wellness",
"mensCare",
"supplements",
"foodDrink"
],
"enumTitles": [
"Skincare",
"Skincare › Moisturizers",
"Skincare › Cleansers",
"Face Masks",
"Face Masks › Sheet Masks",
"Suncare",
"Suncare › Sunscreen",
"Makeup",
"Makeup › Face",
"Makeup › Eye",
"Makeup › Lip",
"Bath & Body",
"Hair",
"Makeup Brush & Tools",
"Wellness",
"Men's Care",
"Supplements",
"Food & Drink"
]
},
"default": []
},
"categoryIds": {
"title": "Other category numbers (optional)",
"type": "array",
"description": "Any other Olive Young Global category, by its number or URL — the ctgrNo value in the category page address, e.g. 1000000047 (Lip Gloss & Lip Tint).",
"items": {
"type": "string"
}
},
"sortBy": {
"title": "Sort search results by",
"enum": [
"bestSelling",
"newest",
"mostReviewed",
"priceLowToHigh",
"priceHighToLow"
],
"type": "string",
"description": "Search mode: order of the results (same options as the site).",
"default": "bestSelling"
},
"includeDetails": {
"title": "Add full details & ingredients",
"type": "boolean",
"description": "Best sellers and search modes: also fetch each product's details — full English ingredient list, volume, shelf life, manufacturer, country of manufacture, how to use, options with barcodes, promotion dates and free gift. Slower (3 extra requests per product); billed the same per product.",
"default": false
},
"products": {
"title": "Products (details mode)",
"type": "array",
"description": "Details mode: Olive Young Global product numbers (GA240824996) or product URLs. Tip: take them from the productNo field of a best-sellers or search run.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Search and details modes: maximum number of products in total. Best sellers mode: top N of each chart (up to 100), so three categories at 100 return 300 products.",
"default": 100
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. The default Apify proxy works in most cases; switch to residential proxies if you see blocks.",
"default": {
"useApifyProxy": true
}
}
}
},
"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
}
}
}
}
}
}
}
}
}
}