{
  "openapi": "3.0.1",
  "info": {
    "title": "Korean Seller Info - Business Registration No. (사업자등록번호)",
    "description": "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.",
    "version": "0.1",
    "x-build-id": "IECp34XyyXwpxtB4S"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~kr-ecommerce-footer-contact-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-kr-ecommerce-footer-contact-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/scrapersdelight~kr-ecommerce-footer-contact-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-kr-ecommerce-footer-contact-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/scrapersdelight~kr-ecommerce-footer-contact-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-kr-ecommerce-footer-contact-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": {
          "domains": {
            "title": "Korean shop domains (or any page URL)",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Start URLs (list source)",
            "type": "array",
            "description": "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\".",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "domainsFileUrl": {
            "title": "Domain list file URL",
            "type": "string",
            "description": "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": {
            "title": "Enrich an existing dataset",
            "type": "string",
            "description": "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": {
            "title": "Domain field / CSV column",
            "type": "string",
            "description": "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": {
            "title": "Suppression list",
            "type": "array",
            "description": "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.",
            "items": {
              "type": "string"
            }
          },
          "previousDatasetId": {
            "title": "Skip rows already delivered (dataset ID)",
            "type": "string",
            "description": "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": {
            "title": "Max results (billed rows)",
            "minimum": 0,
            "type": "integer",
            "description": "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.",
            "default": 1000
          },
          "maxDomains": {
            "title": "Max domains attempted",
            "minimum": 0,
            "type": "integer",
            "description": "Cap on domains ATTEMPTED, applied before any request. Use it to sample a big list cheaply. 0 = every domain supplied.",
            "default": 0
          },
          "minCompleteness": {
            "title": "Minimum completeness to deliver and bill",
            "enum": [
              "kyb",
              "complete"
            ],
            "type": "string",
            "description": "\"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.",
            "default": "kyb"
          },
          "requireFields": {
            "title": "Only rows that also have",
            "type": "array",
            "description": "Deliver (and bill) only rows carrying every field ticked here. Rows without them are filtered out and never billed.",
            "items": {
              "type": "string",
              "enum": [
                "ceoName",
                "mailOrderNumber",
                "address",
                "phone",
                "email",
                "phoneOrEmail",
                "hostingProvider"
              ],
              "enumTitles": [
                "대표자 (representative)",
                "통신판매업 신고번호 (mail-order number)",
                "주소 (address)",
                "Phone",
                "Email",
                "Phone or email",
                "호스팅서비스 제공자 (hosting provider)"
              ]
            }
          },
          "entityTypes": {
            "title": "Only these business-number types",
            "type": "array",
            "description": "Filter on the taxpayer type encoded in digits 4-5 of the 사업자등록번호 (the NTS code). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "corporation",
                "corporation_branch",
                "individual",
                "individual_tax_exempt",
                "nonprofit_corporation",
                "foreign_corporation",
                "government",
                "religious_organisation",
                "other_non_individual"
              ],
              "enumTitles": [
                "Corporation (법인, head office)",
                "Corporation branch (법인 지점)",
                "Individual business (개인 과세)",
                "Individual, tax-exempt (개인 면세)",
                "Non-profit corporation",
                "Foreign corporation",
                "Government body",
                "Religious organisation",
                "Other non-individual"
              ]
            }
          },
          "dedupeBy": {
            "title": "One billed row per",
            "enum": [
              "businessNumber",
              "domain",
              "none"
            ],
            "type": "string",
            "description": "\"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.",
            "default": "businessNumber"
          },
          "includeMissRows": {
            "title": "Include unbilled miss rows",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "includeNameCandidates": {
            "title": "Include name candidates",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "saveRawPages": {
            "title": "Save the raw pages read (audit)",
            "type": "boolean",
            "description": "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.",
            "default": false
          },
          "readJsBundles": {
            "title": "Read the storefront's JS bundles when the HTML has no block",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "maxPagesParsed": {
            "title": "Max subpages parsed per domain",
            "minimum": 1,
            "maximum": 8,
            "type": "integer",
            "description": "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.",
            "default": 3
          },
          "maxPagesChecked": {
            "title": "Max subpages requested per domain",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Hard cap on subpage requests per domain (a page is only parsed when it carries a seller-block marker).",
            "default": 6
          },
          "perDomainTimeoutSecs": {
            "title": "Per-domain timeout (seconds)",
            "minimum": 10,
            "maximum": 300,
            "type": "integer",
            "description": "Wall-clock deadline for one domain, all pages included.",
            "default": 60
          },
          "requestTimeoutSecs": {
            "title": "Request timeout (seconds)",
            "minimum": 5,
            "maximum": 90,
            "type": "integer",
            "description": "Timeout for one HTTP request.",
            "default": 15
          },
          "maxRequestRetries": {
            "title": "Max request retries",
            "minimum": 0,
            "maximum": 5,
            "type": "integer",
            "description": "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.",
            "default": 2
          },
          "requestConcurrency": {
            "title": "Request concurrency",
            "minimum": 1,
            "maximum": 30,
            "type": "integer",
            "description": "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.",
            "default": 8
          },
          "escalateToResidentialOnBlock": {
            "title": "Retry refusals and geo-redirects from Korea",
            "type": "boolean",
            "description": "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.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "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.",
            "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "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
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}