# Korea E-commerce Company Leads (KFTC Register) (`japan-open-data/korea-online-seller-registry`) Actor

Get new Korean e-commerce companies from the official KFTC online seller register (통신판매업) in English: business registration number, store platform (own shop, Naver Smartstore, Coupang), website, category, district. Corporations only, no personal data, no API key. JSON via API/MCP, $5 per 1,000 rows.

- **URL**: https://apify.com/japan-open-data/korea-online-seller-registry.md
- **Developed by:** [Japan Open Data](https://apify.com/japan-open-data) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 company rows

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Korea E-commerce Company Leads (KFTC Register)

**Get new Korean e-commerce companies (통신판매업 / 통신판매사업자) in English from the official KFTC online seller register — store platform, website, product categories, status and district, corporations only.** Pick a province (and optionally a district such as `Gangnam-gu`) and get one flat English JSON row per company, newest registration first.

Every business that sells online in South Korea must file an online-seller registration (통신판매업 신고) with the Korea Fair Trade Commission (KFTC, 공정거래위원회). KFTC publishes that register (통신판매사업자 등록현황, about 1.8 million records, updated continuously) as free Korean CSV files per district — with sole traders' personal data, mixed encodings and broken columns. This Actor reads those official files on every run and returns **only the corporations that registered recently**, in English:

- **New companies, newest first:** `registeredWithinDays` (default 30) or `registeredFrom` gives you only what is new — Seoul alone adds about 850 online-selling corporations a month, Gyeonggi about 630.
- **Store platform for every company:** own web shop (Cafe24, Imweb, Shopify, custom domain), Naver Smartstore, Coupang, other marketplace, social media or app — filter `storePlatforms: ["ownDomain"]` to get D2C brands with their own site.
- **English product categories** (fashion and beauty, health and food, electronics, home…), sales channels, legal form, business registration number (사업자등록번호), online seller number and business status.
- **Corporations only, no personal data:** sole proprietors are never returned, and representative names, phone numbers, e-mail addresses and street addresses are never output (see [Privacy](#privacy-corporations-only-no-personal-data)).
- **No input required, no API key:** the default run returns last month's new corporations in Sejong in a few seconds.
- **$5 per 1,000 company rows, no subscription** — about $4.25 for a month of new online-selling corporations in Seoul (see [pricing](#how-much-does-it-cost)).

### What can you do with Korea E-commerce Company Leads?

- **B2B market entry and partner discovery:** payment, logistics (3PL, cross-border shipping), e-commerce SaaS and marketplace teams can see which Korean companies started selling online this month, on which platform and in which category, and research them on their own websites.
- **Find Korean D2C brands with their own web shop:** `storePlatforms: ["ownDomain"]` plus `productCategories: ["fashionAndBeauty"]` lists K-beauty and fashion companies running their own site, with the domain.
- **Supplier and distributor research** for brands and importers looking at the Korean market: who sells health food, cosmetics or electronics online, by district.
- **Market research:** how many companies registered to sell online in Seoul this month, which categories are growing, how many go to Naver Smartstore vs Coupang vs their own domain.
- **Business verification (KYB):** check that a Korean online shop is a registered corporation, with its business registration number, registration date and status.
- **AI agents:** answer "list new e-commerce companies in Gangnam-gu that sell fashion on their own website" with one tool call and an official source.

### How it compares

| | KFTC free download | Korean business-DB sellers | Store Leads (global) | **This Actor** |
|---|---|---|---|---|
| Data | Official register, Korean CSV per district | Mixed sources, contact lists | Web crawl of online stores (incl. Cafe24, Imweb) | **Official KFTC register, read fresh on every run** |
| Language | Korean | Korean | English | **English fields and labels** (company names kept in Korean, plus romanisation) |
| New registrations only | No (full files) | No | Partly | **Yes — by registration date** |
| Personal data | Yes (sole traders, representatives) | Often phone / e-mail lists | — | **None: corporations only, no contact details** |
| Price | Free | e.g. ₩165,000 for 1,000 records | Pro plan $250/month (export & API) | **$5 per 1,000 company rows, no subscription** |
| Access | Manual download | File delivery | Web app, API | **API, JSON/CSV/Excel, schedules, webhooks, MCP** |

Prices as published on kmong.com and storeleads.app, checked on 2 October 2026. If you read Korean and only need one district once, the free KFTC download may be enough; this Actor is for English output, new registrations only, corporations only and automated runs.

### How to use

1. Click **Try for free**. The default input lists the active corporations that registered as online sellers in the last 30 days in **Sejong** (about 15 companies, a few seconds).
2. Choose a **province** (`seoul`, `gyeonggi`, `busan`…) and optionally a **district** such as `Gangnam-gu`, `gangnam` or `강남구`.
3. Keep **Registered within the last N days** at 30 for last month's new companies, or set **Registered on or after** to the date of your previous run to get only what is new since then.
4. Optionally filter by **store platform**, **product category** and **business status**, and raise **Max results** (default 200) to get every company.
5. Run, then download the dataset as JSON, CSV or Excel, or read it through the API.

#### Run it every week

Create a **Schedule** in Apify Console (for example every Monday) with `registeredWithinDays: 7` for a steady feed of new Korean e-commerce companies, one run per province you follow. Connect a webhook, Google Sheets or your CRM import to receive the new rows automatically.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `province` | string | `sejong` | seoul, busan, daegu, incheon, gwangju, daejeon, ulsan, sejong, gyeonggi, gangwon, chungbuk, chungnam, jeonbuk, jeonnam, gyeongbuk, gyeongnam, jeju |
| `district` | string | – | One district (si / gun / gu) in English or Korean, e.g. `Gangnam-gu`, `gangnam`, `강남구`, `Suwon-si` |
| `registeredWithinDays` | integer | 30 | Registration date within the last N days (Korea time). 0 = any date |
| `registeredFrom` | string | – | `YYYY-MM-DD`; overrides `registeredWithinDays` |
| `businessStatus` | string | `active` | `active`, `inactive` (closed, suspended or deregistered) or `all` |
| `storePlatforms` | array | \[] | `ownDomain`, `naverSmartstore`, `coupang`, `otherMarketplace`, `socialMedia`, `mobileApp`, `none`, `other` |
| `productCategories` | array | \[] | `generalStore`, `fashionAndBeauty`, `healthAndFood`, `booksToysAndEducation`, `furnitureAndHome`, `computersAndOffice`, `electronicsAndAppliances`, `automotive`, `travelLeisureAndTickets`, `giftCards`, `adultProducts`, `other` |
| `maxResults` | integer | 200 | 1-20,000, newest first |

#### Input examples

Default (new corporations in Sejong, last 30 days):

```json
{}
```

New companies in Seoul in the last 7 days:

```json
{ "province": "seoul", "registeredWithinDays": 7, "maxResults": 1000 }
```

Fashion and beauty companies with their own web shop in Gangnam-gu, registered since 1 September 2026:

```json
{ "province": "seoul", "district": "Gangnam-gu", "registeredFrom": "2026-09-01",
  "storePlatforms": ["ownDomain"], "productCategories": ["fashionAndBeauty"] }
```

### Output

One row per company (a real row from a run on 1 October 2026):

```json
{
  "status": "ok",
  "businessName": "주식회사 팝인랩스",
  "businessNameRomanized": "Pabillaepseu",
  "businessNameLatin": null,
  "legalForm": "Stock company (jusik hoesa, Co., Ltd.)",
  "corporationType": "forProfitCorporation",
  "businessRegistrationNumber": "682-88-03734",
  "onlineSellerNumber": "2026-서울중구-1485",
  "registrationDate": "2026-10-01",
  "daysSinceRegistration": 0,
  "businessStatus": "active",
  "isActive": true,
  "storePlatform": "ownDomain",
  "website": "https://herbtamin.co.kr",
  "domain": "herbtamin.co.kr",
  "otherWebsites": null,
  "productCategories": "healthAndFood",
  "salesChannels": "internet",
  "province": "Seoul",
  "provinceKo": "서울특별시",
  "district": "Jung-gu",
  "districtKo": "중구",
  "fetchedAt": "2026-10-01T07:31:37Z",
  "source": "Korea Fair Trade Commission (KFTC), online seller register ..."
}
```

When nothing matches or the input is wrong you get **one free row** with `status: "not_found"` or `"error"` and an `error` sentence that says what to change:

```json
{
  "status": "error",
  "error": "\"district\" \"Atlantis\" is not a district of Seoul; use one of: Gangnam-gu (강남구), Gangdong-gu (강동구), ... Jungnang-gu (중랑구).",
  "fetchedAt": "2026-10-01T22:28:52Z",
  "province": "Seoul",
  "district": "Atlantis",
  "registeredFrom": "2026-09-02"
}
```

If some district files could not be read completely (for example an all-date search over the whole of Seoul that runs into the time limit, or a KFTC download error), the **first row** of the dataset is a free `status: "warning"` row: `error` says which districts are missing and how to narrow the input, `districtsNotRead` lists them (`; `-separated) and `filesNotRead` / `filesTotal` count them. The company rows that were found are still returned.

#### Output fields

| Field | Meaning |
|---|---|
| `status` | `ok`, `not_found`, `error` or `warning` (results incomplete, see above) |
| `businessName` | Trade name as registered, in Korean |
| `businessNameRomanized` | The name without its legal form, in Revised Romanization (machine transliteration, e.g. 팝인랩스 → Pabillaepseu) |
| `businessNameLatin` | The company's own Latin-script name when the register shows one, e.g. `CY Planet Inc.` |
| `legalForm` | e.g. Stock company (jusik hoesa, Co., Ltd.), Limited company (yuhan hoesa), Cooperative, Agricultural company |
| `corporationType` | From the registration number: forProfitCorporation, forProfitCorporationBranch, nonProfitCorporation, foreignCorporation, publicBody |
| `businessRegistrationNumber` | Korean business registration number (사업자등록번호), `XXX-XX-XXXXX` |
| `onlineSellerNumber` | KFTC online seller registration number (통신판매업 신고번호) |
| `registrationDate`, `daysSinceRegistration` | Date the online-selling registration was filed |
| `businessStatus`, `isActive` | active, suspended, closed, deregisteredByAuthority, cancelledByAuthority |
| `storePlatform` | Where the registered website is: ownDomain, naverSmartstore, coupang, otherMarketplace, socialMedia, mobileApp, none, other |
| `website`, `domain`, `otherWebsites` | First registered URL, its domain (own shops only) and further URLs |
| `productCategories` | English categories, `; `-separated |
| `salesChannels` | internet, tvHomeShopping, catalog, newspaperMagazine, other |
| `province`, `provinceKo`, `district`, `districtKo` | Where the company registered (the registering district office) |
| `fetchedAt`, `source` | Provenance |
| `error` | Plain-English reason on free rows |

Each run also saves a `RUN_SUMMARY` record in its key-value store: register records in range, corporate records, how many were withheld by the privacy check (by reason), how many matched your filters, files read and bytes downloaded.

### How much does it cost?

Pay per event, no subscription:

| Event | Price | When |
|---|---|---|
| Company row | **$0.005** ($5.00 per 1,000) | Each company returned (`status: "ok"`) |
| Actor start | $0.001 | Once per run, also when the run returns only a free row |
| `not_found` / `error` / `warning` rows | **free** | Nothing matched, the input was wrong, or some districts could not be read |

Examples:

| Use | Rows | Cost |
|---|---|---|
| Default input (Sejong, last 30 days) | about 15 | about $0.08 |
| Seoul, new corporations every week | about 200 a week | about $1.00 a week |
| Seoul, one month of new corporations | about 850 | about $4.25 |
| Gyeonggi, one month of new corporations | about 630 | about $3.15 |
| Seoul, own-domain shops only, one month | about 300 | about $1.50 |

Set **Maximum cost per run** in the run options to cap any run; the Actor stops when the cap is reached. Apify's free plan includes monthly credit you can use to try it.

### Use via API & MCP (AI agents)

REST API (synchronous, returns the rows):

```bash
curl -X POST "https://api.apify.com/v2/acts/japan-open-data~korea-online-seller-registry/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"province": "seoul", "registeredWithinDays": 7, "storePlatforms": ["ownDomain"], "maxResults": 100}'
```

Python:

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_TOKEN")
run = client.actor("japan-open-data/korea-online-seller-registry").call(
    run_input={"province": "gyeonggi", "registeredWithinDays": 30, "productCategories": ["healthAndFood"]})
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
    if row["status"] == "ok":
        print(row["businessName"], row["businessNameRomanized"], row["storePlatform"], row["website"], row["district"])
```

MCP: add the Apify MCP server (`https://mcp.apify.com`) to Claude, Cursor or any MCP client and enable the tool `japan-open-data/korea-online-seller-registry`.

Recommended settings for agents:

- For "new e-commerce companies in <city>", pass `province` (and `district` if given) with `registeredWithinDays` 7 or 30.
- Seoul and Gyeonggi are large: keep `maxResults` at a few hundred unless the user asks for everything.
- For searches over all dates (`registeredWithinDays: 0`), always pass a `district`.
- If the first row has `status: "warning"`, the results are incomplete: run again with `district` set to each name in `districtsNotRead`.
- `registrationDate` is the date the company registered as an online seller, not its incorporation date.
- Quote the source as KFTC and say that only corporations are included and no contact details are provided.

Summary for AI assistants: *This tool lists South Korean corporations registered as online sellers (통신판매업) with the Korea Fair Trade Commission, newest first, by province and district, as flat English JSON rows with business registration number, legal form, registration date, status, store platform (own domain, Naver Smartstore, Coupang…), website, product categories and district. Sole proprietors and all personal data are excluded.*

### Privacy: corporations only, no personal data

About 89% of the register are sole proprietors whose record carries the owner's full name, and every record lists a representative's name, phone number, e-mail and street address. This Actor:

- returns **only records the register marks as corporations (법인)** whose business registration number has a corporate code, and whose name contains a legal form (주식회사, (주), 유한회사, 협동조합, 사단법인…, or Co., Ltd. / Inc. / LLC);
- withholds a corporation whose name contains its representative's name (e.g. a company named after its owner) or whose name, without the legal form, has the shape of a Korean personal name;
- **never outputs** the representative's name, phone number, e-mail address or street address; the location is reduced to province and district;
- outputs only URL-shaped entries of the registered website column: free text, e-mail addresses and URLs containing a mobile phone number are dropped.

In September 2026 in Seoul this check withheld about 8% of corporate records (on the safe side, including some genuine brands). If a company is withheld that should not be, or one passes that should not, report it on the Issues tab.

**This is not a contact list.** KFTC notes that sending commercial e-mails or text messages without the recipient's prior consent is illegal in Korea (Act on Promotion of Information and Communications Network Utilization and Information Protection, Article 50 and penalties in Article 76), and that using personal information beyond the purpose of public disclosure is punishable under the Personal Information Protection Act. This Actor provides company facts for research and market entry, not contact details; reach companies through the channels they publish on their own websites and in line with Korean law.

### FAQ

#### Is this every online shop in Korea?

No. It is every business **registered as an online seller with KFTC** (a legal requirement for most online sellers, including marketplace sellers), filtered to corporations. Sole proprietors are excluded.

#### How fresh is the data?

KFTC updates its files continuously and the Actor reads them on every run; runs on 1 October 2026 already contained registrations filed that day.

#### Is it legal to use this data?

The register is published by KFTC as open data and listed on the Korea Public Data Portal with no restriction on use (이용허락범위: 제한 없음). The Actor removes all personal data. You are responsible for how you use the companies' information, in particular the Korean rules on unsolicited advertising described above.

#### Why is a company I know missing?

It may be registered as a sole proprietor, registered under another district, have no legal form in its registered name, or be withheld by the privacy check. Search older registrations with `registeredWithinDays: 0` and a `district`.

#### Why does a row have no website?

Some companies register only a marketplace name (for example "쿠팡" or "네이버") or a payment provider instead of a URL; `storePlatform` still shows the marketplace.

#### Can I get every company in Seoul, not just new ones?

Yes, one district at a time: `{"province": "seoul", "district": "Gangnam-gu", "registeredWithinDays": 0, "businessStatus": "all", "maxResults": 20000}`. Gangnam-gu has about 25,000 corporate records (active and inactive); the run takes about a minute.

### Known limitations

- `businessNameRomanized` is a machine transliteration of the Korean name; it is not the company's official English name (use `businessNameLatin` when present).
- `district` is the district office where the company registered, usually its business location.
- **Searches over all dates (`registeredWithinDays: 0`) for a whole large province** (Seoul, Gyeonggi) have to download hundreds of megabytes from KFTC and may not finish within the run time limit (300 seconds by default); the run then returns the companies found so far plus a free `status: "warning"` row first in the dataset that lists the districts not (fully) read in `districtsNotRead`. Pass a `district` for all-date searches, or give the run a longer timeout. Searches by recent registration date (the normal use) read only the newest part of each file and are not affected.
- About 0.1% of register lines are malformed in the source files; they are repaired where possible and skipped otherwise (counted in `RUN_SUMMARY`).
- Overseas (non-Korean) online sellers registered with KFTC are not included.

### Data source and licence

Source: Korea Fair Trade Commission (공정거래위원회), online seller register (통신판매사업자 등록현황) — [KFTC data download](https://www.ftc.go.kr/www/selectBizCommOpenList.do?key=255), also listed on the [Korea Public Data Portal](https://www.data.go.kr/data/15083251/fileData.do) with no restriction on use (이용허락범위: 제한 없음). Translated and reformatted; personal data removed. This Actor is not affiliated with, or endorsed by, the Korea Fair Trade Commission.

### More from Japan Open Data

- [NSW Rent Prices by Postcode (Official Bond Data)](https://apify.com/japan-open-data/nsw-rental-bond-rents) — median weekly rents for any New South Wales postcode or suburb by dwelling type and bedrooms, from NSW Fair Trading's official rental bond data, with quartiles and year-over-year change.
- [Poland Building Permits API: Construction Leads](https://apify.com/japan-open-data/poland-building-permits) — new Polish building permits (pozwolenia na budowę) issued to companies and public bodies, with investor, building category and site, from the official GUNB register.
- [France Building Permits API: Construction Leads](https://apify.com/japan-open-data/france-building-permits) — new French building permits filed by companies, with SIREN, project size and site, from the official Sitadel register.
- [UK Importers & Exporters by Product (HMRC Data)](https://apify.com/japan-open-data/uk-importer-exporter-directory) — UK companies that imported or exported a product each month, by HS code or keyword, from official HMRC trade data.
- [UK Visa Sponsor Register Tracker (Daily Changes)](https://apify.com/japan-open-data/uk-visa-sponsor-register) — new, removed and downgraded UK visa sponsor licences from the official Home Office register.
- [UK HGV Operator Licence Lookup (Official DVSA)](https://apify.com/japan-open-data/uk-hgv-operator-licence) — Great Britain's official HGV and bus / coach operator licences by company, postcode and fleet size.
- [UK Waste Carrier Licence Check (Environment Agency)](https://apify.com/japan-open-data/uk-waste-carrier-register) — check whether an English business is a registered waste carrier, broker or dealer.
- [Taiwan Real Estate Sold Prices API in English](https://apify.com/japan-open-data/taiwan-property-sold-prices) — official Taiwan actual-price-registration sales and rents by city and district, in English with price per ping and per m².
- [England Listed Building & Conservation Area Check](https://apify.com/japan-open-data/england-heritage-constraint-lookup) — official listed buildings, scheduled monuments, conservation areas and Article 4 directions for any postcode or coordinates in England.
- [England Protected Site Check: SSSI, AONB & Green Belt](https://apify.com/japan-open-data/england-protected-site-lookup) — SSSI, National Landscape (AONB), National Park, Green Belt, SAC/SPA and Ramsar checks for any English postcode or coordinates, one row per site, from official Natural England and DLUHC data.
- [France Property Risk Lookup by Address (Georisques)](https://apify.com/japan-open-data/france-property-risk-lookup) — official Géorisques risks for any French address or coordinates.
- [UK Flood Risk Lookup by Postcode (England)](https://apify.com/japan-open-data/uk-flood-zone-lookup) — Environment Agency flood zone, recorded flood extents and flood defences for any postcode in England.
- [US Flood Zone Lookup by Address (FEMA NFHL)](https://apify.com/japan-open-data/us-flood-zone-lookup) — official FEMA flood zone, base flood elevation and FIRM panel for any U.S. address or coordinates.
- [UK NHS Organisation Lookup (Official ODS Codes)](https://apify.com/japan-open-data/uk-nhs-organisation-lookup) — official NHS ODS register by postcode, type or ODS code: GP practices, pharmacies, dentists, trusts, care homes and more.
- [US Hail History by Location (NOAA NEXRAD Radar)](https://apify.com/japan-open-data/us-hail-history) — every hail day near any U.S. latitude/longitude with max estimated hail size.
- [US Storm Reports API: Hail, Wind & Tornado (NWS)](https://apify.com/japan-open-data/us-storm-reports-live) — U.S. hail, wind, tornado and flood reports from official NWS Local Storm Reports.
- [Mexico Gas Prices API by Station (Official CNE)](https://apify.com/japan-open-data/mexico-fuel-station-prices) — today's gas and diesel prices at every Mexican gas station.
- [Argentina Fuel Prices API by Station (Official)](https://apify.com/japan-open-data/argentina-fuel-station-prices) — last reported gasoline (nafta), diesel and CNG prices at every Argentine gas station.
- [TSA Checkpoint Travel Numbers (Daily, Weekly & YoY)](https://apify.com/japan-open-data/tsa-checkpoint-throughput) — daily U.S. TSA airport checkpoint traveler counts.
- [Japan Postal Code & Address in English](https://apify.com/japan-open-data/japan-postal-code-english) — Japanese postal codes and addresses in English/romaji, kanji and kana.

### Feedback

Found a wrong row, a platform that is misclassified, or a company withheld that should not be? Open an issue on the **Issues** tab — it will be read.

# Actor input Schema

## `province` (type: `string`):

Where the online sellers are registered. One of: seoul, busan, daegu, incheon, gwangju, daejeon, ulsan, sejong, gyeonggi, gangwon, chungbuk, chungnam, jeonbuk, jeonnam, gyeongbuk, gyeongnam, jeju. Default: sejong (small, fast).

## `district` (type: `string`):

Only one district (si / gun / gu) of the province, in English or Korean, e.g. "Gangnam-gu", "gangnam", "강남구", "Suwon-si". Leave empty for the whole province. For Seoul or Gyeonggi with registeredWithinDays = 0 (any date), set a district: otherwise the run can reach its time limit and return incomplete results with a free "warning" row listing the districts not read. An unknown name returns a free error row listing the valid districts.

## `registeredWithinDays` (type: `integer`):

Only sellers whose online-seller registration date is within this many days (Korea time). Default 30 = new e-commerce companies of the last month. 0 = any date (the whole register for the area, newest first, up to maxResults); with 0, set a district for Seoul or Gyeonggi, or the result can be incomplete.

## `registeredFrom` (type: `string`):

A date such as "2026-09-01" (YYYY-MM-DD). Overrides registeredWithinDays. Use the date of your previous run to get only the new sellers since then.

## `businessStatus` (type: `string`):

"active" (default): operating sellers only. "inactive": closed, suspended or deregistered. "all": both.

## `storePlatforms` (type: `array`):

Only sellers whose (first) registered website is on these platforms. Values: ownDomain (own web shop), naverSmartstore, coupang, otherMarketplace (11st, Gmarket, Auction, Toss, Kakao, Musinsa ...), socialMedia, mobileApp, none, other. Example: \["ownDomain"]. Leave empty for all.

## `productCategories` (type: `array`):

Only sellers registered for at least one of these categories. Values: generalStore, fashionAndBeauty, healthAndFood, booksToysAndEducation, furnitureAndHome, computersAndOffice, electronicsAndAppliances, automotive, travelLeisureAndTickets, giftCards, adultProducts, other. Leave empty for all.

## `maxResults` (type: `integer`):

Maximum number of companies to return (newest registrations first).

## Actor input object example

```json
{
  "province": "sejong",
  "registeredWithinDays": 30,
  "businessStatus": "active",
  "storePlatforms": [],
  "productCategories": [],
  "maxResults": 200
}
```

# Actor output Schema

## `results` (type: `string`):

Company, registration number, registration date, store platform, website, product categories and district per corporation. Table view: overview.

# 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 = {
    "province": "sejong"
};

// Run the Actor and wait for it to finish
const run = await client.actor("japan-open-data/korea-online-seller-registry").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 = { "province": "sejong" }

# Run the Actor and wait for it to finish
run = client.actor("japan-open-data/korea-online-seller-registry").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "province": "sejong"
}' |
apify call japan-open-data/korea-online-seller-registry --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,japan-open-data/korea-online-seller-registry"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/pg1dEFrpNnX3O8meg/builds/KgVhsNPJZEaZMSERQ/openapi.json