{ "openapi": "3.0.1", "info": { "title": "Coupang Scraper: Products, Prices, Rocket Delivery", "description": "Scrape Coupang searches, categories and product links from coupang.com in Korea: five orders, price bands and related searches past the first 60 cards. Get price, base price, discount, unit price, rating, Rocket delivery badges, rank and sponsored flag. No login; JSON, CSV or Excel; pay per product.", "version": "0.1", "x-build-id": "SfM36d9aGveh8DeBK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation_craft~coupang-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation_craft-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/automation_craft~coupang-scraper/runs": { "post": { "operationId": "runs-sync-automation_craft-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/automation_craft~coupang-scraper/run-sync": { "post": { "operationId": "run-sync-automation_craft-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", "properties": { "searchTerms": { "title": "Search words", "type": "array", "description": "Words to search on Coupang, one search per entry, in Korean or English (노트북, 커피, airpods). Each search is read once per order set below (Coupang shows visitors who are not logged in the first 60 products of a search; more orders and price bands read more). Each search delivers up to Max products per search.", "items": { "type": "string" } }, "startUrls": { "title": "Coupang links", "type": "array", "description": "Links copied from coupang.com: a search page (https://www.coupang.com/np/search?q=노트북&sorter=salePriceAsc), a category page (https://www.coupang.com/np/categories/497135) or a campaign page (https://www.coupang.com/np/campaigns/1440) with the filters and order Coupang put in the link, Coupang Global (https://www.coupang.com/np/coupangglobal, read like a category), a seller store (https://shop.coupang.com/vid/A00996727, the store link a product page names: every product of the store, 20 a page, in each order), a Best 100 list (https://www.coupang.com/np/best100/bestseller, 30 products in Coupang's own order), today's new products (https://www.coupang.com/np/todayopen, 48 products), the seller deals (https://www.coupang.com/np/omp, 30 deals), Goldbox deals (https://www.coupang.com/np/goldbox, 100 deals with their member price, time left and share sold), or a product page (https://www.coupang.com/vp/products/8708162122?itemId=25288657822&vendorItemId=95393316330, m.coupang.com product links too).", "items": { "type": "string" } }, "categories": { "title": "Category ids", "type": "array", "description": "Coupang category ids: the digits of a category link (497135 in coupang.com/np/categories/497135). Each category is read page by page, up to its last page (Coupang links 17 pages of 60 at most).", "items": { "type": "string" } }, "mainCategories": { "title": "Main categories", "type": "array", "description": "Coupang's main categories from its top menu, picked by name; each is read like a category id (the id is shown beside its name).", "items": { "type": "string", "enum": [ "fashion", "beauty", "babyKids", "food", "kitchen", "household", "homeInterior", "electronics", "sportsLeisure", "automotive", "booksMusicDvd", "toysHobbies", "stationeryOffice", "pets", "healthFood" ], "enumTitles": [ "Fashion (패션의류/잡화), 564653", "Beauty (뷰티), 176522", "Baby and kids (출산/유아동), 221934", "Food (식품), 194276", "Kitchen (주방용품), 185669", "Household (생활용품), 115673", "Home interior (홈인테리어), 184555", "Electronics and digital (가전디지털), 178255", "Sports and leisure (스포츠/레저), 317778", "Car accessories (자동차용품), 184060", "Books, music, DVD (도서/음반/DVD), 317777", "Toys and hobbies (완구/취미), 317779", "Stationery and office (문구/오피스), 177295", "Pet supplies (반려동물용품), 115674", "Health food (헬스/건강식품), 305798" ] } }, "productUrls": { "title": "Product links or ids", "type": "array", "description": "Product links (coupang.com/vp/products/, with or without itemId and vendorItemId) or bare product ids. Each is read from its own product page and delivered with its Product details, billed as one Product and one Product details. An id Coupang does not have gets a free status row.", "items": { "type": "string" } }, "sortBy": { "title": "Orders", "type": "array", "description": "Coupang's own orders. Each search and category is read once per order picked; every product is delivered once, in the first order that found it. Left out: Coupang ranking for search words and categories, and the link's own order for links. Picking all five reads about three times as many products of a search as one order.", "items": { "type": "string", "enum": [ "ranking", "lowestPrice", "highestPrice", "bestSelling", "newest" ], "enumTitles": [ "Coupang ranking (쿠팡 랭킹순)", "Lowest price (낮은가격순)", "Highest price (높은가격순)", "Best selling (판매량순)", "Newest (최신순)" ] } }, "minPrice": { "title": "Minimum price (won)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "In Korean won. Sent to Coupang and checked again on each row's sale price." }, "maxPrice": { "title": "Maximum price (won)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "In Korean won. Sent to Coupang and checked again on each row's sale price." }, "minRating": { "title": "Minimum rating", "enum": [ "1", "2", "3", "4" ], "type": "string", "description": "Coupang's own rating filter, checked again on each row's rating." }, "deliveryTypes": { "title": "Delivery types", "type": "array", "description": "Coupang's own delivery filters. Rocket, Rocket Luxury, Coupang Global and free shipping are checked again on each row.", "items": { "type": "string", "enum": [ "rocket", "rocketLuxury", "coupangGlobal", "freeShipping", "topBrand" ], "enumTitles": [ "Rocket delivery (로켓배송)", "Rocket Luxury (로켓럭셔리)", "Coupang Global, Rocket Direct (로켓직구)", "Free shipping (무료배송)", "Top brands (탑브랜드)" ] } }, "offerConditions": { "title": "Offer conditions", "type": "array", "description": "Coupang's own offer condition filter.", "items": { "type": "string", "enum": [ "new", "used", "refurbished", "returned", "packageDamaged", "repackaged" ], "enumTitles": [ "New (새 상품)", "Used (중고)", "Refurbished (리퍼)", "Returned (반품)", "Damaged box (박스 훼손)", "Repackaged (재포장)" ] } }, "brands": { "title": "Brands", "type": "array", "description": "Brand names as Coupang's brand filter lists them for a search or category (맥심, 삼성전자, Apple), or brand ids. Each name is looked up in the brand list of that search's or category's own page; a brand Coupang does not list there gets a free row naming the brands it does list.", "items": { "type": "string" } }, "attributeFilters": { "title": "Attribute filters", "type": "array", "description": "Other filters Coupang's search page offers for a search or category, written \": \" as the page shows them (총 수량: 100개 이하, 색상: 블랙). Each is looked up in that page's own filter list; one Coupang does not list there gets a free row naming the filters it does list. The same name twice means either value.", "items": { "type": "string" } }, "splitByPriceBands": { "title": "Read price bands too", "type": "boolean", "description": "Each search and category is also read in each price band Coupang offers for it (about five bands), in every order picked: up to six times the products of one search. Products found twice are delivered once.", "default": false }, "includeRelatedSearches": { "title": "Related searches too", "type": "boolean", "description": "Also searches the related searches Coupang lists under each search word (연관검색어, up to 10 per word, one level), each with the same orders, filters and limits. Their rows carry the word that led to them.", "default": false }, "includeSuggestedSearches": { "title": "Search the suggestions too", "type": "boolean", "description": "Also searches the suggestions Coupang's search box gives for each search word (one level, at most 10 a word), with the same filters, orders and limits; each search word's coverage row lists them. Products found that way carry the word they came from in source.relatedTo. Not read while Coupang refuses the run's direct requests.", "default": false }, "includeSponsored": { "title": "Include sponsored products", "type": "boolean", "description": "Sponsored products (Coupang's ads among the results) are delivered with sponsored: true and their place on the page. Off: they are left out, free. Under a brand, offer condition, attribute, top brand or category in a search filter a sponsored product is always left out, free, since ads do not follow those filters.", "default": true }, "oneRowPerProduct": { "title": "One row per product", "type": "boolean", "description": "Coupang lists each option of a product (size, colour, seller) as its own card. Off (default): one row per card. On: one row per product, the first card found.", "default": false }, "maxItemsPerSearch": { "title": "Max products per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The most products each search word, link or category delivers (default 100)." }, "maxItems": { "title": "Max products in all", "minimum": 1, "maximum": 100000, "type": "integer", "description": "The most products the whole run delivers (left out: no limit beyond the per search one)." }, "maxPagesPerCategory": { "title": "Max pages per category", "minimum": 1, "maximum": 17, "type": "integer", "description": "The most pages read per category and order (Coupang links 17 pages of 60)." }, "includeDetails": { "title": "Product details", "type": "boolean", "description": "Reads each delivered product's own page (one Product details event each): brand, seller and seller rating, other seller count, every option with its own price and stock, price per quantity step, member and card prices, category path, all images, the product information notice (model, KC certification, maker, country of origin), description, delivery and return terms, cashback and coupons. A page that could not be read is free.", "default": false }, "includePersonalData": { "title": "Seller business information", "type": "boolean", "description": "With Product details: adds the seller's business information Coupang shows on the product page (business name, representative, phone, e-mail, address, business and mail order numbers). Some sellers are sole traders, so this can name a person: you are responsible for a lawful use, GDPR and Korea's PIPA included. Off by default.", "default": false }, "maxConcurrency": { "title": "Parallel lanes", "minimum": 1, "maximum": 2, "type": "integer", "description": "Searches or categories read at once (1 or 2, default 2)." }, "requestTimeoutSecs": { "title": "Request timeout", "minimum": 10, "maximum": 60, "type": "integer", "description": "How long one request may take (default 30 s)." }, "maxRequestRetries": { "title": "Retries", "minimum": 1, "maximum": 5, "type": "integer", "description": "Attempts per request after Coupang answered without a usable page (default 3). A refused exit is replaced by a fresh one at once." }, "requestDelaySecs": { "title": "Delay between requests", "minimum": 0, "maximum": 10, "type": "integer", "description": "The least time between two requests of one lane (default 0: the Actor's own pace of about one request every 1.5 seconds per lane)." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave as is: the Actor uses Apify residential addresses in South Korea, the only ones Coupang answers. Your own Korean proxy links are used for every request when you give them." }, "resumeFromRunId": { "title": "Resume an earlier run", "type": "string", "description": "The run id of an earlier run of this Actor with the same input (the id in the run's page address). Searches and categories that run read in full are skipped, and the others skip the products they delivered there; nothing skipped is charged. Use it after a run stopped at a limit or an abort." } } }, "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 } } } } } } } } } }