# Olive Young Product Review Scraper

> Olive Young Product Review Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured customer reviews from Olive Young product pages, filterable by star rating and sort order

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/oliveyoung?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/olive-young-product-review-scraper-69882fb5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uCnpnrUn0gSQr8tLGkkSp

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability olive-young-product-review-scraper-69882fb5 -d '<json body>'
```

Example prompt: Pull the 50 most recent reviews from this Olive Young product page — https://www.oliveyoung.co.kr/store/goods/getGoodsDetail.do?goodsNo=A000000123456 — and only include 4-star and 5-star ratings.

## When to prefer this

Use this endpoint when you need structured review data from Olive Young (올리브영), the dominant Korean health and beauty retail platform. It handles both global and Korean-locale product URLs and product ID formats (prdtNo and goodsNo), supports filtering by star rating and sort order, and can batch across multiple products in one call. Prefer this over generic web scrapers when you specifically need Olive Young review data with clean, normalized fields.

## Known failure modes

- Invalid or inaccessible product URL returns empty items array
- Product ID not found on Olive Young returns zero results
- Rate limiting or anti-scraping measures may cause failed runs (not charged)
- Non-Olive Young URLs passed in productUrls will return no results
- maxItems or maxReviewsPerProduct set to 0 with a very large product may hit the 50,000-review safeguard

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

A JSON object containing a count of retrieved reviews and an array of review items, each with fields for store, rating (1-5), review ID, product ID, product URL, review date, review text, and product name. Failed or empty runs are not charged.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "sortBy": {
   "enum": [
    "recent",
    "helpful",
    "highest",
    "lowest"
   ],
   "type": "string",
   "default": "recent",
   "description": "Order used to retrieve reviews. Determines which reviews arrive first when a limit is set."
  },
  "maxItems": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "Stop after this many reviews across all products. Set 0 for no total cap."
  },
  "starRating": {
   "type": "array",
   "items": {
    "enum": [
     "5",
     "4",
     "3",
     "2",
     "1"
    ],
    "type": "string",
    "enumTitles": [
     "5 stars",
     "4 stars",
     "3 stars",
     "2 stars",
     "1 star"
    ]
   },
   "default": [],
   "description": "Return only selected star ratings. Leave empty to include all ratings. Korean reviews are filtered as pages are read."
  },
  "productUrls": {
   "type": "array",
   "description": "Global product links with prdtNo, Korean product links with goodsNo, or bare GA and A product IDs. At least one is required."
  },
  "maxReviewsPerProduct": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Maximum reviews returned for each product. Set 0 to collect all available reviews, subject to a 50,000 review safeguard."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "store": null,
    "rating": null,
    "reviewId": null,
    "productId": null,
    "productUrl": null,
    "reviewDate": null,
    "reviewText": null,
    "productName": null
   }
  ],
  "product": "oliveyoung"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/olive-young-product-review-scraper-69882fb5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)