# Kakao Gift Ranking Scraper — Korea Gifting Best-Sellers (`kdatafactory/kakaogift-scraper`) Actor Scrape Kakao Gift (카카오톡 선물하기) realtime best-seller rankings — Korea's biggest social gifting store: rank, product, brand, KRW price, discount, wish count and image as clean JSON. Built on Kakao's own ranking API. For daily Korean e-commerce trend dashboards. - **URL**: https://apify.com/kdatafactory/kakaogift-scraper.md - **Developed by:** [Seok June Park](https://apify.com/kdatafactory) (community) - **Categories:** E-commerce, Automation - **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. 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 ## Kakao Gift Ranking Scraper — Korea Gifting Best-Sellers 🎁 Scrape the live **best-seller gift rankings** from [Kakao Gift (카카오톡 선물하기)](https://gift.kakao.com) — Korea's dominant **social gifting store**, built into KakaoTalk — as clean, structured JSON. Get rank, product name, brand, price (KRW), discount, wish count, and image for every product in the realtime ranking, in one run. Because "선물하기" is where a huge share of Koreans send gifts (birthdays, holidays, thank-yous), its realtime ranking is a fast, high-signal read on **what's actually selling in Korea right now** — perfect as the daily feed behind a **Korean e-commerce shopping-trend dashboard**. > **Try it free.** Apify's free plan includes $5 of monthly platform credit — at **$2.00 / 1,000 results** that's roughly **2,500 products** from this actor, no credit card required. Set your input, click Start, and export JSON/CSV/Excel. --- ### What it does This actor reads ranking data straight from Kakao Gift's own public ranking API (the same endpoint the site calls as you browse the 랭킹 page), so results are fast and complete — no fragile full-page scraping, no headless browser, no login. You can scrape: - **The main daily best-seller ranking** (전체 / all realtime trending — the default), or - **A specific realtime tab** — most-wished (위시TOP), new arrivals (신상), exclusives (단독), on-sale (할인·혜택), and more — by setting `navId`. Every run captures the ranking **in order** (`rank` = the product's position on the board) with its live price, discount, and popularity (wish count). > **Why Kakao Gift?** KakaoTalk is used by nearly everyone in Korea, and its "선물하기" gift store is the default way people send gifts through the app. That makes its realtime best-seller board one of the cleanest live indicators of Korean consumer demand — across food, beauty, health, living, and vouchers. This actor turns that board into a structured dataset you can trend, chart, and pipe into your own tools. --- ### Input | Field | Type | Description | |-------|------|-------------| | `navId` | integer | Which realtime ranking tab to scrape. `10000` = 전체 / **All** (the main daily best-seller ranking, default). Other live tabs: `10001` 내돈내산 (self-purchase), `12` 신상 (new arrivals), `10002` 위시TOP (most-wished), `10003` 단독 (exclusive), `10005` 할인·혜택 (on-sale), `10004` NEW. | | `maxItems` | integer | Max products to collect. Default `100`, max `2000`. The feed paginates 100 per request. | | `proxyConfiguration` | object | Proxy settings (see below). Defaults to a direct connection. | The actor fetches Kakao's live tab list at run time and falls back to `10000` if the `navId` you pass isn't a valid trending tab — so an empty/default input always produces the main best-seller ranking. #### Input example ```json { "navId": 10000, "maxItems": 100 } ```` ```json { "navId": 10002, "maxItems": 200 } ``` *** ### Output Each ranked product is one dataset record. `rank` is the product's 1-based position in the ranking (page 0 → ranks 1-100, page 1 → 101-200, …). `price_krw` is the current selling price in Korean won; `basic_price_krw` is the list price before discount, and `discount_rate` is the percentage off. `wish_count` is how many people have wish-listed the product (the ranking's core popularity signal). ```json { "source": "kakao_gift", "rank": 1, "product_id": "2306784", "name": "[경복궁] 영양 삼계탕 (1kg*2팩)", "brand": "경복궁", "price_krw": 23500, "basic_price_krw": 30400, "discount_rate": 22, "review_count": 0, "wish_count": 3730, "product_type": "Shipping", "url": "https://gift.kakao.com/product/2306784", "image_url": "https://st.kakaocdn.net/product/gift/product/20230724154945_d9334184970e45599666441b31b55fb4.jpg", "updated_at": "07.15 09:00", "scraped_at": "2026-07-15T09:54:09+09:00" } ``` A full 30-item sample from a real run is in [`samples/sample-output.json`](samples/sample-output.json). | Field | Meaning | |-------|---------| | `source` | Always `"kakao_gift"`. | | `rank` | 1-based position in the ranking. | | `product_id` | Kakao Gift product id. | | `name` | Product name (Korean, as listed). | | `brand` | Brand / seller name, else `null`. | | `price_krw` | Current selling price in KRW. | | `basic_price_krw` | List price before discount, in KRW. | | `discount_rate` | Discount percentage off the list price. | | `review_count` | Review count when the ranking feed exposes it (usually `0` — see limitations). | | `wish_count` | Number of wish-list adds (popularity signal). | | `product_type` | Fulfilment type, e.g. `Shipping` (배송 gift) or `Coupon` (교환권). | | `url` | Product page URL. | | `image_url` | Main product photo URL. | | `updated_at` | When Kakao last refreshed the ranking (`MM.DD HH:mm`, KST). | | `scraped_at` | ISO-8601 timestamp (KST, UTC+9). | The core fields — `rank`, `name`, `brand`, `price_krw`, `basic_price_krw`, `discount_rate`, `wish_count`, `product_type`, `url`, `image_url` — were populated on **40/40** records in the live test. `review_count` is present but is `0` in the ranking feed (see Known limitations). *** ### Use cases - **Daily Korean e-commerce trend dashboard** — snapshot the best-seller board every day and chart what's rising and falling across Korea's biggest social-gifting store. `rank` + `wish_count` + `discount_rate` give you a clean movers/shakers feed. - **Consumer demand & category research** — see which products, brands, and price points dominate Korean gifting week to week; pair the All tab with 위시TOP and 신상 for demand vs. novelty signals. - **Price & promotion monitoring** — track `price_krw` vs `basic_price_krw` and `discount_rate` to watch how discounting moves products up the board. - **AI agents & datasets** — feed a structured, ranked best-seller list into trend models, dashboards, or LLM agents. *** ### ❓ FAQ **Is it legal to scrape this data?** This actor collects only public, non-personal ranking data — the same best-seller board any visitor sees on gift.kakao.com without logging in. No personal or account data is collected. You are responsible for how you use the data; see the legality note below. **What does it cost in practice?** $2.00 per 1,000 results (launch pricing) + a few cents of platform usage. Example: a 100-result daily pull costs about **$0.20/day**. Apify's free $5 monthly credit covers **~2,500 results** (5 ÷ 2 × 1,000). **Do I need to configure proxies?** No — the default settings work out of the box. Kakao Gift's ranking API serves the board without a bot wall, so the actor runs fine on a **direct connection**. For very heavy pulls you can optionally enable Apify Proxy — see the proxy note below. **How fresh is the data?** Every run scrapes the live ranking at run time, and each record carries Kakao's own `updated_at` timestamp. Kakao refreshes the board through the day; schedule the actor for recurring snapshots (e.g. a daily trend feed). **What is NOT included?** Per-product detail (full description, option-level pricing, individual reviews) isn't fetched — this actor is a **ranking** scraper, not a product-detail scraper. `review_count` comes through as `0` because the ranking feed doesn't populate it. Product names and brands are Korean strings and are not translated. *** ### 🤖 Use with AI agents (MCP) Call this Actor as a tool from Claude or any MCP-compatible AI agent — no glue code. Point your MCP client at Apify's server, scoped to this Actor: ```json { "mcpServers": { "apify": { "url": "https://mcp.apify.com?tools=kdatafactory/kakaogift-scraper", "headers": { "Authorization": "Bearer " } } } } ``` Your agent can then pull Korea's live gifting best-sellers on demand — no scraping code in your app. Grab a free token from [Apify → Integrations](https://console.apify.com/settings/integrations). ### 🇰🇷 More Korean data actors This actor is part of a suite of Korean-platform scrapers by the same maintainer. Combine them to cover Korea's shopping trends across every major vertical: - [oliveyoung-scraper](https://apify.com/kdatafactory/oliveyoung-scraper) — K-beauty bestsellers from Korea's #1 beauty retailer - [musinsa-scraper](https://apify.com/kdatafactory/musinsa-scraper) — fashion rankings from Korea's #1 fashion marketplace - [zigzag-scraper](https://apify.com/kdatafactory/zigzag-scraper) — trending women's fashion from Korea's Zigzag app - [kurly-scraper](https://apify.com/kdatafactory/kurly-scraper) — best-selling grocery & food from Market Kurly - [danawa-scraper](https://apify.com/kdatafactory/danawa-scraper) — price-comparison and electronics data from Danawa Browse all: [apify.com/kdatafactory](https://apify.com/kdatafactory) *** ### Rate limiting & legality - The actor collects **only public, non-authenticated data**. It never logs in and never touches private endpoints. - **No personal data** is collected — only product, brand, price, and popularity attributes from the public ranking board. - Requests are rate-limited: one page at a time with a ≥ 500 ms delay between requests, to stay gentle on Kakao's servers. - You are responsible for using the data in line with Kakao Gift's terms of service and applicable law. #### Known limitations (honesty note) - This is a **ranking** scraper. It returns the best-seller board (rank, product, brand, price, discount, wish count, image), not full product-detail pages. - **`review_count`** comes through as `0`: the ranking feed doesn't expose review counts, so the field is present for schema stability but not a guaranteed signal. **`wish_count`** is the ranking's real popularity metric. - **Names and brands are Korean strings** and are not translated. - **The board is realtime and re-ranks through the day.** Two runs minutes apart can differ; each record's `updated_at` tells you which ranking edition it came from. *** *If this actor saves you time, a rating on the [Store page](https://apify.com/kdatafactory/kakaogift-scraper) helps a solo maintainer a lot. Found an issue? Open it in the Issues tab — I respond fast.* # Actor input Schema ## `navId` (type: `integer`): Which realtime gift ranking to scrape. 10000 = 전체 / All (the main daily best-seller ranking, default). Other live tabs: 10001 = 내돈내산 (self-purchase), 12 = 신상 (new arrivals), 10002 = 위시TOP (most-wished), 10003 = 단독 (exclusive), 10005 = 할인·혜택 (on-sale), 10004 = NEW. The actor fetches Kakao's tab list at run time and falls back to 10000 if the id isn't a valid trending tab. ## `maxItems` (type: `integer`): Maximum number of ranked products to collect. The feed is paginated 100 per request; rank = position in the ranking. Default 100, max 2000. ## `proxyConfiguration` (type: `object`): Proxy settings. Kakao Gift's ranking API serves data without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here. ## Actor input object example ```json { "navId": 10000, "maxItems": 100, "proxyConfiguration": { "useApifyProxy": false } } ``` # 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 = { "navId": 10000, "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("kdatafactory/kakaogift-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 = { "navId": 10000, "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("kdatafactory/kakaogift-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 '{ "navId": 10000, "maxItems": 100 }' | apify call kdatafactory/kakaogift-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=kdatafactory/kakaogift-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Kakao Gift Ranking Scraper — Korea Gifting Best-Sellers", "description": "Scrape Kakao Gift (카카오톡 선물하기) realtime best-seller rankings — Korea's biggest social gifting store: rank, product, brand, KRW price, discount, wish count and image as clean JSON. Built on Kakao's own ranking API. For daily Korean e-commerce trend dashboards.", "version": "0.1", "x-build-id": "a9CQt2iPfGI975nz6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kdatafactory~kakaogift-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kdatafactory-kakaogift-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/kdatafactory~kakaogift-scraper/runs": { "post": { "operationId": "runs-sync-kdatafactory-kakaogift-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/kdatafactory~kakaogift-scraper/run-sync": { "post": { "operationId": "run-sync-kdatafactory-kakaogift-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": { "navId": { "title": "Ranking tab (navId)", "type": "integer", "description": "Which realtime gift ranking to scrape. 10000 = 전체 / All (the main daily best-seller ranking, default). Other live tabs: 10001 = 내돈내산 (self-purchase), 12 = 신상 (new arrivals), 10002 = 위시TOP (most-wished), 10003 = 단독 (exclusive), 10005 = 할인·혜택 (on-sale), 10004 = NEW. The actor fetches Kakao's tab list at run time and falls back to 10000 if the id isn't a valid trending tab.", "default": 10000 }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of ranked products to collect. The feed is paginated 100 per request; rank = position in the ranking. Default 100, max 2000.", "default": 100 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy settings. Kakao Gift's ranking API serves data without a bot wall, so the actor runs fine on a direct connection (default). If you ever see blocks at high volume, enable Apify Proxy here.", "default": { "useApifyProxy": 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 } } } } } } } } } } ```