# Japan Company Data Enrichment (Official Registry) (`minako-ph/japan-company-enrichment`) Actor Corporate number lookup + firmographics of Japanese companies, English output. Official gBizINFO and NTA registry data: capital, employees, subsidies, patents. - **URL**: https://apify.com/minako-ph/japan-company-enrichment.md - **Developed by:** [Minako Yamamoto](https://apify.com/minako-ph) (community) - **Categories:** Developer tools, Agents, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $6.00 / 1,000 company records 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 a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Data Enrichment (Official Registry) Corporate number lookup and firmographics for Japanese companies, in English. This Actor calls the **official gBizINFO API** (経済産業省 Gビズインフォ) and the **National Tax Agency corporate number registry** (法人番号 / houjin bangou) directly — **official API based, not a scraper**: no page-by-page crawling, no polite-bot throttling, no HTML parsing to break when a portal changes. It returns japan company registry data — capital, employees, establishment date, industry, subsidies, procurement and patent counts — as clean, snake_case JSON. Name resolution goes deeper than a plain registry wrap: company names are resolved to corporate numbers via the NTA registry with an explicit confidence verdict (`exact` / `selected` / `ambiguous` / `not_found` in `name_resolution`), and companies missing from gBizINFO are still returned via a documented NTA-registry fallback row (clearly marked `source: houjin`) instead of being silently dropped. English company names come from the official registry only (`name_en_method: "api_native"`) — **never invented**; where no registered English name exists the field is an honest `null`, and the optional LLM enrichment is clearly labeled and verified against the source. Every release is tested against frozen datasets with per-field golden verification. ### What you get One JSON item per company — real output for Hitachi, Ltd. (corporate number 7010001008844): ```json { "record_type": "company", "corporate_number": "7010001008844", "name_en": "Hitachi, Ltd.", "name_en_method": "api_native", "name_ja": "株式会社日立製作所", "name_kana": "ヒタチセイサクショ", "address_ja": "東京都千代田区丸の内１丁目６番６号", "postal_code": "1000005", "prefecture": "Tokyo", "prefecture_ja": "東京都", "representative_name_ja": "執行役社長兼CEO　德永　俊昭", "capital_stock_jpy": 466666000000, "employee_number": 35631, "date_of_establishment": "1920-02-01", "business_summary_ja": "デジタルシステム&サービス分野における事業、エナジー分野における事業…", "industry": ["Manufacturing"], "industry_codes": ["E"], "company_url": "http://www.hitachi.co.jp", "has_subsidy": true, "subsidy_count": 5, "has_procurement": true, "procurement_count": 423, "patent_count": 19950, "name_resolution": null, "source": "gbizinfo", "source_url": "https://api.info.gbiz.go.jp/hojin/v2/hojin/7010001008844", "retrieved_at": "2026-07-10T00:00:00+09:00", "attribution": "出典：経済産業省 Gビズインフォ", "schema_version": "0.1.0" } ```` With `enrich: true`, each item also carries an `enriched` block: `business_summary_en` (one English sentence, no figures, flagged if any number cannot be verified against the source) and `name_en` (romanized transliteration, generated **only when no official English name is registered**, marked `method: "llm"` with the model's own confidence). Every generated field carries `confidence` and `method` (`api_native` / `rule` / `llm`). ### How to use 1. Enter 13-digit `corporate_numbers` (法人番号) — the prefilled Hitachi example returns results in seconds. Or enter Japanese `company_names`, resolved via the official National Tax Agency registry (unambiguous matches only). 2. Pick `fields` to control which activity blocks are fetched (`subsidies`, `procurement`, `patents`). Patent responses can be tens of MB for large corporations — drop `patents` for faster runs. 3. Optionally set `enrich: true` for the English one-liner and name transliteration. 4. Read the results from the default dataset as JSON, CSV, or Excel. ### What this does NOT do - **Coverage is gBizINFO's ~4 million corporations**, and its activity data (subsidies, procurement, patents) covers only what each ministry publishes — not everything. Companies outside gBizINFO fall back to the National Tax Agency corporate number registry: you still get a billable row with the registry basics (name, address, corporate number; `source: "houjin"`), while gBizINFO-derived fields are `null`. Numbers found in neither source are reported as explicit non-billable error rows. - **English names are never guessed in the basic output.** `name_en` is the officially registered English name or `null`. The LLM transliteration (enriched only) is machine-generated, cannot be verbatim-verified by construction, and is labeled `method: "llm"` — treat it as a reading aid, not an official name. - **Address romanization stops at the prefecture** (rule-based, 47-prefecture table). Full street addresses are provided in Japanese only — no guessed romanization. - `industry` translates JSIC division codes; `business_item_codes` are qualification item codes kept as-is (upstream provides no names). - `company_names` resolution needs the National Tax Agency Web-API (operator-side credential) and accepts only unambiguous matches; ambiguous names are reported with candidate counts, never guessed. - The English business summary (enriched) contains no figures by design — numeric facts come from the structured fields. - The upstream APIs may change or suspend service without notice; we monitor with frozen-dataset regression tests. ### Pricing Pay-per-event, fully transparent: | Event | Price | | ---------------------- | ------------------- | | Actor start | $0.02 | | Company record (basic) | $0.006 | | Enriched company | $0.019 (LLM output) | Free allowance: **the first 20 companies of every run are free** (basic records; enriched records are always billed). Per-run limit: 1,000 companies. If your run hits the maximum charge limit you set, the Actor stops gracefully and keeps the partial results. ### Data source & attribution Data comes from [gBizINFO](https://info.gbiz.go.jp/) operated by Japan's Ministry of Economy, Trade and Industry, used under the Government of Japan Standard Terms of Use (v2.0): 出典：経済産業省 Gビズインフォ (Source: METI gBizINFO). Company name resolution uses the National Tax Agency Corporate Number System Web-API: このサービスは、国税庁法人番号システムのWeb-API機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない. This Actor is independent and not endorsed by METI or the NTA. ### More Japan data Actors This Actor is part of a family of official-API-based Japan data Actors. See also [**Japan Company Filings (EDINET Official)**](https://apify.com/minako-ph/japan-edinet-filings) — structured financial filings of listed Japanese companies —, [**Japan Subsidies & Grants Data (Official)**](https://apify.com/minako-ph/japan-subsidies-grants) — which Japanese companies received which subsidies —, and [**Japan Real Estate Transaction Prices (MLIT Official)**](https://apify.com/minako-ph/japan-real-estate-prices). Check the developer profile for the full list. ### Contact Found an issue or need a field the upstream API provides but this Actor doesn't expose yet? Open a ticket on the **Issues** tab — first response within 48 hours. # Actor input Schema ## `corporate_numbers` (type: `array`): 13-digit Japanese corporate numbers (法人番号), e.g. 7010001008844 for Hitachi, Ltd. Up to 1,000 companies per run. ## `company_names` (type: `array`): Japanese company names, resolved to corporate numbers via the official National Tax Agency registry. Unambiguous matches only — ambiguous names are reported, not guessed. ## `fields` (type: `array`): Which government-activity blocks to fetch per company: subsidies, procurement, patents. Default: all three. Patent responses can be tens of MB for large corporations — drop "patents" for faster runs. ## `enrich` (type: `boolean`): Add an English one-sentence business summary and a romanized company name (only when no official English name is registered). Uses an LLM; billed per enriched company. ## Actor input object example ```json { "corporate_numbers": [ "7010001008844" ], "fields": [ "subsidies", "procurement", "patents" ], "enrich": false } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "corporate_numbers": [ "7010001008844" ], "fields": [ "subsidies", "procurement", "patents" ] }; // Run the Actor and wait for it to finish const run = await client.actor("minako-ph/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "corporate_numbers": ["7010001008844"], "fields": [ "subsidies", "procurement", "patents", ], } # Run the Actor and wait for it to finish run = client.actor("minako-ph/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 '{ "corporate_numbers": [ "7010001008844" ], "fields": [ "subsidies", "procurement", "patents" ] }' | apify call minako-ph/japan-company-enrichment --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=minako-ph/japan-company-enrichment", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Japan Company Data Enrichment (Official Registry)", "description": "Corporate number lookup + firmographics of Japanese companies, English output. Official gBizINFO and NTA registry data: capital, employees, subsidies, patents.", "version": "0.1", "x-build-id": "thBj4cMm4S3rOp7bq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/minako-ph~japan-company-enrichment/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-minako-ph-japan-company-enrichment", "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/minako-ph~japan-company-enrichment/runs": { "post": { "operationId": "runs-sync-minako-ph-japan-company-enrichment", "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/minako-ph~japan-company-enrichment/run-sync": { "post": { "operationId": "run-sync-minako-ph-japan-company-enrichment", "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": { "corporate_numbers": { "title": "Corporate numbers", "type": "array", "description": "13-digit Japanese corporate numbers (法人番号), e.g. 7010001008844 for Hitachi, Ltd. Up to 1,000 companies per run.", "items": { "type": "string" } }, "company_names": { "title": "Company names (optional)", "type": "array", "description": "Japanese company names, resolved to corporate numbers via the official National Tax Agency registry. Unambiguous matches only — ambiguous names are reported, not guessed.", "items": { "type": "string" } }, "fields": { "title": "Activity blocks", "type": "array", "description": "Which government-activity blocks to fetch per company: subsidies, procurement, patents. Default: all three. Patent responses can be tens of MB for large corporations — drop \"patents\" for faster runs.", "items": { "type": "string" } }, "enrich": { "title": "LLM enrichment (English one-liner + name transliteration)", "type": "boolean", "description": "Add an English one-sentence business summary and a romanized company name (only when no official English name is registered). Uses an LLM; billed per enriched company.", "default": 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 } } }, "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 } } } } } } } } } } ```