# Japan Company Enrichment — Bulk Registry Lookup & KYB Reports (`mameta/japan-company-enrichment`) Actor

Bulk-enrich Japanese companies from the official NTA registry (5.78M corporations). Mix company names and 13-digit 法人番号; KYB mode adds status, kana/romaji readings, risk flags and an English summary. For supplier onboarding, CRM cleanup and due diligence.

- **URL**: https://apify.com/mameta/japan-company-enrichment.md
- **Developed by:** [mameta](https://apify.com/mameta) (community)
- **Categories:** Business, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $50.00 / 1,000 company records

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

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

## Japan Company Enrichment — Bulk Registry Lookup & KYB Reports

Enrich a **list** of Japanese companies in one run, straight from the official
National Tax Agency (国税庁) corporate registry covering all **5.78M registered
corporations**. Feed it company names and/or 13-digit corporate numbers
(法人番号) — mixed input is fine — and get one dataset row per company.

### What you get per company

**Registry record mode** (default, cheaper):
official trade name, kana reading, registered address (+ postal code),
corporation kind, lifecycle status (`active` / `closed` with closure cause,
date, and successor after mergers), assignment/update dates.

**Full KYB report mode**:
everything above **plus** kana + romaji name readings, machine-actionable risk
flags (closed registry, recent registration/changes), an English summary, and
the dataset vintage — a one-row due-diligence pack that replaces 3–4 separate
lookups.

Company names are resolved against the registry with confidence scoring; an
optional prefecture filter narrows matching. Rows that fail to match are
returned with `ok: false` and an error message — **you are not charged for
failed rows**.

### Use cases

- Supplier / merchant onboarding (KYB) at scale
- CRM & lead-list cleanup: normalize trade names, attach 法人番号 and addresses
- Invoice-fraud and counterparty checks before payment runs
- Enriching scraped company lists with official registry data

### Input

```json
{
  "companies": ["トヨタ自動車株式会社", "7000012050002", "Sony Group"],
  "mode": "kyb",
  "prefecture": "東京都"
}
```

- `companies` — up to 200 names and/or 13-digit corporate numbers per run
- `mode` — `record` (registry record) or `kyb` (full report)
- `prefecture` — optional filter used when resolving names

### Output (dataset, one row per company)

```json
{
  "input": "トヨタ自動車株式会社",
  "ok": true,
  "corporate_number": "1180301018771",
  "name": "トヨタ自動車株式会社",
  "prefecture": "愛知県",
  "status": "active",
  "risk_flags": [],
  "summary_en": "Toyota Motor Corporation is an active stock company registered in 愛知県豊田市…"
}
```

### Pricing

Pay per event: each successfully enriched company is charged once —
`company-record` for registry rows, `kyb-report` for full KYB rows. Failed
rows are free. No subscription, no API key.

### Data source

Official 国税庁 (National Tax Agency) corporate registry, refreshed monthly.
Single-company lookups: see the
[Japan Company Lookup & KYB](https://apify.com/mameta/japan-company-kyb) Actor.
The underlying pay-per-call APIs are at [agentic-jp.com](https://agentic-jp.com).

# Actor input Schema

## `companies` (type: `array`):

Company names (Japanese or English) and/or 13-digit corporate numbers (法人番号), one per line. Mixed input is fine. Up to 200 per run.

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

Registry record is charged per company at the lookup rate; the full KYB report at the report rate.

## `prefecture` (type: `string`):

Optional prefecture (e.g. 東京都 or Tokyo) applied when resolving company names to narrow matching.

## Actor input object example

```json
{
  "companies": [
    "トヨタ自動車株式会社",
    "7000012050002"
  ],
  "mode": "record"
}
```

# 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 = {
    "companies": [
        "トヨタ自動車株式会社",
        "7000012050002"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("mameta/japan-company-enrichment").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 = { "companies": [
        "トヨタ自動車株式会社",
        "7000012050002",
    ] }

# Run the Actor and wait for it to finish
run = client.actor("mameta/japan-company-enrichment").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 '{
  "companies": [
    "トヨタ自動車株式会社",
    "7000012050002"
  ]
}' |
apify call mameta/japan-company-enrichment --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

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