# Gmarket Product List Scraper

Scrape product list information(product, image url, price, seller, etc.) from Gmarket by URL.

- Template page: [https://www.octoparse.com/template/gmarket-product-list-scraper](https://www.octoparse.com/template/gmarket-product-list-scraper)
- 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 general web pages.

## Output

The current workflow extracts 10 fields, including `구매량`, `만족도`, `상품`, `상품url`, `원래가격`, `이미지url`, `판매자`, `판매자url`, `평점참여수`, `현재가격`.

## 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 Keywords (up to 100 lines), Pagination and start the template in local or cloud mode.
- **Flexible export:** review and export results as CSV, Excel, or JSON.

## Input

### Keywords (up to 100 lines)

Required. G-market Keywords Constraints: minItems=1; maxItems=100; items.minLength=1; items.maxLength=5000.

### Pagination

Optional. Pagination times Constraints: minimum=1, maximum=1000.

## How to Use

## Gmarket Product List Scraper

Collects product list information (product, image URL, price, seller, etc.) from [Gmarket](https://item.gmarket.co.kr/) by URL.

### Input

- **Keywords (up to 100 lines)** (required) – Enter one or more values, one per line.
- **Pagination** (optional) – Enter a number from 1 to 1000.

### Output

Returns the following fields:

- `이미지url`
- `상품`
- `상품url`
- `원래가격`
- `현재가격`
- `만족도`
- `평점참여수`
- `구매량`
- `판매자`
- `판매자url`

### How to Use

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

Scheduling and API access (e.g., via [AgentTools API](https://www.octoparse.com/docs/en/api-reference/agenttools-api/search-templates)) may require a paid Octoparse plan.

### Limitations

- Collects only listing-page fields; does not add data Gmarket does not display.
- `구매량`, `판매자`, and `판매자url` may be empty when the source does not provide them.

### Tips

- Start with one or a few inputs and review results before scaling.
- Use the most specific valid keywords to reduce unrelated records.
- Use a stable identifier (e.g., `상품url`) as a 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

- [Gmarket product information scarper](https://www.octoparse.com/template/gmarket-product-information-scraper)
- [Ali Express Product List Scraper(Korean Version)](https://www.octoparse.com/template/ali-express-product-list-scraper-for-korea)
- [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": "Gmarket Product List Scraper input",
  "description": "Input parameters configured for the current published template version.",
  "type": "object",
  "schemaVersion": 1,
  "additionalProperties": false,
  "properties": {
    "keywords": {
      "title": "Keywords (up to 100 lines)",
      "description": "G-market Keywords",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 5000
      },
      "minItems": 1,
      "maxItems": 100,
      "x-octoparse": {
        "apiEnabled": true
      }
    },
    "pagination": {
      "title": "Pagination",
      "description": "Pagination times",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000,
      "x-octoparse": {
        "apiEnabled": true
      }
    }
  },
  "required": [
    "keywords"
  ]
}
```

## Input JSON Example

Example 1

```json
{
  "keywords": [
    "바디워시",
    "샴푸",
    "apple"
  ],
  "pagination": 10.0
}
```

Example 2

```json
{
  "keywords": [
    "바디워시",
    "샴푸",
    "apple"
  ],
  "pagination": 10.0
}
```

Example 3

```json
{
  "keywords": [
    "바디워시",
    "샴푸",
    "apple"
  ],
  "pagination": 10.0
}
```

Example 4

```json
{
  "keywords": [
    "바디워시",
    "샴푸",
    "apple"
  ],
  "pagination": 10.0
}
```

Example 5

```json
{
  "keywords": [
    "바디워시",
    "샴푸",
    "apple"
  ],
  "pagination": 10.0
}
```


## Output Schema

```json
{
  "schemaVersion": 1,
  "type": "object",
  "properties": {
    "구매량": {
      "type": "string",
      "description": ""
    },
    "만족도": {
      "type": "string",
      "description": ""
    },
    "상품": {
      "type": "string",
      "description": ""
    },
    "상품url": {
      "type": "string",
      "description": ""
    },
    "원래가격": {
      "type": "string",
      "description": ""
    },
    "이미지url": {
      "type": "string",
      "description": ""
    },
    "판매자": {
      "type": "string",
      "description": ""
    },
    "판매자url": {
      "type": "string",
      "description": ""
    },
    "평점참여수": {
      "type": "string",
      "description": ""
    },
    "현재가격": {
      "type": "string",
      "description": ""
    }
  },
  "title": "Gmarket 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
{
  "구매량": "500",
  "만족도": "88%",
  "상품": "1+1 대용량 기능성 바디워시 1000mL x2개 화이트머스크 향",
  "상품url": "https://item.gmarket.co.kr/Item?goodscode=3392260232&buyboxtype=ad&utparam-url=%7B%22x_object_type%22%3A%22item%22%2C%22adProduct%22%3A%22N%22%2C%22adSubProduct%22%3A%22C%22%2C%22trafficType%22%3A%22ad%22%2C%22sort%22%3A%22popularity%22%2C%22ab_buckets%22%3A%22502560_%23global-experiment-layer%23551576_%23search-common-mechanism-l1%23548822_%23search-common-mechanism-l2%23556897_%23search-common-mechanism-l3%23556468_%23search-query-recommendation-l1%23550199_%23search-query-recommendation-l2%23555648_%23search-query-recommendation-l3%23555126_%23HsAbId%23441806_%23Ha3Env%231_%23TriggerEnv%231_%23RsEnv%231_%23SpAbId%23441767%22%2C%22pvid_sys%22%3A%22aidc%20server%22%2C%22pvid%22%3A%2222c45c1b77f04065936aa35347f40ee3%22%2C%22searchScenario%22%3A%22keyword%22%2C%22search_session_id%22%3A%226cbf181c-b02e-4606-a13e-0e19269f91be%22%2C%22x_object_id%22%3A%223392260232%22%2C%22query%22%3A%22%EB%B0%94%EB%94%94%EC%9B%8C%EC%8B%9C%22%2C%22origin_price%22%3A%2212000%22%2C%22promotion_price%22%3A%2211900%22%2C%22coupon_price%22%3A%229650%22%7D",
  "원래가격": "12,000",
  "이미지url": "https://gdimg.gmarket.co.kr/3392260232/still/280?ver=1742453832",
  "판매자": "아이엠듀",
  "판매자url": "https://minishop.gmarket.co.kr/iamdue",
  "평점참여수": "101",
  "현재가격": "9,650"
}
```

Example 2

```json
{
  "구매량": "330",
  "만족도": "94%",
  "상품": "딥 모이스처 크리미 바디워시 1L",
  "상품url": "https://item.gmarket.co.kr/Item?goodscode=3411984813&buyboxtype=ad&utparam-url=%7B%22x_object_type%22%3A%22item%22%2C%22adProduct%22%3A%22N%22%2C%22adSubProduct%22%3A%22C%22%2C%22trafficType%22%3A%22ad%22%2C%22ab_buckets%22%3A%22502560_%23sp-common-rank-l1%23543473_%23sp-common-rank-l2%23536928_%23sp-common-rank-l3%23543492_%23sp-common-rank-l4%23545668_%23sp-common-rank-l5%23554151_%23sp-common-rank-l6%23554157_%23sp-common-rank-l7%23554160_%23sp-common-rank-l8%23554897_%23sp-common-rank-l9%23554901_%23search-common-mechanism-l1%23548822_%23search-common-mechanism-l2%23556897_%23search-common-mechanism-l3%23556468_%23search-query-recommendation-l1%23550201_%23search-query-recommendation-l2%23555649_%23search-query-recommendation-l3%23555129_%23HsAbId%23441806_%23Ha3Env%231_%23TriggerEnv%231_%23RsEnv%231_%23SpAbId%23441767%22%2C%22pvid_sys%22%3A%22aidc%20server%22%2C%22pvid%22%3A%22a0eb6e7003fa4349ae104041a12821d3%22%2C%22search_session_id%22%3A%22a9875221-a33a-42f7-b302-e9c73513e76d%22%2C%22x_object_id%22%3A%223411984813%22%2C%22query%22%3A%22%EB%B0%94%EB%94%94%EC%9B%8C%EC%8B%9C%22%2C%22origin_price%22%3A%2242000%22%2C%22promotion_price%22%3A%2229400%22%2C%22coupon_price%22%3A%2224110%22%7D",
  "원래가격": "42,000",
  "이미지url": "https://gdimg.gmarket.co.kr/3411984813/still/280?ver=1787209226",
  "판매자": "LG생활건강뷰티직영샵",
  "판매자url": "https://minishop.gmarket.co.kr/lgcare16",
  "평점참여수": "35",
  "현재가격": "24,110"
}
```

Example 3

```json
{
  "구매량": "16,514",
  "만족도": "92%",
  "상품": "로더베르 대용량 약산성 바디워시 1+1+1 베이비파우더 1000g 총3개",
  "상품url": "https://item.gmarket.co.kr/Item?goodscode=1975310759&buyboxtype=ad&utparam-url=%7B%22x_object_type%22%3A%22item%22%2C%22adProduct%22%3A%22N%22%2C%22adSubProduct%22%3A%22C%22%2C%22trafficType%22%3A%22ad%22%2C%22ab_buckets%22%3A%22502560_%23sp-common-rank-l1%23539130_%23sp-common-rank-l2%23536926_%23sp-common-rank-l3%23538038_%23sp-common-rank-l4%23545668_%23sp-common-rank-l5%23554150_%23sp-common-rank-l6%23554157_%23sp-common-rank-l7%23554159_%23sp-common-rank-l8%23554897_%23sp-common-rank-l9%23554904_%23search-common-mechanism-l1%23548822_%23search-query-recommendation-l1%23550199_%23search-query-recommendation-l2%23555648_%23search-query-recommendation-l3%23555127_%23HsAbId%23458459_%23Ha3Env%231_%23TriggerEnv%231_%23RsEnv%231_%23SpAbId%23441767%22%2C%22pvid_sys%22%3A%22aidc%20server%22%2C%22pvid%22%3A%22736950e84bfb4d31b5fde739f6ca9c8a%22%2C%22search_session_id%22%3A%22f0788ca7-e954-4648-9ab5-8d77b8c52928%22%2C%22x_object_id%22%3A%221975310759%22%2C%22query%22%3A%22%EB%B0%94%EB%94%94%EC%9B%8C%EC%8B%9C%22%2C%22origin_price%22%3A%2225900%22%2C%22promotion_price%22%3A%2225800%22%2C%22coupon_price%22%3A%2220800%22%7D",
  "원래가격": "25,900",
  "이미지url": "https:https://sinbad-img.gmarket.com/sinbad/thumbnail/2026/08/13/3633ab42-aede-4685-a071-e5c7015e5db0.png",
  "판매자": "딜라이크",
  "판매자url": "https://minishop.gmarket.co.kr/vibas",
  "평점참여수": "906",
  "현재가격": "20,800"
}
```

Example 4

```json
{
  "구매량": "4,289",
  "만족도": "96%",
  "상품": "정품/당일출고 에어팟 프로 3세대 USB-C 지원 MFHP4KH/A",
  "상품url": "https://item.gmarket.co.kr/Item?goodscode=4583512847&buyboxtype=ad&utparam-url=%7B%22x_object_type%22%3A%22item%22%2C%22adProduct%22%3A%22N%22%2C%22adSubProduct%22%3A%22C%22%2C%22trafficType%22%3A%22ad%22%2C%22ab_buckets%22%3A%22502560_%23sp-common-rank-l1%23539130_%23sp-common-rank-l2%23536927_%23sp-common-rank-l3%23538038_%23sp-common-rank-l4%23538044_%23sp-common-rank-l5%23554150_%23sp-common-rank-l6%23554157_%23sp-common-rank-l7%23554160_%23sp-common-rank-l8%23554897_%23sp-common-rank-l9%23554901_%23search-common-mechanism-l1%23548823_%23search-query-recommendation-l1%23550201_%23search-query-recommendation-l3%23555129_%23HsAbId%23441806_%23Ha3Env%231_%23TriggerEnv%231_%23RsEnv%231_%23SpAbId%23441767%22%2C%22pvid_sys%22%3A%22aidc%20server%22%2C%22pvid%22%3A%2239df4f311b404af883e9bb180fa445d6%22%2C%22search_session_id%22%3A%225c0b688a-2108-437f-8499-0d741f0f0ed8%22%2C%22x_object_id%22%3A%224583512847%22%2C%22query%22%3A%22apple%22%2C%22origin_price%22%3A%22373920%22%2C%22promotion_price%22%3A%22344760%22%2C%22coupon_price%22%3A%22303390%22%7D",
  "원래가격": "373,920",
  "이미지url": "https:https://sinbad-img.gmarket.com/sinbad/thumbnail/2026/08/13/3633ab42-aede-4685-a071-e5c7015e5db0.png",
  "판매자": "신세계백화점",
  "판매자url": "https://minishop.gmarket.co.kr/shinsegae9",
  "평점참여수": "428",
  "현재가격": "303,390"
}
```

Example 5

```json
{
  "구매량": "1,769",
  "만족도": "92%",
  "상품": "플루 아로마 퍼퓸 스크럽 바디워시 1000ml (3향 중 택1) +바디스크럽 30g 1개 증정",
  "상품url": "https://item.gmarket.co.kr/Item?goodscode=3075395052&buyboxtype=ad&utparam-url=%7B%22x_object_type%22%3A%22item%22%2C%22adProduct%22%3A%22N%22%2C%22adSubProduct%22%3A%22A%22%2C%22trafficType%22%3A%22ad%22%2C%22ab_buckets%22%3A%22502560_%23global-experiment-layer%23543126_%23search-common-mechanism-l1%23548822_%23search-query-recommendation-l1%23550200_%23HsAbId%23441806_%23Ha3Env%231_%23TriggerEnv%231_%23RsEnv%231_%23SpAbId%23441767%22%2C%22pvid_sys%22%3A%22aidc%20server%22%2C%22pvid%22%3A%22bbdab79b3d6c4b62b6f4eb50a34a07ba%22%2C%22search_session_id%22%3A%229e54b119-72e3-4f24-b70b-18a5aeaf9c94%22%2C%22x_object_id%22%3A%223075395052%22%2C%22query%22%3A%22%EB%B0%94%EB%94%94%EC%9B%8C%EC%8B%9C%22%2C%22origin_price%22%3A%2217800%22%2C%22promotion_price%22%3A%2215800%22%2C%22coupon_price%22%3A%2213910%22%7D",
  "원래가격": "17,800",
  "이미지url": "https:https://sinbad-img.gmarket.com/sinbad/thumbnail/2026/08/13/3633ab42-aede-4685-a071-e5c7015e5db0.png",
  "판매자": "플루스토어",
  "판매자url": "https://minishop.gmarket.co.kr/plu",
  "평점참여수": "286",
  "현재가격": "13,910"
}
```

## 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": "gmarket-product-list-scraper",
  "taskName": "Gmarket Product List Scraper",
  "parameters": "{\"keywords\":[\"바디워시\",\"샴푸\",\"apple\"],\"pagination\":10.0}"
}
```

## Python Example

```python
import json
import requests

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

parameters = json.loads("{\"keywords\":[\"바디워시\",\"샴푸\",\"apple\"],\"pagination\":10.0}")

response = requests.post(
    f"{OPENAPI_BASE}/api/agentTools/executeTask",
    headers={
        "Authorization": f"Bearer {ACCESS_TOKEN}",
        "Content-Type": "application/json",
    },
    json={
        "templateName": "gmarket-product-list-scraper",
        "taskName": "Gmarket 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": "gmarket-product-list-scraper",
  "taskName": "Gmarket Product List Scraper",
  "parameters": "{\"keywords\":[\"바디워시\",\"샴푸\",\"apple\"],\"pagination\":10.0}"
}
JSON
```

## MCP Setup

Connect an MCP-compatible AI client to `https://mcp.octoparse.com` using browser OAuth or an Octoparse API key. Find `gmarket-product-list-scraper`, 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/gmarket-product-list-scraper.json)
- [Manifest](https://www.octoparse.com/templates/gmarket-product-list-scraper-manifest.json)