# Coupang Review Scraper - Reviews, Photos, Ratings to JSON (`zen-studio/coupang-review-scraper`) Actor Scrape product reviews from Coupang (쿠팡). Get every content review (text and/or reviewer photos and videos) plus a per-product rating summary, exported to JSON, CSV, or Excel. Filter by star rating, keyword, or photos and videos. No code and no login required. - **URL**: https://apify.com/zen-studio/coupang-review-scraper.md - **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community) - **Categories:** E-commerce - **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.99 / 1,000 reviews This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Coupang Review Scraper (쿠팡) | Korean Product Reviews, Ratings, Photos & Videos (2026) ![Coupang review scraper output: star rating, review title and text, helpful-vote counts and reviewer photos as structured JSON](https://iili.io/C5m3Jz7.png)
1,000 Coupang reviews a minute, each rich with text, photos, videos, ratings, and reviewer details.
Give it a Coupang product URL or a bare product ID and get back that product's content reviews as structured JSON: every review with written text, photos, or video, plus a per-product **rating summary** (total count, 1-to-5 star distribution, photo and video totals). Empty star-only ratings, roughly 93% of reviews on a typical product, are filtered out so every record you pay for actually says something. #### Copy to your AI assistant ```` zen-studio/coupang-review-scraper on Apify. Returns a Coupang product's content reviews (text, photos, videos) plus a rating summary. Call ApifyClient("TOKEN").actor("zen-studio/coupang-review-scraper").call(run\_input={...}), then client.dataset(run\["defaultDatasetId"]).list\_items().items. Requires productUrls; dataset rows are keyed by recordType ("summary" or "review"). Full spec: GET https://api.apify.com/v2/acts/zen-studio~coupang-review-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Token: https://console.apify.com/account/integrations ```` ### Key Features - **42 fields per review**: rating, title, full text, helpful-vote counts, reviewer photos and videos, reviewer name, seller, item name and image, timestamps, and more. - **Content reviews only**: star-only ratings with no text and no media are dropped automatically. No noise to clean up afterward. - **Filter the way you need**: by star rating, by keyword (best in Korean), by newest or most-helpful order, or photos and videos only. - **Rating summary per product**: total count plus the full 1-to-5 star breakdown and photo/video totals in a single record. - **Free tier**: 10 runs, up to 20 reviews per product, no credit card required. ### How to Scrape Coupang Reviews Paste one or more Coupang product page URLs, or bare numeric product IDs, into `productUrls`. Everything else is optional. #### Basic: all content reviews for a product ```json { "productUrls": ["https://www.coupang.com/vp/products/6135671310"] } ```` #### Newest reviews with photos or videos ```json { "productUrls": ["6135671310"], "sort": "newest", "photosVideosOnly": true } ``` #### Only 1 and 2-star reviews (complaint audit) ```json { "productUrls": ["6135671310"], "starRatings": ["1", "2"] } ``` #### Reviews mentioning a keyword ```json { "productUrls": ["6135671310"], "keyword": "배송" } ``` The `keyword` filter matches the review text and works best in Korean (the language most Coupang reviews are written in). When a keyword is set it takes precedence over `starRatings`. ### Input Parameters | Parameter | Type | Default | Description | |-----------|------|---------|-------------| | `productUrls` | array | *required* | Coupang product page URLs or bare numeric product IDs to scrape reviews from. | | `maxReviewsPerProduct` | integer | *all* | Stop after this many reviews per product. Use this to cap cost and run time. Leave empty to return as many as available. | | `sort` | string | `newest` | Order reviews by `newest` first or by `best` (most-helpful) ranking. | | `starRatings` | array | *all* | Only return reviews with these star ratings (`1`-`5`). Leave empty for all ratings. Ignored when a keyword is set. | | `keyword` | string | *none* | Only return reviews whose text mentions this keyword. Works best in Korean. Takes precedence over `starRatings`. | | `photosVideosOnly` | boolean | `false` | Only return reviews that include reviewer photos or videos. | ### What Data Can You Extract from Coupang? The actor writes a single dataset with two record types, keyed by the `recordType` field: one `summary` per product and one `review` per content review (42 fields each). Both are shown in full below. #### Coverage: how many reviews you get - **Products up to ~3,000 reviews**: every content review, in full. - **Larger products (for example 20,000+ reviews)**: a deep content sample, the large majority of content reviews, not literally every single one. - **Star-only ratings** (no text, no media) are always excluded. On a typical product that is around 93% of all reviews, which is why the `review` count is far smaller than `totalCount`. #### Output Example: summary record ```json { "recordType": "summary", "productId": "6135671310", "totalCount": 20693, "ratingSummary": { "ratingCount": 20693, "ratingAverage": 5.0, "ratingScore": "4.9", "ratingSummaries": [ { "id": 139186829, "productId": 6135671310, "rating": 5, "count": 18878, "percentage": 92 }, { "id": 139197697, "productId": 6135671310, "rating": 4, "count": 1152, "percentage": 5 }, { "id": 140868837, "productId": 6135671310, "rating": 3, "count": 342, "percentage": 1 } // ... 2 more (2-star, 1-star) ] }, "attachedImageSummary": { "totalImageCount": 1522, "attachedImageInfos": [ { "reviewId": 852903378, "imgSrcThumbnail": "https://thumbnail.coupangcdn.com/thumbnails/local/320/image2/PRODUCTREVIEW/202602/27/.../2301bc13.jpg", "imgSrcOrigin": "https://thumbnail.coupangcdn.com/thumbnails/local/q-1/image2/PRODUCTREVIEW/202602/27/.../2301bc13.jpg", "productReview": { "reviewId": 852903378, "title": "정품의 안정성과 기본에 가장충실한 아이폰용 충전 케이블", "content": "Apple 정품 Lightning-to-USB-C 케이블 ...", "displayName": "전*현" } } // ... 29 more photo previews, each with the full attached review ] }, "attachedVideoSummary": { "attachedVideoInfos": [ { "id": 191280795, "attachmentType": "VIDEO", "videoUrl": "https://video.coupangcdn.com/cloud/PRODUCTREVIEW/.../transcode/origin.m3u8", "videoThumbnailUrl": "https://video.coupangcdn.com/cloud/PRODUCTREVIEW/.../origin_thumbnail.0000001.jpg", "duration": 11, "width": 320, "height": 568, "reviewId": 853243986, "status": "VERIFIED", "productReview": { "reviewId": 853243986, "title": "", "content": "애플 정품 C타입 충전 케이블은 역시 ..." } } ], "metadata": { "size": 30, "totalElements": 1, "totalPages": 1, "currentPage": 0, "filterDuplicates": false }, "videoPlayInfo": { "authCookies": {}, "lastModified": 0 } } } ``` #### Output Example: review record (all 42 fields) ```json { "recordType": "review", "productId": "6135671310", "reviewId": 848527804, "rating": 1, "title": "정품^^충전기^^", "content": "산지 3일만에 이렇게됐어여^^방금 프리스비에서 정품 구매했는데 ...", "reviewAt": 1771252360000, "createdAt": 1771234769000, "locale": "ko", "helpfulCount": 3, "helpfulTrueCount": 3, "helpfulFalseCount": 0, "commentCount": 0, "userHelpfulExist": false, "userHelpfulTrueExist": false, "userHelpfulFalseExist": false, "displayName": "황*연", "displayWriter": "Actual buyer", "displayNameToken": "AZSEcPDK8djHslTXIm5/GnpgBpEh6fhI6u01MmnQbuOOR/c=", "realNameGranted": false, "blinded": false, "blockedUser": false, "myReview": false, "member": { "type": "USER", "id": "157650436", "name": "황*연", "email": "hsy******@nate.com", "nameToken": "AZSEcPDK8djHslTXIm5/GnpgBpEh6fhI6u01MmnQbuOOR/c=", "emailToken": "ATJIcDfo9Preeyc0EXi02E/Qi1YHLY2P8KV3Jbpke9+5gGnTNRSw" }, "reviewerBadges": [], "reviewerDisplayImage": { "displayImageBlinded": false, "displayImagePrivate": false }, "reviewSurveyAnswers": [], "attachments": [ { "id": 189434213, "reviewId": 848527804, "ordering": 0, "attachmentType": "IMAGE", "caption": "", "imgSrcThumbnail": "https://thumbnail.coupangcdn.com/thumbnails/local/320/image2/PRODUCTREVIEW/202602/16/.../d73d875b.jpg", "imgSrcOrigin": "https://thumbnail.coupangcdn.com/thumbnails/local/q-1/image2/PRODUCTREVIEW/202602/16/.../d73d875b.jpg", "uploadedFilePath": "image2/PRODUCTREVIEW/202602/16/7544398905844330824/d73d875b.jpg" } // ... 1 more photo ], "videoAttachments": [], "attachmentsBlinded": false, "coupangChallengeReview": false, "itemName": "Apple Lightning USB-C 1m cable, MUQ93FE/A, 1 unit, 1 m", "itemImagePath": "https://thumbnail.coupangcdn.com/thumbnails/remote/640x640/image/vendor_inventory/a6df/698c2bcf...png", "itemId": 26739810964, "vendorId": "A01524600", "vendorItemId": 94735750675, "completedOrderVendorItemId": 20616836191, "orderId": 5100170669022, "isTravelProduct": false, "vendor": { "description": [ { "text": "Seller:", "color": "#888888", "bold": false, "size": 15, "strikethrough": false }, { "text": "올픽스", "color": "#888888", "bold": false, "size": 15, "strikethrough": false } ] }, "titleHighlighting": {}, "contentHighlighting": {} } ``` Reviewer names and emails arrive masked by Coupang (`황*연`, `hsy******@nate.com`). The actor keeps every field exactly as published. ### Advanced Usage Ready-made configurations for complaint audits, keyword research, most-helpful review mining, photo and video collection, and bulk multi-product runs. #### Complaint audit: low-star reviews with evidence ```json { "productUrls": ["6135671310"], "starRatings": ["1", "2"], "photosVideosOnly": true } ``` #### Most-helpful reviews first ```json { "productUrls": ["6135671310"], "sort": "best", "maxReviewsPerProduct": 200 } ``` #### Keyword research across a topic ```json { "productUrls": ["6135671310"], "keyword": "충전", "sort": "best" } ``` #### Bulk: several products in one run ```json { "productUrls": [ "https://www.coupang.com/vp/products/6135671310", "7891234567", "https://www.coupang.com/vp/products/2345678901" ], "sort": "newest" } ``` ### Pricing: Pay Per Event (PPE) **$4.99 per 1,000 reviews** (Apify Store subscription discounts lower this to $4.29 on Silver and $3.99 on Gold). You pay only for `review` records delivered. The per-product `summary` record is free, and products with no content reviews cost nothing. | Reviews delivered | Cost | |-------------------|------| | 100 | $0.50 | | 500 | $2.50 | | 1,000 | $4.99 | **Free tier:** 10 runs, up to 20 reviews per product, no credit card required. ### FAQ **What is Coupang (쿠팡)?** Coupang is South Korea's largest online marketplace, often described as the Amazon of Korea. Shoppers leave star ratings, written reviews, and photo and video reviews on each product page. This actor turns those reviews for any product into structured JSON. **What counts as a "content review", and why are star-only ratings excluded?** A content review has written text, reviewer photos, or reviewer videos. Star-only ratings carry no information beyond the number, and on a typical product they are around 93% of all reviews. The actor keeps only content reviews so you do not pay for or sift through empty entries. The full star distribution is still available in the `summary` record's `ratingSummary`. **How many reviews can I get per product?** For products up to about 3,000 reviews, you get every content review. For very large products (20,000+ reviews), you get a deep content sample, the large majority of content reviews rather than literally every one. Star-only ratings are always excluded, so the `review` count is much smaller than `totalCount`. **Can I filter by star rating, keyword, or photos and videos?** Yes. Use `starRatings` to keep only certain star levels, `keyword` to keep only reviews whose text mentions a term (best in Korean), and `photosVideosOnly` to keep only reviews with photos or videos. A keyword takes precedence over star ratings. **What language are the reviews in?** Most Coupang reviews are written in Korean, and the `content`, `title`, and reviewer names are returned exactly as published. The `keyword` filter therefore works best with Korean terms. **What is the difference between the `summary` and `review` records?** Each product produces one `summary` record (totals, the full star distribution, photo and video galleries) and many `review` records (one per content review). Filter the dataset on `recordType` to separate them. **Do I need a Coupang account or cookies?** No. Provide a product URL or ID and run it. No account, login, or cookie export is involved. **How do I export the data?** Download from the run's Storage tab as JSON, CSV, Excel, XML, or HTML, or pull it through the Apify API. JSON preserves the nested `member`, `vendor`, `attachments`, and `ratingSummary` objects best. **How fresh is the data?** Reviews are read live each run, so you get the current state of the product's reviews at the moment you run the actor. **What is the free tier?** 10 runs total, each capped at 20 reviews per product, with no credit card required. Upgrade to a paid plan for full review counts and unlimited runs. **Is it legal to scrape Coupang reviews?** The actor reads only publicly visible review data, nothing behind a login. You are responsible for complying with Coupang's terms of service and applicable data protection law, including the GDPR, CCPA, and South Korea's PIPA. Reviews contain personal data such as reviewer display names and masked contact tokens, so handle and store the output accordingly. ### Support - **Bugs**: Issues tab - **Features**: Issues tab ### Legal Compliance Extracts publicly available data. Users must comply with Coupang's terms and applicable data protection regulations, including the GDPR, CCPA, and South Korea's Personal Information Protection Act (PIPA). ### More Zen Studio scrapers **🎬 Short-video & social** - **RedNote 小红书** - [RedNote Search Scraper](https://apify.com/zen-studio/rednote-search-scraper) - [RedNote User Profile Scraper](https://apify.com/zen-studio/rednote-user-profile-scraper) - [RedNote Comments Scraper](https://apify.com/zen-studio/rednote-comments-scraper) - [RedNote Product Search Scraper](https://apify.com/zen-studio/rednote-product-search-scraper) - [RedNote Note Detail Scraper](https://apify.com/zen-studio/rednote-note-detail-scraper) - [RedNote Product Reviews Scraper](https://apify.com/zen-studio/rednote-product-reviews-scraper) - [RedNote Live Recorder](https://apify.com/zen-studio/rednote-live-recorder) - **Douyin 抖音** - [Douyin Search Scraper](https://apify.com/zen-studio/douyin-search-scraper) - [Douyin Profile Scraper](https://apify.com/zen-studio/douyin-profile-scraper) - [Douyin Video Scraper](https://apify.com/zen-studio/douyin-video-scraper) - [Douyin Comments Scraper](https://apify.com/zen-studio/douyin-comments-scraper) - [Douyin Transcripts Scraper](https://apify.com/zen-studio/douyin-transcripts-scraper) - [Douyin Creator Rankings Scraper](https://apify.com/zen-studio/douyin-xingtu-rankings-scraper) - [Douyin Live Recorder](https://apify.com/zen-studio/douyin-live-recorder) - [Douyin Hot Search Scraper](https://apify.com/zen-studio/douyin-hot-search-scraper) - [Douyin Product Search Scraper](https://apify.com/zen-studio/douyin-product-search-scraper) - **Xigua 西瓜视频** - [Xigua Video Search Scraper](https://apify.com/zen-studio/xigua-video-search-scraper) - [Xigua Video Detail Scraper](https://apify.com/zen-studio/xigua-video-detail-scraper) - **Bilibili 哔哩哔哩** - [Bilibili Video Scraper](https://apify.com/zen-studio/bilibili-video-scraper) - [Bilibili Danmaku Scraper](https://apify.com/zen-studio/bilibili-danmaku-scraper) **🛒 E-commerce** - **Shopee** - [Shopee Product Detail Scraper](https://apify.com/zen-studio/shopee-product-detail-scraper) - [Shopee Product Reviews Scraper](https://apify.com/zen-studio/shopee-product-reviews-scraper) - [Shopee Product Scraper](https://apify.com/zen-studio/shopee-product-scraper) - **Taobao 淘宝** - [Taobao Search Scraper](https://apify.com/zen-studio/taobao-search-scraper) - [Taobao Product Detail Scraper](https://apify.com/zen-studio/taobao-detail-scraper) - [Taobao Seller Products Scraper](https://apify.com/zen-studio/taobao-seller-products-scraper) - **JD.com 京东** - [JD.com Search Scraper](https://apify.com/zen-studio/jd-com-search-scraper) - **1688 阿里巴巴** - [1688 Wholesale Scraper](https://apify.com/zen-studio/1688-wholesale-scraper) - [Alibaba Scraper](https://apify.com/zen-studio/alibaba-scraper) - **Goofish 闲鱼** - [Goofish (Xianyu) Search Scraper](https://apify.com/zen-studio/goofish-xianyu-search-scraper) - [Goofish (Xianyu) Seller Scraper](https://apify.com/zen-studio/goofish-xianyu-seller-scraper) - [Goofish (Xianyu) Item Detail Scraper](https://apify.com/zen-studio/goofish-xianyu-item-detail-scraper) - [Goofish (Xianyu) Item Comments & Q\&A Scraper](https://apify.com/zen-studio/goofish-xianyu-item-comments-scraper) **🏠 Real estate & autos** - **Anjuke 安居客** - [Anjuke For-Sale Listings Scraper](https://apify.com/zen-studio/anjuke-real-estate-scraper) - [Anjuke New-Home Scraper](https://apify.com/zen-studio/anjuke-new-home-scraper) - [Anjuke Rental Listings Scraper](https://apify.com/zen-studio/anjuke-rent-scraper) - [Anjuke Listing Detail Scraper](https://apify.com/zen-studio/anjuke-sale-detail-scraper) - **58.com 58同城** - [58.com Real Estate Scraper](https://apify.com/zen-studio/58-real-estate-scraper) - **Autohome 汽车之家** - [Autohome (Che168) Used-Car Scraper](https://apify.com/zen-studio/che168-car-scraper) ### From our friends at ClearPath - [Shein Product Scraper](https://apify.com/clearpath/shein-product-scraper) — Shein prices, sizes, fit, and variants - [Shopify Product Search](https://apify.com/clearpath/shop-by-shopify-product-scraper) — search products across any Shopify store by keyword - [Amazon Buy Box & Seller Offers](https://apify.com/clearpath/amazon-buybox-api) — Amazon buy box and seller-offer tracking *** *Coupang product reviews as structured JSON: text, photos, videos, ratings, and a per-product rating summary.* # Actor input Schema ## `productUrls` (type: `array`): Coupang product page URLs (or bare product IDs) to scrape reviews from. ## `maxReviewsPerProduct` (type: `integer`): Stop after this many reviews per product. Use this to cap cost and run time. Leave empty to return as many as available. ## `sort` (type: `string`): Order reviews by newest first or by Coupang's best / most-helpful ranking. ## `starRatings` (type: `array`): Only return reviews with these star ratings. Leave empty for all ratings. Ignored if a keyword is set. ## `keyword` (type: `string`): Only return reviews whose text mentions this keyword (works best in Korean). Takes precedence over star ratings. ## `photosVideosOnly` (type: `boolean`): Only return reviews that include reviewer photos or videos. ## Actor input object example ```json { "productUrls": [ "https://www.coupang.com/vp/products/6135671310" ], "sort": "newest", "photosVideosOnly": false } ``` # Actor output Schema ## `reviews` (type: `string`): Review records. Each row carries a `recordType` field: `"review"` for a content review (text and/or photo/video) and `"summary"` for the per-product rating summary. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "productUrls": [ "https://www.coupang.com/vp/products/6135671310" ] }; // Run the Actor and wait for it to finish const run = await client.actor("zen-studio/coupang-review-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "productUrls": ["https://www.coupang.com/vp/products/6135671310"] } # Run the Actor and wait for it to finish run = client.actor("zen-studio/coupang-review-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "productUrls": [ "https://www.coupang.com/vp/products/6135671310" ] }' | apify call zen-studio/coupang-review-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=zen-studio/coupang-review-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Coupang Review Scraper - Reviews, Photos, Ratings to JSON", "description": "Scrape product reviews from Coupang (쿠팡). Get every content review (text and/or reviewer photos and videos) plus a per-product rating summary, exported to JSON, CSV, or Excel. Filter by star rating, keyword, or photos and videos. No code and no login required.", "version": "0.0", "x-build-id": "ogwhMfvTqFaoJA5d4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~coupang-review-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-coupang-review-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/zen-studio~coupang-review-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-coupang-review-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/zen-studio~coupang-review-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-coupang-review-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": [ "productUrls" ], "properties": { "productUrls": { "title": "Product URLs or IDs", "type": "array", "description": "Coupang product page URLs (or bare product IDs) to scrape reviews from.", "items": { "type": "string" } }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "type": "integer", "description": "Stop after this many reviews per product. Use this to cap cost and run time. Leave empty to return as many as available." }, "sort": { "title": "Sort order", "enum": [ "newest", "best" ], "type": "string", "description": "Order reviews by newest first or by Coupang's best / most-helpful ranking.", "default": "newest" }, "starRatings": { "title": "Star ratings", "type": "array", "description": "Only return reviews with these star ratings. Leave empty for all ratings. Ignored if a keyword is set.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ] } }, "keyword": { "title": "Keyword", "type": "string", "description": "Only return reviews whose text mentions this keyword (works best in Korean). Takes precedence over star ratings." }, "photosVideosOnly": { "title": "Photos / videos only", "type": "boolean", "description": "Only return reviews that include reviewer photos or videos.", "default": false } } }, "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 } } } } } } } } } } ```