# Tumblbug Scraper — Korean Crowdfunding Projects & Trends (`kdatafactory/tumblbug-scraper`) Actor

Scrape Tumblbug, Korea's #1 creative crowdfunding platform: popularity rankings, category feeds, and keyword search with project title, maker/team, category, KRW amount raised, funding rate, backer count, and status as clean JSON. Pre-retail Korean product-trend data.

- **URL**: https://apify.com/kdatafactory/tumblbug-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.50 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Tumblbug Crowdfunding Scraper 🚀

Scrape **ranked**, **categorized**, and **searched** crowdfunding projects from [Tumblbug](https://tumblbug.com) (텀블벅) — Korea's #1 creative crowdfunding platform — as clean, structured JSON. Get project titles, the maker/team name, category, amount raised (KRW), funding rate, backer counts, live/succeeded status, and cover images in one call.

Built for **pre-retail Korean product-trend research**, **market discovery**, and **crowdfunding analytics**. Tumblbug is where Korean products, games, books, and goods launch *before* they hit retail — pair this with fashion/e-commerce scrapers for an early-signal trend bundle.

> **Try it free.** Apify's free plan includes $5 of monthly platform credit — roughly **2,000 results** from this actor, no credit card required. Set your input, click Start, and export JSON/CSV/Excel.

***

### What it does

Tumblbug is a client-rendered SPA, so the raw HTML has no project list. This actor calls the same **public JSON API** the Tumblbug web app uses to render its "Discover" feed and search results — so results are fast and complete, with no fragile HTML scraping. Two modes:

- **Ranking** — the "Discover" feed of ongoing projects, sorted by **popular**, **newest**, or **ending soon**, optionally filtered by category. Each item includes its `rank`.
- **Search** — every project matching a keyword (e.g. `타로카드`, `board game`, `keycap`).

***

### Input

| Field | Type | Description |
|-------|------|-------------|
| `mode` | string | `"ranking"` or `"search"`. |
| `query` | string | **Search mode only:** a keyword. Required for search mode. |
| `category` | string | **Ranking mode only, optional:** a category slug (see below). Blank = all categories. |
| `sort` | string | **Ranking mode only:** `"popular"`, `"publishedAt"` (newest), or `"endedAt"` (ending soon). Default `popular`. |
| `maxItems` | integer | Max projects to collect. Default `100`. |
| `proxyConfiguration` | object | Apify Proxy settings. RESIDENTIAL recommended for large runs. Runs direct if omitted. |

#### Common category slugs (ranking mode)

| Slug | Category |
|------|----------|
| `publication` | Books / e-books |
| `board-games-and-trpg` | Board games & TRPG |
| `digital-games` | Video / mobile games |
| `character-and-goods` | Characters & goods |
| `perfumes-and-beauty` | Beauty & perfume |
| `food` | Food |
| `technology-and-household-appliance` | Tech & appliances |
| `assorted-goods` | Accessories |
| `webtoon-resources` | Webtoon / comic resources |

#### Input example

```json
{
  "mode": "ranking",
  "sort": "popular",
  "category": "board-games-and-trpg",
  "maxItems": 100
}
```

```json
{
  "mode": "search",
  "query": "타로카드",
  "maxItems": 200
}
```

***

### Output

Each project is one dataset record. `amount_raised_krw` is in Korean won; `funding_rate` is the funded percentage of the goal (e.g. `2152` = 2,152% funded). `rank` reflects the order in the requested feed.

```json
{
  "source": "tumblbug",
  "project_id": "68ffc8ac-5526-4357-86fb-8eee2a462779",
  "title": "설정문서까지 연결되는 창작자용 세계지도",
  "maker": "월드모멘트",
  "category": "앱 · 웹 서비스",
  "amount_raised_krw": 10762000,
  "funding_rate": 2152,
  "backer_count": 304,
  "status": "live",
  "rank": 1,
  "url": "https://tumblbug.com/worldnote",
  "image_url": "https://img.tumblbug.com/...",
  "scraped_at": "2026-07-09T13:38:08+09:00"
}
```

A full 40-item sample from a real run is in [`samples/sample-output.json`](samples/sample-output.json).

| Field | Meaning |
|-------|---------|
| `source` | Always `"tumblbug"`. |
| `project_id` | Tumblbug project UUID. |
| `title` | Project title. |
| `maker` | Public project/team/brand display name (like a shop name). |
| `category` | Category display name. |
| `amount_raised_krw` | Total amount pledged so far (KRW). |
| `funding_rate` | Percent of the funding goal reached. |
| `backer_count` | Number of backers/pledges. |
| `status` | `live`, `succeeded`, or `ended`. |
| `rank` | Position in the requested feed. |
| `url` | Project page URL. |
| `image_url` | Cover image URL. |
| `scraped_at` | ISO-8601 timestamp (KST, UTC+9). |

***

### Use cases

- **Pre-retail trend research** — spot which Korean products, games, and goods are over-funding *before* they reach retail, then bundle with e-commerce scrapers (Musinsa, 29CM) for a full trend pipeline.
- **Market discovery & sourcing** — build a catalog of trending, validated-demand Korean products with images, makers, and funding traction.
- **Crowdfunding analytics** — track `funding_rate`, `amount_raised_krw`, and `backer_count` across categories over time.
- **AI agents & datasets** — feed structured crowdfunding data into recommendation models, dashboards, or LLM agents.

***

### ❓ FAQ

**Is it legal to scrape this data?**
This actor collects only public, non-personal catalog data — the same project listings any visitor sees on Tumblbug without logging in. No personal data is collected (`maker` is a public project/brand name, and backer identities are never touched). You are responsible for how you use the data; see the legality note below.

**What does it cost in practice?**
$2.50 per 1,000 results (launch pricing), plus a few cents of platform usage. Example: a 500-result daily pull costs about $1.25/day. Apify's free $5 monthly credit covers ~2,000 results.

**Do I need to configure proxies?**
No — the default settings work out of the box. For large runs at high `maxItems`, enabling Apify Proxy with the `RESIDENTIAL` group is optional scaling advice that makes runs more reliable (see the proxy recommendation below).

**How fresh is the data?**
Every run calls Tumblbug's live API at run time. Schedule the actor for recurring snapshots.

**What is NOT included?**
No personal data of any kind — no backer identities, no private names or contacts. Only the public feed/search fields listed above are returned; per-project detail-page content (e.g. full descriptions, reward tiers) is not collected.

***

### 🤖 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/tumblbug-scraper",
      "headers": { "Authorization": "Bearer <YOUR_APIFY_TOKEN>" }
    }
  }
}
```

Your agent can then pull Tumblbug crowdfunding projects & trends 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:

- [wadiz-scraper](https://apify.com/kdatafactory/wadiz-scraper) — Wadiz crowdfunding projects, Korea's other major funding platform.
- [musinsa-scraper](https://apify.com/kdatafactory/musinsa-scraper) — Musinsa fashion e-commerce product and ranking data.
- [29cm-scraper](https://apify.com/kdatafactory/29cm-scraper) — 29CM curated lifestyle & fashion product listings.

Browse all: [apify.com/kdatafactory](https://apify.com/kdatafactory)

***

### Rate limiting & legality

- The actor collects **only public, non-authenticated data** from Tumblbug's own web API. It never logs in and never touches private endpoints.
- **No personal data** is collected. `maker` is the **public project/team/brand display name** (like a shop name) shown on the project page — never a private person's real name, contact, or profile. No backer identities are ever collected.
- Requests are rate-limited: one page at a time with a ≥ 500 ms delay between requests, to stay gentle on Tumblbug's servers.
- You are responsible for using the data in line with Tumblbug's terms of service and applicable law.

#### ⚠️ Proxy recommendation

Tumblbug may throttle datacenter IPs or high request volumes. For reliable runs — especially at higher `maxItems` — enable **Apify Proxy with the `RESIDENTIAL` group**. The actor automatically uses the proxy configuration you provide and falls back to a direct connection when none is set (or when a proxy tunnel fails). If you see repeated `API HTTP 403/429` errors in the log, switch on residential proxy.

***

*If this actor saves you time, a rating on the [Store page](https://apify.com/kdatafactory/tumblbug-scraper) helps a solo maintainer a lot. Found an issue? Open it in the Issues tab — I respond fast.*

# Actor input Schema

## `mode` (type: `string`):

What to scrape. 'ranking' returns popularity/newest/ended-ranked ongoing projects (optionally filtered by category). 'search' returns projects matching a keyword.

## `query` (type: `string`):

For 'search' mode: a keyword (e.g. 'tarot', '보드게임', 'keycap'). Ignored in ranking mode.

## `category` (type: `string`):

Optional category slug to filter the ranking feed. Leave blank for all categories. Examples: 'publication', 'board-games-and-trpg', 'digital-games', 'character-and-goods', 'perfumes-and-beauty', 'food', 'technology-and-household-appliance', 'assorted-goods', 'webtoon-resources'.

## `sort` (type: `string`):

Sort order for the ranking feed.

## `maxItems` (type: `integer`):

Maximum number of projects to collect.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. RESIDENTIAL is recommended for large or repeated runs. If omitted, the actor runs with a direct connection.

## Actor input object example

```json
{
  "mode": "ranking",
  "query": "",
  "category": "",
  "sort": "popular",
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("kdatafactory/tumblbug-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("kdatafactory/tumblbug-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 '{}' |
apify call kdatafactory/tumblbug-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=kdatafactory/tumblbug-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/YdZZ8oAgfXkwpKIGH/builds/Suiuv8yBzikQr8Kzx/openapi.json