# Kurly product list scraper

You can extract product listings (including product names, links, prices, etc.) from Kruly.

- Template page: [https://www.octoparse.com/template/kurly-product-list](https://www.octoparse.com/template/kurly-product-list)
- Categories: E-Commerce
- Status: `PUBLISHED`
- Run mode: `BOTH`

## Pricing

Free.

## What is an Octoparse template?

An Octoparse template is a ready-to-use scraping workflow with predefined inputs and structured outputs. Use the exact parameter keys below; do not invent parameters.

## Overview

This ready-to-use template collects structured data from listing pages.

## Output

The current workflow extracts 10 fields, including `가격`, `건수`, `리뷰수`, `배송내역`, `이미지_링크`, `제품명`, `제품소개`, `컬리온리`, `키워드`, `할인율`.

## Use Cases

- Use structured results for research, comparison, and monitoring.
- Collect rows without building the extraction workflow from scratch.
- Combine results with other templates for downstream enrichment.
- Review a representative result before starting a large batch.

## Why Octoparse

- **No coding required:** complete keyword(up to 20) and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### keyword(up to 20)

Required. keyword Constraints: minItems=1; maxItems=20; items.minLength=1; items.maxLength=1000.

## How to Use

## Kurly product list scraper

Extract product listings (names, links, prices, etc.) from [Kurly](https://www.kurly.com/).

### Pricing

This template currently has no per-line charge.

### Output fields

- `키워드`
- `건수`
- `제품명`
- `제품소개`
- `이미지_링크`
- `가격`
- `할인율`
- `리뷰수`
- `배송내역`
- `컬리온리`

### Input

- **keyword(up to 20)** (required): Enter one or more values, one per line.

### How to use

1. Open the template and select **Try it** or **Start**.
2. Complete the input fields.
3. Choose a local or cloud run.
4. Review the output rows and export or process the structured data.

### Limitations

- Collects only what Kurly displays on listing pages.
- `리뷰수`, `배송내역`, and `컬리온리` may be empty when the source record does not provide them.

### Tips

- Start with one or a few inputs and review the returned rows before scaling.
- Use the most specific valid keyword(up to 20) to reduce unrelated or duplicate records.
- Use a stable identifier from `키워드`, `건수`, `제품명`, `제품소개`, `이미지_링크`, `가격`, `할인율`, `리뷰수`, `배송내역`, or `컬리온리` as the deduplication key when available.

## Limitations

Results depend on what the source site exposes at run time. Fields may be empty when a source page does not provide a value. The template enforces the input limits shown above.

## Tips

Use specific, valid inputs and review a representative result before starting a large batch. Remove duplicate inputs when repeated records are not needed.

## FAQ

### What do I need to enter?

Use the exact inputs and limits listed above.

### What data does this template return?

See Output Schema below; availability can vary by source record.

### How is usage billed?

See the Pricing section above for current pricing and billing details.

## Related Templates

- [Ali Express Product List Scraper(Korean Version)](https://www.octoparse.com/template/ali-express-product-list-scraper-for-korea)
- [Gmarket Product List Scraper](https://www.octoparse.com/template/gmarket-product-list-scraper)
- [11st Product List Scraper](https://www.octoparse.com/template/11st-product-list-scraper)
- [Lipcosme Product List Scraper](https://www.octoparse.com/template/lipcosme-product-list-scraper)
- [SSG Product List Scraper](https://www.octoparse.com/template/ssg-product-list-scraper)

## Input Schema

```json
{
  "title": "Kurly product list scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keyword": {
      "title": "keyword(up to 20)",
      "description": "keyword",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 1000
      },
      "minItems": 1,
      "maxItems": 20,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keyword"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keyword": [
    "말차"
  ]
}
```

Example 2

```json
{
  "keyword": [
    "말차"
  ]
}
```

Example 3

```json
{
  "keyword": [
    "말차"
  ]
}
```

Example 4

```json
{
  "keyword": [
    "말차"
  ]
}
```

Example 5

```json
{
  "keyword": [
    "말차"
  ]
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "가격": {
      "type": "string",
      "description": ""
    },
    "건수": {
      "type": "string",
      "description": ""
    },
    "리뷰수": {
      "type": "string",
      "description": ""
    },
    "배송내역": {
      "type": "string",
      "description": ""
    },
    "이미지_링크": {
      "type": "string",
      "description": ""
    },
    "제품명": {
      "type": "string",
      "description": ""
    },
    "제품소개": {
      "type": "string",
      "description": ""
    },
    "컬리온리": {
      "type": "string",
      "description": ""
    },
    "키워드": {
      "type": "string",
      "description": ""
    },
    "할인율": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Kurly product list scraper output",
  "description": "Initial output fields derived from the current published implementation. Field descriptions are maintained by Data Center; production field names and types should be refreshed from recent successful runs.",
  "additionalProperties": false
}
```

## Output Example

Example 1

```json
{
  "가격": "4,900",
  "건수": "342",
  "리뷰수": "999+",
  "배송내역": "샛별배송",
  "이미지_링크": "https://img-cf.kurly.com/hdims/resize/%5E%3E360x%3E468/cropcenter/360x468/quality/85/src/shop/data/goods/1589872508261l0.jpg",
  "제품명": "[호라] 제주 말차 파우더 300g",
  "제품소개": "",
  "컬리온리": "Kurly Only",
  "키워드": "말차",
  "할인율": "37%"
}
```

Example 2

```json
{
  "가격": "4,900",
  "건수": "340",
  "리뷰수": "999+",
  "배송내역": "샛별배송",
  "이미지_링크": "https://img-cf.kurly.com/hdims/resize/%5E%3E360x%3E468/cropcenter/360x468/quality/85/src/shop/data/goods/1589872508261l0.jpg",
  "제품명": "[호라] 제주 말차 파우더 300g",
  "제품소개": "",
  "컬리온리": "Kurly Only",
  "키워드": "말차",
  "할인율": "37%"
}
```

Example 3

```json
{
  "가격": "4,900",
  "건수": "346",
  "리뷰수": "999+",
  "배송내역": "샛별배송",
  "이미지_링크": "https://img-cf.kurly.com/hdims/resize/%5E%3E360x%3E468/cropcenter/360x468/quality/85/src/shop/data/goods/1589872508261l0.jpg",
  "제품명": "[호라] 제주 말차 파우더 300g",
  "제품소개": "",
  "컬리온리": "Kurly Only",
  "키워드": "말차",
  "할인율": "37%"
}
```

Example 4

```json
{
  "가격": "4,900",
  "건수": "344",
  "리뷰수": "999+",
  "배송내역": "샛별배송",
  "이미지_링크": "https://img-cf.kurly.com/hdims/resize/%5E%3E360x%3E468/cropcenter/360x468/quality/85/src/shop/data/goods/1589872508261l0.jpg",
  "제품명": "[호라] 제주 말차 파우더 300g",
  "제품소개": "",
  "컬리온리": "Kurly Only",
  "키워드": "말차",
  "할인율": "37%"
}
```

Example 5

```json
{
  "가격": "4,900",
  "건수": "337",
  "리뷰수": "999+",
  "배송내역": "샛별배송",
  "이미지_링크": "https://img-cf.kurly.com/hdims/resize/%5E%3E360x%3E468/cropcenter/360x468/quality/85/src/shop/data/goods/1589872508261l0.jpg",
  "제품명": "[호라] 제주 말차 파우더 300g",
  "제품소개": "",
  "컬리온리": "Kurly Only",
  "키워드": "말차",
  "할인율": "37%"
}
```

## API

`POST https://openapi.octoparse.com/api/agentTools/executeTask`

This is the OpenAPI Agent Tools `executeTask` endpoint. Authenticate with a Bearer token.

Request body:

`templateName` is the template slug; `parameters` is a JSON object string whose keys match Input Schema; `taskName`, `idempotencyKey`, and `maxCollectedRows` are optional.

Obtain a token:

```http
POST https://openapi.octoparse.com/token
Content-Type: application/json

{
  "username": "YOUR_USERNAME",
  "password": "YOUR_PASSWORD",
  "grant_type": "password"
}
```

Use `data.access_token` as `Authorization: Bearer <token>`. After starting, poll `getTaskStatus` and export with `exportData`.

```json
{
  "templateName": "kurly-product-list",
  "taskName": "Kurly product list scraper",
  "parameters": "{\"keyword\":[\"말차\"]}"
}
```

## Python Example

```python
import json
import requests

OPENAPI_BASE = "https://openapi.octoparse.com"
ACCESS_TOKEN = "YOUR_ACCESS_TOKEN"

parameters = json.loads("{\"keyword\":[\"말차\"]}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "kurly-product-list",
        "taskName": "Kurly product list scraper",
        "parameters": json.dumps(parameters, ensure_ascii=False),
    },
    timeout=60,
)
print(response.status_code)
print(response.json())
```

## HTTP/cURL Example

```bash
curl -X POST "https://openapi.octoparse.com/api/agentTools/executeTask" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "templateName": "kurly-product-list",
  "taskName": "Kurly product list scraper",
  "parameters": "{\"keyword\":[\"말차\"]}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `kurly-product-list`, inspect its inputs, create a cloud task with the exact Input Schema keys, and export JSON results.

## Machine-readable Resources

- [Template contract](https://www.octoparse.com/templates/kurly-product-list.json)
- [Manifest](https://www.octoparse.com/templates/kurly-product-list-manifest.json)