{ "openapi": "3.0.1", "info": { "title": "Coupang Scraper (쿠팡): Sellers, Products, Prices & Reviews", "description": "Scrape Coupang (쿠팡), Korea's largest marketplace. Pull a seller's whole store by ID, search results, category listings, product reviews, daily deals, and Korean keyword data. No login, no proxy setup. Five modes in one Actor.", "version": "0.0", "x-build-id": "ud6K0lqjftZmis9iD" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sourabhbgp~coupang-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sourabhbgp-coupang-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/sourabhbgp~coupang-scraper/runs": { "post": { "operationId": "runs-sync-sourabhbgp-coupang-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/sourabhbgp~coupang-scraper/run-sync": { "post": { "operationId": "run-sync-sourabhbgp-coupang-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": "What to scrape", "enum": [ "seller", "deals", "products", "reviews", "keywords" ], "type": "string", "description": "What to scrape. Seller: every product in one seller's store. Products: search results or a category listing. Reviews: customer reviews for a product. Deals: today's Goldbox deals, which needs no other input. Keywords: autocomplete and related search terms for a seed word." }, "vendorIds": { "title": "Seller IDs", "type": "array", "description": "Coupang seller IDs such as A00996727. A seller ID appears in any store link, for example https://shop.coupang.com/vid/A00996727", "items": { "type": "string" } }, "storeUrls": { "title": "Store URLs", "type": "array", "description": "Coupang store links. The seller ID is read from the link, so you can paste links instead of typing IDs.", "items": { "type": "string" } }, "sellerSort": { "title": "Sort the catalogue by", "enum": [ "POPULARITY", "LOW_PRICE", "HIGH_PRICE", "BEST_SELLING", "LATEST" ], "type": "string", "description": "These are the five orders Coupang itself supports for a store.", "default": "POPULARITY" }, "maxItemsPerSeller": { "title": "Max products per seller", "minimum": 1, "type": "integer", "description": "Stop after this many products for each seller.", "default": 1000 }, "includeSellerProfile": { "title": "Add the seller profile to every row", "type": "boolean", "description": "Adds the store name, rating and business contact details to each product row. It is repeated on every row so the data survives a CSV export.", "default": true }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Korean or English keywords. Coupang's search returns roughly 60 to 96 products per keyword and offers no further pages, so to collect more than that use a category URL below.", "items": { "type": "string" } }, "categoryUrls": { "title": "Category URLs", "type": "array", "description": "Coupang category links such as https://www.coupang.com/np/categories/497135 . Categories page properly and reach about 1,000 products each, so this is the way to collect large numbers.", "items": { "type": "string" } }, "sorter": { "title": "Sort results by", "enum": [ "scoreDesc", "bestAsc", "salePriceAsc", "salePriceDesc", "saleCountDesc", "latestAsc" ], "type": "string", "description": "Coupang uses different identifiers for search and for categories. Use bestAsc for a category and scoreDesc for a search term.", "default": "scoreDesc" }, "listSize": { "title": "Products per category page", "minimum": 2, "maximum": 120, "type": "integer", "description": "Only applies to category URLs. Coupang accepts up to 120 and returns nothing above that. The minimum is 2: at 1 Coupang returns a page containing only sponsored tiles, which reads as an empty category.", "default": 120 }, "productUrls": { "title": "Product URLs", "type": "array", "description": "Coupang product links, for example https://www.coupang.com/vp/products/6359373947 . A bare product ID also works.", "items": { "type": "string" } }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "Reviews can be collected to full depth, so a popular product can return many hundreds.", "default": 100 }, "reviewSort": { "title": "Sort reviews by", "enum": [ "RELEVANCE", "DATE_DESC" ], "type": "string", "description": "Coupang only honours these two orders for reviews.", "default": "RELEVANCE" }, "reviewRating": { "title": "Only this star rating", "minimum": 1, "maximum": 5, "type": "integer", "description": "Leave empty for all reviews. Coupang accepts one star value at a time, so pick a single number from 1 to 5." }, "seedKeywords": { "title": "Seed keywords", "type": "array", "description": "Each seed returns Coupang's 10 search suggestions plus the 10 related keywords shown on its results page.", "items": { "type": "string" } }, "maxItems": { "title": "Maximum results for the whole run", "minimum": 1, "type": "integer", "description": "Stop the run after this many result rows, across every seller, search term, product or keyword you gave. Leave it empty for no limit. Receipt rows explaining an input that returned nothing are never counted here and are never charged." } } }, "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 } } } } } } } } } }