# Auction Lots Search Scraper (`stealth_mode/auction-lots-search-scraper`) Actor Scrape product listings from Auction.co.kr's search results at scale. Collect titles, prices, images, seller info, delivery details, and 21+ fields per item — perfect for price monitoring, market research, and reseller automation. - **URL**: https://apify.com/stealth\_mode/auction-lots-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, E-commerce - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results 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 ## Auction.co.kr Lots Search Scraper: Extract Korean Auction Product Data --- ### What Is Auction.co.kr? Auction.co.kr is one of South Korea's largest online auction and e-commerce platforms, featuring millions of product listings across categories like electronics, fashion, books, collectibles, and more. The platform connects individual sellers and merchants with millions of daily shoppers. Manually extracting search results is impractical for competitive analysis or data aggregation — the **Auction.co.kr Lots Search Scraper** automates this workflow, delivering structured, complete product datasets from search pages. --- ### Overview The **Auction.co.kr Lots Search Scraper** extracts product listings from Auction search result pages, capturing comprehensive metadata for each item. It is ideal for: - **Price monitoring platforms** tracking competitor pricing and availability - **Marketplace researchers** analyzing product trends and category dynamics - **Resellers** bulk-sourcing product data for arbitrage or dropshipping - **Data analysts** building Korean e-commerce datasets for market intelligence Key strengths include high item extraction per URL (up to 200 items), robust error handling via `ignore_url_failures`, and detailed seller and delivery information for each lot. --- ### Input Format The scraper accepts a JSON configuration object: ```json { "urls": [ "https://www.auction.co.kr/n/list?category=18540000&k=36&p=2" ], "ignore_url_failures": true, "max_items_per_url": 200 } ```` | Field | Description | |---|---| | `urls` | Array of Auction.co.kr search result page URLs (including category, filter, and page parameters) | | `max_items_per_url` | Maximum products extracted per URL (default: 20, max: 200) | | `ignore_url_failures` | If `true`, skips failed URLs and continues execution; if `false`, stops on first failure | > **Tip:** Build search URLs manually on Auction.co.kr, then filter by category, keyword, price range, or seller rating. Each unique URL combination yields different product sets. *** ### Output Format #### Sample Output ```json { "item_no": "F526302551", "title_visible": true, "title": { "title": { "text": "일반등록", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_value": "", "uts_impression": false }, "tier_name": "General" }, "item": { "text": "(현대Hmall)스카티카메론 퍼터커버 훌라걸 헤드커버 Hawaiian Open Honolulu Hot Lips", "image_url": "//image.auction.co.kr/itemimage/56/9c/24/569c24b7e7.jpg?ver=1782103221", "alt_text": "(현대Hmall)스카티카메론 퍼터커버 훌라걸 헤드커버 Hawaiian Open Honolulu Hot Lips", "link": "http://itempage3.auction.co.kr/DetailView.aspx?itemno=F526302551", "target": "_blank", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_event": "click", "uts_code": "100004562", "uts_type": "item", "uts_value": "{\"itemno\":\"F526302551\",\"asn\":1,\"asn_tier\":1,\"tier\":\"5\",\"device_type\":100,\"keyword\":\"lips\",\"tag_value\":null,\"request_id\":\"ff912c0884074d1b998678932541cc4d\",\"tracking_id\":\"e30160p37123r36462m58001d8s9009i1\"}", "uts_version": "1.0", "uts_impression": true }, "is_free_delivery": true, "item_no_image": "//pics.auction.co.kr/pc/single/snowwhite/common/no_image_itemcard_300x300.png", "item_image_hq": null, "brand": { "text": "스마트", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_value": "", "uts_impression": false }, "is_visible_official_tag": false, "price": { "discount_rate": "4", "discount_rate_unit": "%", "bin_price": "529,100", "bin_price_unit": "원", "coupon_discounted_bin_price": "502,650", "coupon_discounted_bin_price_unit": "원", "prefix": { "text": "", "size": 12, "color": "#616161", "is_bold": false, "font_type": 0 }, "price": { "text": "502,650", "size": 20, "color": "#222222", "is_bold": true, "font_type": 0 }, "price_unit": { "text": "원", "size": 16, "color": "#222222", "is_bold": true, "font_type": 0 }, "postfix": { "text": "", "size": 12, "color": "#616161", "is_bold": false, "font_type": 0 }, "dc_rate": { "text": "4%", "size": 18, "color": "#C92931", "is_bold": false, "font_type": 0 }, "before_price": { "text": "529,100", "size": 12, "color": "#A4ACBB", "is_bold": false, "font_type": 0 }, "before_price_unit": { "text": "원", "size": 12, "color": "#A4ACBB", "is_bold": false, "font_type": 0 } }, "delivery_tag": "", "benefit_tags": [], "tags": [], "delivery_tags": [ { "image": {}, "text": { "text": "무료배송", "size": 12, "color": "#616161", "is_bold": false, "font_type": 0 } } ], "reward_nudging": { "image": { "image": { "image_url": "//pics.auction.co.kr/mobile/single/common/logo_membership.png", "alt_text": "꼭멤버" }, "text": { "size": 0, "is_bold": false, "font_type": 0 } }, "content": [ { "text": "최대 ", "size": 12, "color": "#01A900", "is_bold": false, "font_type": 0 }, { "text": "16,053원", "size": 12, "color": "#01A900", "is_bold": true, "font_type": 0 }, { "text": " 적립", "size": 12, "color": "#01A900", "is_bold": false, "font_type": 0 } ] }, "item_tags": [], "score": { "satisfaction_rate_visible": false, "satisfaction_rate": 0, "item_score_visible": false, "item_score": 0, "item_score_description": "후기평점 0점", "feedback_count": { "text": "0", "link": "http://member.auction.co.kr/feedback/PremiumFeedbackList.aspx?ItemNo=F526302551&SellerID=hmall01&tab=1", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_value": "", "uts_impression": false }, "pay_count": { "text": "0", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_value": "", "uts_impression": false } }, "category": { "l_code": "8", "m_code": "8320000", "s_code": "8320400", "d_code": "" }, "related_group_no": "0", "seller": { "text": "현대Hmall", "alt_text": "현대Hmall", "link": "http://stores.auction.co.kr/hmall01", "tracking_id": "ff912c0884074d1b998678932541cc4d?e30160p37123r36462m58001d8s9009i1", "uts_event": "click", "uts_code": "100001175", "uts_type": "link", "uts_value": "{\"asn\":1,\"seller_id\":\"hmall01\",\"request_id\":\"ff912c0884074d1b998678932541cc4d\",\"tracking_id\":\"e30160p37123r36462m58001d8s9009i1\"}", "uts_version": "1.0", "uts_impression": false }, "seller_grade_image": "//pics.auction.co.kr/pc/single/snowwhite/common/ico-topseller.png", "from_url": "https://www.auction.co.kr/n/search?keyword=lips" } ``` Each scraped product returns a record with 21 fields covering product details, images, pricing, and seller information: #### Product Identification & Visibility | Field | Meaning | |---|---| | `Item No` | Unique Auction product identifier (key field for tracking) | | `Title` | Full product title as displayed on the listing | | `Title Visible` | Whether the full title is visible in search results (true/false) | | `Item` | Product summary or short description | | `Category` | Category classification (e.g., Electronics, Fashion) | | `Related Group No` | Internal grouping or variant set identifier | #### Pricing & Delivery | Field | Meaning | |---|---| | `Price` | Current asking price (in Korean Won) | | `Is Free Delivery` | Whether the seller offers free shipping (true/false) | | `Delivery Tag` | Shipping option label (e.g., "Free Delivery", "Pickup Available") | | `Delivery Tags` | Array of all available shipping methods | | `Benefit Tags` | Promotional badges (e.g., "Member Discount", "Time Sale") | | `Tags` | Additional item labels (e.g., "New", "Open Box", "Refurbished") | | `Item Tags` | Product-level tags for quick filtering | #### Visuals & Media | Field | Meaning | |---|---| | `Item No Image` | Thumbnail image URL for the product | | `Item Image HQ` | High-quality primary product image URL | #### Seller & Reputation | Field | Meaning | |---|---| | `Seller` | Merchant name or seller account identifier | | `Seller Grade Image` | Seller rating badge or grade visualization | | `Score` | Seller reputation score or overall rating | #### Additional Metadata | Field | Meaning | |---|---| | `Is Visible Official Tag` | Whether the item has official seller verification badge (true/false) | | `Reward Nudging` | Loyalty or rewards program indicator (if applicable) | | `Brand` | Brand name extracted from the product (if available) | *** ### How to Use 1. **Create search URLs** — Visit Auction.co.kr, navigate to your target category, apply filters (price, seller, condition), and copy the full URL from the browser address bar. 2. **Prepare input** — Paste URLs into the `urls` array. Adjust `max_items_per_url` based on your data volume (e.g., 50 for manageable runs, 200 for bulk extraction). 3. **Enable failure tolerance** — Set `ignore_url_failures: true` to skip problematic URLs and continue scraping others. 4. **Run the scraper** — Execute the actor and monitor progress in the logs. 5. **Download & integrate** — Export results as JSON, CSV, or Excel; integrate with your analytics platform, database, or monitoring dashboard. **Best practices:** - Test with a single URL first to verify expected output. - Use multiple URLs with different filter parameters to capture diverse product types. - Re-run periodically to track price changes and new listings. - Respect Auction.co.kr's Terms of Service regarding data collection and reuse. *** ### Use Cases & Business Value - **Dynamic pricing:** Monitor competitor prices across product categories in real-time - **Inventory research:** Identify trending products, stock levels, and seller concentration - **Market intelligence:** Analyze brand distribution, pricing strategies, and delivery trends - **Automated aggregation:** Feed data into price comparison sites or shopping bots - **Supplier sourcing:** Evaluate wholesale availability and bulk seller ratings The Auction.co.kr Lots Search Scraper transforms search pages into actionable data, enabling data-driven decisions in e-commerce and marketplace operations. *** ### Conclusion The **Auction.co.kr Lots Search Scraper** is a powerful tool for anyone needing structured product data from Korea's largest auction platform. Whether you're monitoring competitors, analyzing market trends, or building an aggregator, this scraper delivers complete, detailed product records in minutes. Start extracting today and unlock insights that manual research cannot match. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the lots search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.auction.co.kr/n/list?category=18540000&k=36&p=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # 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 = { "urls": [ "https://www.auction.co.kr/n/list?category=18540000&k=36&p=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/auction-lots-search-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 = { "urls": ["https://www.auction.co.kr/n/list?category=18540000&k=36&p=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/auction-lots-search-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 '{ "urls": [ "https://www.auction.co.kr/n/list?category=18540000&k=36&p=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/auction-lots-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/auction-lots-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Auction Lots Search Scraper", "description": "Scrape product listings from Auction.co.kr's search results at scale. Collect titles, prices, images, seller info, delivery details, and 21+ fields per item — perfect for price monitoring, market research, and reseller automation.", "version": "0.0", "x-build-id": "jSyJ01MZ1kyLbBUsr" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~auction-lots-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-auction-lots-search-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/stealth_mode~auction-lots-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-auction-lots-search-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/stealth_mode~auction-lots-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-auction-lots-search-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": { "urls": { "title": "URLs of the lots search list urls to scrape", "type": "array", "description": "Add the URLs of the lots search list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "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 } } } } } } } } } } ```