# Korean Seller Info - Business Registration No. (사업자등록번호) (`scrapersdelight/kr-ecommerce-footer-contact-scraper`) Actor

Turn Korean shop domains into verified seller rows: business registration number (사업자등록번호, check-digit-valid), company name (상호), representative (대표자), mail-order number, address, phone, email and hosting provider. Charged only for rows with a valid number and a name: $4 per 1,000 sellers.

- **URL**: https://apify.com/scrapersdelight/kr-ecommerce-footer-contact-scraper.md
- **Developed by:** [Scrapers Delight](https://apify.com/scrapersdelight) (community)
- **Categories:** Lead generation, Business, E-commerce
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$4.00 / 1,000 per korean seller row returneds

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

## 🇰🇷 Korean Online Seller Info Scraper — Business Registration Number (사업자등록번호), 상호, 대표자 & Contacts

Paste a list of Korean online-shop domains and get back **one verified seller row per shop**, read off
the seller-information block (사업자정보) that Korean online shops print in their footer: the **상호**
(company name), the **대표자**, the **business registration number (사업자등록번호), checked with the NTS check digit**, the
**통신판매업 신고번호**, the **주소**, **전화**, **이메일** and the **호스팅서비스 제공자** — each with the
URL it was found on.

- **The identifier is verified:** every billed row carries a 사업자등록번호 that passes the National Tax
  Service check digit, plus the taxpayer type the number itself encodes (corporation / individual / …).
- **One legal entity per row:** the number in the shop's own FTC "사업자정보확인" link is the anchor. A page
  that prints a different company — a payment agent, a group company — is kept out of the row and
  reported in `rejectedEntities`.
- **A company name on every billed row:** from the 상호 label, the unlabelled heading above the block,
  the 사업자정보 accordion header, the copyright line or the bank-transfer account holder — with its
  source, so you can tell a legal name from a brand.
- **You pay only for a verified seller.** $4.00 per 1,000 sellers. A dead site, a refused site, a site
  with no seller block, a number that fails the check digit and a number without a company name are
  **never charged**.

***

### 🔍 What it does, per domain

1. **Fetches the homepage** — directly from Apify's network — and reads its footer text, the strings
   inside its inline scripts (Next.js / React storefronts keep the footer there), and its FTC
   verification link.
2. **Goes to the page the storefront platform renders the block on** when the homepage does not carry
   it: Cafe24 `/shopinfo/company.html`, Godomall `/service/company.php`, Makeshop `/html/info.html`,
   Firstmall, Wisa and Youngcart equivalents. The platform is detected from the homepage bytes.
3. **Follows the shop's own links**, ranked: 사업자정보 / 회사소개 > 이용안내 > 이용약관 >
   개인정보처리방침 > 고객센터. A subpage is parsed only if it carries a seller-block marker.
4. **Reads the storefront's own JS bundles** as a last rung — only on a client-rendered homepage, direct
   requests only, capped at 4 MB per domain. Some shops ship their footer only as text inside a bundle.
5. **Stops as soon as the row is complete.**

Pointer homepages (meta refresh, frameset, a lone iframe) are followed. A homepage that answers only on
the other host form (`www.` vs apex) is retried on that form first. A host that refuses a foreign IP
(403 / 406 / a 자동등록방지 interstitial / a reset), or sends a foreign visitor to its global site, is
retried once through an Apify residential exit in Korea.

***

### 📦 What you get — every field

#### Seller identity

| Field | What it is |
|---|---|
| `companyName` | 상호 — the company name as the shop prints it (`(주)바이와이제이`, `주식회사 풀리오`, `F&S Retail Co..Ltd.`) |
| `companyNameSource` | `label` (상호 / 법인명 / COMPANY) · `block_heading` (legal name directly above the block) · `accordion` (the "…사업자 정보" header) · `copyright` · `account_holder` (예금주) · `block_heading_brand` (unlabelled name that equals the shop's own name — sole traders) · `json-key` |
| `storeName` / `storeNameSource` | the shop's own name (상점명 label, `og:site_name` or `<title>`) — the brand, kept apart from the 상호 |
| `ceoName` | 대표자 as printed (`조만호, 조남성`, `오세철 외 2명`, `LEE JUNGMIN`) |
| `privacyOfficer` | 개인정보보호책임자 |
| `hostingProvider` | 호스팅서비스 제공자 (`카페24(주)`, `(주)아임웹`, `MAKESHOP`) |
| `nameCandidates` | every company-name candidate the page offered, with its source (switch off with `includeNameCandidates`) |

#### Registry numbers

| Field | What it is |
|---|---|
| `bizRegNumber` | Business registration number (사업자등록번호), `123-45-67890` — **always check-digit-valid** |
| `bizRegNumberDigits` | the same, 10 digits |
| `bizRegNumberChecksumValid` | `true` on every billed row |
| `bizRegEntityType` | from the NTS code in digits 4–5: `corporation`, `corporation_branch`, `individual`, `individual_tax_exempt`, `nonprofit_corporation`, `foreign_corporation`, `government`, `religious_organisation`, `other_non_individual` |
| `bizRegNumberSource` | what anchored the number: `ftc-link` (the shop's own FTC verification link) · `homepage-label` · `subpage-label` · `js-bundle` |
| `bizRegNumberFoundAs` | every form the number appeared in (`label`, `ftc-link`, `pattern`, `json-key`) |
| `ftcLinkPresent` / `ftcLinkMatches` | whether the homepage links the FTC verification page, and whether that link carries this number |
| `ftcVerificationUrl` | the FTC 사업자정보확인 URL for this number |
| `mailOrderNumber` | 통신판매업 신고번호, normalised (`2015-서울강남-02934`; pre-2010 numbers as `25-3133`) |
| `mailOrderNumberPrinted` | exactly as printed (`제2022-서울송파-1690호`) |
| `mailOrderExempt` | `true` when the shop states 신고면제 instead of a number |

#### Contact

| Field | What it is |
|---|---|
| `address` | 사업장 주소 — the seller's own; return/exchange (반품·교환) addresses are never used |
| `phone` | 대표전화 / 고객센터, normalised (`1544-7729`, `02-540-4111`) |
| `fax` | 팩스 |
| `email` | 이메일 — Cloudflare-protected addresses are decoded |

#### Completeness and provenance

| Field | What it is |
|---|---|
| `completeness` | `complete` · `kyb` · `id_only` — see below |
| `missingFields` | which statutory fields the shop did not print |
| `platform` | `cafe24`, `makeshop`, `godomall`, `imweb`, `sixshop`, `shopby`, `firstmall`, `wisa`, `youngcart`, `shopify`, `wordpress`, `wix`, `custom` |
| `disclosureUrl` | the page the number was found on |
| `rejectedEntities` | other companies printed on the shop's pages (payment agent, group company) — number and URL, never merged |
| `otherNumbersPrintedInvalid` | any other 10-digit "business number" on the site that fails the check digit |
| `redirectedTo` / `geoRetry` | set when the domain redirected to another domain, or was retried from Korea |
| `domain`, `inputUrl`, `resolvedUrl`, `pagesParsed`, `pagesChecked`, `jsBundlesFetched`, `stableId`, `fetchedAt`, `elapsedMs` | provenance |

#### Completeness — the billing definition

| Grade | Means | Billed |
|---|---|---|
| `complete` | check-digit-valid 사업자등록번호 + 상호 + 대표자 + 통신판매업 신고번호 (or a stated exemption) + 주소 + a phone or email | yes |
| `kyb` | check-digit-valid 사업자등록번호 + 상호 — the verified ID a PSP or KYB team onboards on, even when the site omits the phone or the mail-order number | yes |
| `id_only` | a check-digit-valid 사업자등록번호 but no company name anywhere on the site | **no** (delivered free with `includeMissRows`) |

Set **`minCompleteness: "complete"`** to receive and pay for complete rows only.

***

### 📊 Measured results — real numbers, not claims

Two sampling frames with opposite biases, run on Apify with the shipping defaults (build 0.1.2,
2026-09-29):

- **Frame A — 55 Korean fashion and beauty brand shops** (a hand-picked list of established sellers).
- **Frame B — 80 sellers drawn at random from the FTC's own 통신판매사업자 register** (Seoul Mapo,
  Gyeonggi Seongnam, Busan Haeundae), keeping sellers whose register row lists their own domain.

| | Frame A | Frame B |
|---|---|---|
| Domains | 55 | 80 |
| Gone (no DNS, or the homepage is a 404 on both host forms) | 3 | 40 |
| Reachable | 52 | 40 |
| **Billed rows** (`kyb` + `complete`) | **38 = 73.1 %** of reachable | **23 = 57.5 %** of reachable |
| …of which `complete` | 22 | 12 |
| Same company as a domain already delivered (free duplicate) | 1 | 0 |
| Number found, no company name (`id_only`, not billed) | 1 | 2 |
| No seller block in anything the site serves | 8 | 13 |
| Refused every transport | 4 | 2 |
| Run time / cost at 512 MB | 98 s / $0.0073 | 60 s / $0.0036 |

Half of Frame B's register domains no longer resolve: that is what a seller register's domain column
looks like after a few years, and none of those rows are charged. The sites that "publish no block"
are placeholder pages (`사이트 준비중`), app landing pages, blogs on a re-used domain and storefronts
that load their footer from a private API.

#### Per-field fill on the billed rows (Frame A / Frame B)

| Field | Frame A (38 rows) | Frame B (23 rows) |
|---|---|---|
| 사업자등록번호 (check-digit-valid) | 100 % | 100 % |
| 상호 `companyName` | 100 % | 100 % |
| 대표자 `ceoName` | 100 % | 91 % |
| 통신판매업 신고번호 | 87 % | 74 % |
| 주소 `address` | 76 % | 61 % |
| 전화 `phone` | 68 % | 83 % |
| 이메일 `email` | 50 % | 70 % |
| 호스팅서비스 제공자 | 55 % | 17 % |
| 개인정보보호책임자 | 58 % | 35 % |

#### How you can tell it is not a parser gap

An independent check scans every byte fetched for each site for a check-digit-valid number next to a
사업자 / BUSINESS label or inside an FTC link. Of the sites where that check finds one, the Actor turned
**38 of 38** (Frame A) and **21 of 22** (Frame B) into billed rows (same two frames, fetched directly).
The one miss prints its number only inside a JS bundle with no company name next to it.

#### Cross-checked against the FTC register

For Frame B the register row is ground truth. The number the Actor read equals the number the register
lists for that domain on **17 of 23** billed rows. The other 6 were checked by hand: each site prints a
different operator from the one registered with that domain years ago (one domain now redirects to
another company's site, reported in `redirectedTo`). The Actor reports what the site prints today. On
the 17 rows whose number matches, the NTS type code in the number agrees with the register's 법인/개인
flag on 16.

#### By storefront platform (seen → billed)

Cafe24 **14 → 13** and **6 → 6** · Makeshop **4 → 4** and **1 → 1** · Godomall **2 → 2** · Youngcart **2 → 2** ·
Imweb **5 → 3** (the other two are `사이트 준비중` placeholders) · custom-built sites **25 → 17** and **14 → 7**.

#### A real row (build 0.1.2, verified run)

```json
{
  "domain": "nain.co.kr",
  "platform": "makeshop",
  "status": "ok",
  "companyName": "(주)바이와이제이",
  "companyNameSource": "label",
  "storeName": "Atelier Nain 공식 온라인스토어",
  "storeNameSource": "title",
  "ceoName": "전혜진",
  "bizRegNumber": "201-86-10124",
  "bizRegNumberDigits": "2018610124",
  "bizRegNumberChecksumValid": true,
  "bizRegNumberSource": "ftc-link",
  "bizRegNumberFoundAs": ["ftc-link", "label"],
  "bizRegEntityType": "corporation",
  "ftcLinkPresent": true,
  "ftcLinkMatches": true,
  "ftcVerificationUrl": "https://www.ftc.go.kr/bizCommPop.do?wrkr_no=2018610124",
  "mailOrderNumber": "2015-서울강남-02934",
  "mailOrderNumberPrinted": "2015-서울강남-02934",
  "mailOrderExempt": false,
  "address": "서울 강남구 언주로81길 5",
  "phone": "1544-7729",
  "fax": null,
  "email": "byyj_ateliernain@naver.com",
  "hostingProvider": "MAKESHOP",
  "privacyOfficer": "전혜진",
  "disclosureUrl": "https://nain.co.kr/",
  "pagesParsed": 1,
  "pagesChecked": 1,
  "rejectedEntities": [],
  "nameCandidates": [
    { "value": "(주)바이와이제이", "source": "label" },
    { "value": "NAIN", "source": "copyright" }
  ],
  "completeness": "complete",
  "missingFields": [],
  "stableId": "2018610124",
  "elapsedMs": 1897
}
```

***

### 🧰 Every input

| Input | Default | What it does |
|---|---|---|
| `domains` | demo list | Shop domains, homepage URLs or any page URL. Platform subdomains (`x.cafe24.com`, `y.imweb.me`) are separate shops. Empty = the built-in 5-shop demo. |
| `startUrls` | — | The same list as URLs (Make, Zapier, Clay, Google Sheets, or a link to a text/CSV file). |
| `domainsFileUrl` | — | A CSV / TXT / JSON / JSONL file of domains, UTF-8 or EUC-KR. Column auto-detected (`domain`, `website`, `url`, `인터넷도메인`, `도메인`, `홈페이지`); a cell listing several domains uses the first. |
| `sourceDatasetId` + `domainFieldName` | — | Enrich the output of another Actor run. |
| `skipDomains` | — | Skip these domains before any request. |
| `previousDatasetId` | — | Skip domains and 사업자등록번호s an earlier run of this Actor already delivered. |
| `maxItems` | 1000 | Cap on billed rows. 0 = no cap. |
| `maxDomains` | 0 | Cap on domains attempted. 0 = all. |
| `minCompleteness` | `kyb` | `kyb` or `complete` — the lowest grade delivered and billed. |
| `requireFields` | — | Deliver (and bill) only rows that also carry these fields (`ceoName`, `mailOrderNumber`, `address`, `phone`, `email`, `phoneOrEmail`, `hostingProvider`). |
| `entityTypes` | all | Deliver only these NTS taxpayer types (e.g. `corporation` only). |
| `dedupeBy` | `businessNumber` | One billed row per company (two domains of the same 사업자등록번호 bill once), per `domain`, or `none`. |
| `includeMissRows` | false | Also deliver a free row for every domain that was not billed, with its status and reason. |
| `includeNameCandidates` | true | Add `nameCandidates`. |
| `saveRawPages` | false | Store every page read, gzipped, in the run's key-value store as `<domain>__<page>`. |
| `readJsBundles` | true | The JS-bundle rung for client-rendered storefronts. |
| `maxPagesParsed` | 3 | Subpages parsed per domain on top of the homepage. |
| `maxPagesChecked` | 6 | Subpage requests per domain. |
| `perDomainTimeoutSecs` | 60 | Wall-clock budget per domain. |
| `requestTimeoutSecs` | 15 | Timeout per request. |
| `maxRequestRetries` | 2 | Retries; a refusal is retried from a Korean residential exit with a fresh session. |
| `requestConcurrency` | 8 | Domains in parallel (lowered automatically if the run's memory cannot hold it). |
| `escalateToResidentialOnBlock` | true | Retry refusals and geo-redirects from Korea. |
| `proxyConfiguration` | none | Your own proxy for every first attempt. |

**Output:** the dataset (one row per billed seller, plus miss rows if you ask), and a `RUN_SUMMARY`
record in the key-value store with the counts of every kind of non-billed domain, completeness grades,
field fill, platforms and transport.

***

### 💰 Pricing

**$4.00 per 1,000 sellers** — $0.004 per billed row (event `seller-disclosure`), charged only for rows
graded `kyb` or `complete`. No start fee. Dead, refused, block-less, invalid-number, name-less, filtered
and duplicate domains are never charged. The built-in demo (empty input) bills at most 5 rows.

***

### ❓ FAQ

**Does it read Naver SmartStore, Coupang or Gmarket seller pages?** No — it reads the seller's **own**
shop domain. A `smartstore.naver.com/…` URL is Naver's page.

**Why is a row `kyb` and not `complete`?** The shop did not print one of 대표자, 통신판매업 신고번호, 주소
or a phone/email — `missingFields` says which. The number and the company name are still verified.

**Two of my domains returned one row.** They belong to the same company (same 사업자등록번호). Set
`dedupeBy: "domain"` to receive — and pay for — one row per domain.

**Why is `companyName` in English for some shops?** The shop prints its block in English
(`BUSINESS NAME FIVE SPACE CO.,LTD`, `F&S Retail Co..Ltd.`). The Actor returns what the shop prints and
never translates.

***

### ⚠️ Data limits

- **A row is what the shop prints.** Where the shop's operator changed and the footer did not, the row
  shows the footer. The FTC verification URL is included for your own check.
- **The FTC popup itself is not read** (it is behind a CAPTCHA).
- **Storefronts that fetch their footer from a private API at runtime** (measured in Frame A: 11st.co.kr,
  brandi.co.kr, lotteon.com, musinsa.com) and **hosts that refuse every transport** (gmarket.co.kr 403,
  kurly.com 400; oliveyoung.co.kr and beanpole.com time out) return no row and are not charged.
- **Phone and email are what the block prints:** 68–83 % and 50–70 % of billed rows carry them.
- **Addresses** are the 사업장 주소 as printed, not geocoded.

# Actor input Schema

## `domains` (type: `array`):

One entry per shop. A bare domain ("romand.co.kr"), a homepage URL ("https://www.xexymix.com") or any page of the shop. Platform subdomains are separate shops and are kept apart ("x.cafe24.com", "y.imweb.me"). Any TLD works - Korean sellers trade on .com and .kr as well as .co.kr. Leave empty to run the built-in 5-shop demo.

## `startUrls` (type: `array`):

The same list handed over as URLs, so Make, Zapier, Clay or a Google Sheet can pass it natively (a link to a text/CSV file of URLs also works). Merged with "Korean shop domains".

## `domainsFileUrl` (type: `string`):

URL of a CSV, TXT, JSON or JSONL file holding the domains - for lists too big to paste. UTF-8 or EUC-KR. The column is auto-detected (domain / website / url / 인터넷도메인 / 도메인 / 홈페이지) or set with "Domain field / CSV column"; a cell listing several domains uses the first.

## `sourceDatasetId` (type: `string`):

Dataset ID of a previous Actor run. Each item's domain / website column is read and enriched - e.g. run a store-list or directory scraper first, then pipe its output here.

## `domainFieldName` (type: `string`):

Which field of the source dataset (or which CSV column of the list file) holds the domain. Leave empty to auto-detect. Dotted paths like "company.website" work.

## `skipDomains` (type: `array`):

Domains to skip outright, before any request - sellers you already have. Matched on the registrable domain, so "www.x.co.kr/page" and "x.co.kr" are the same entry.

## `previousDatasetId` (type: `string`):

Dataset ID of an earlier run of THIS Actor. Its domains are skipped before any request, and its 사업자등록번호 values count as already delivered - so a monthly re-run never re-charges you for a seller you already have.

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

Hard cap on rows DELIVERED AND BILLED this run. Distinct from "Max domains": a list yields fewer billed rows than domains (dead hosts, sites without a seller block, a number with no company name are never billed). 0 = no cap.

## `maxDomains` (type: `integer`):

Cap on domains ATTEMPTED, applied before any request. Use it to sample a big list cheaply. 0 = every domain supplied.

## `minCompleteness` (type: `string`):

"kyb" (default): a check-digit-valid 사업자등록번호 plus the company name - the verified ID a PSP or KYB team onboards on, even when the site omits the phone or the mail-order number. "complete": only rows that also carry 대표자, 통신판매업 신고번호 (or a stated exemption), 주소 and a phone or email.

## `requireFields` (type: `array`):

Deliver (and bill) only rows carrying every field ticked here. Rows without them are filtered out and never billed.

## `entityTypes` (type: `array`):

Filter on the taxpayer type encoded in digits 4-5 of the 사업자등록번호 (the NTS code). Empty = all.

## `dedupeBy` (type: `string`):

"businessNumber" (default): two domains of the same company (same 사업자등록번호) bill once; the second is a free duplicate. "domain": one billed row per domain even when two domains share a company. "none": no deduplication.

## `includeMissRows` (type: `boolean`):

Also push a free row for every domain that did NOT yield a billed row - dead host, refused, no seller block, a number that fails the check digit, a number with no company name (id_only), filtered or duplicate - each with its status and reason. Never charged.

## `includeNameCandidates` (type: `boolean`):

Add every company-name candidate the page offered (label, block heading, accordion header, copyright line, bank-transfer account holder) with its source, so you can audit or override the chosen companyName.

## `saveRawPages` (type: `boolean`):

Store every page the parser read, gzipped, in the run's key-value store as <domain>\_\_<page>, so any row can be checked against the exact bytes it came from. Costs storage, never charged per row.

## `readJsBundles` (type: `boolean`):

Last rung for client-rendered storefronts, which ship the footer as text inside a JavaScript bundle. Direct requests only, capped at 36 bundles / 4 MB per domain, and only on a client-rendered homepage, and only when the HTML pages gave no business number.

## `maxPagesParsed` (type: `integer`):

How many subpages (platform company page, 회사소개, 이용안내, 이용약관 …) may be parsed and merged on top of the homepage. The crawl stops as soon as the row is complete.

## `maxPagesChecked` (type: `integer`):

Hard cap on subpage requests per domain (a page is only parsed when it carries a seller-block marker).

## `perDomainTimeoutSecs` (type: `integer`):

Wall-clock deadline for one domain, all pages included.

## `requestTimeoutSecs` (type: `integer`):

Timeout for one HTTP request.

## `maxRequestRetries` (type: `integer`):

Retries after the first attempt. A transient error gets one more direct try; a refusal (403 / 406 / challenge) is retried on a Korean residential exit with a fresh session each time.

## `requestConcurrency` (type: `integer`):

How many domains are worked in parallel. The Actor lowers it automatically, with a warning, when the memory allocated to the run cannot support it.

## `escalateToResidentialOnBlock` (type: `boolean`):

On a refusal (403 / 406 / a 자동등록방지 interstitial / a reset) - and once for a homepage that redirects a foreign visitor to a global site - retry through an Apify residential exit in Korea. It fires only on those cases, never on a dead host or a 404.

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

Leave as is for the measured default: direct requests first, then an Apify residential exit in Korea only where a host refuses a foreign IP. Supply your own proxy URLs or an Apify proxy group to route every first attempt through them instead.

## Actor input object example

```json
{
  "domains": [
    "nain.co.kr",
    "romand.co.kr",
    "xexymix.com",
    "wconcept.co.kr",
    "andar.co.kr"
  ],
  "maxItems": 1000,
  "maxDomains": 0,
  "minCompleteness": "kyb",
  "dedupeBy": "businessNumber",
  "includeMissRows": false,
  "includeNameCandidates": true,
  "saveRawPages": false,
  "readJsBundles": true,
  "maxPagesParsed": 3,
  "maxPagesChecked": 6,
  "perDomainTimeoutSecs": 60,
  "requestTimeoutSecs": 15,
  "maxRequestRetries": 2,
  "requestConcurrency": 8,
  "escalateToResidentialOnBlock": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `sellers` (type: `string`):

One item per shop domain whose seller block carried a check-digit-valid 사업자등록번호 and a company name, plus every other statutory field found and a completeness grade.

## `runSummary` (type: `string`):

Coverage accounting: domains attempted, rows billed, completeness grades, and the kinds of nothing (dead host, refused, no seller block, number fails the check digit, number without a company name) kept apart - none of them charged.

# 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 = {
    "domains": [
        "nain.co.kr",
        "romand.co.kr",
        "xexymix.com",
        "wconcept.co.kr",
        "andar.co.kr"
    ],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapersdelight/kr-ecommerce-footer-contact-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 = {
    "domains": [
        "nain.co.kr",
        "romand.co.kr",
        "xexymix.com",
        "wconcept.co.kr",
        "andar.co.kr",
    ],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("scrapersdelight/kr-ecommerce-footer-contact-scraper").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 '{
  "domains": [
    "nain.co.kr",
    "romand.co.kr",
    "xexymix.com",
    "wconcept.co.kr",
    "andar.co.kr"
  ],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call scrapersdelight/kr-ecommerce-footer-contact-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapersdelight/kr-ecommerce-footer-contact-scraper"
        }
    }
}
```

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/ClU2qLgdl1xndxENj/builds/IECp34XyyXwpxtB4S/openapi.json
