# Japan Company Data Scraper (gBizINFO / gBiz) (`jungle_synthesizer/gbizinfo-japan-company-scraper`) Actor

Extract Japanese company profiles from gBizINFO (METI): 4.5M+ companies with capital, employees, representative, JSIC industry, address, URL, government contracts, certifications, subsidies. For B2B sales, KYC, M\&A. Free API; optional token for high-volume runs.

- **URL**: https://apify.com/jungle\_synthesizer/gbizinfo-japan-company-scraper.md
- **Developed by:** [BowTiedRaccoon](https://apify.com/jungle_synthesizer) (community)
- **Categories:** Business, Lead generation, Other
- **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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

## gBizINFO Japan Company Scraper

Scrape enriched Japanese company profiles from [gBizINFO](https://info.gbiz.go.jp/), the METI-operated open data portal covering 4.5M+ Japanese corporations. Returns corporate number (法人番号), capital, employees, representative, address, JSIC industry, government contracts, certifications, subsidies, and patent counts in clean JSON.

---

### gBizINFO Scraper Features

- Extracts corporate records across 4.5M+ Japanese companies. That's the full METI registry, enriched with data most foreign tools skip.
- Two search modes — lookup by 法人番号 list, or filter by name/prefecture/industry/capital/employee count.
- Returns structured JSON with 27 fields covering corporate identity, financials, and workforce breakdown.
- Optional enrichment: government contracts (procurement), certifications, subsidies, commendations, and patent counts — one API call each, configurable per run.
- Pure API scraping — no browser, no proxies, no CAPTCHAs.
- Ships with a built-in METI demo token. Works out of the box. Bring your own token for larger runs.

---

### Who Uses gBizINFO Data?

- **B2B sales teams** — Enrich Japanese lead lists with capital, headcount, and industry code for account scoring.
- **M&A advisors** — Pull target-company profiles (revenue proxy via capital, JSIC code, government-contract history) before the first call.
- **KYC analysts** — Verify corporate registry status, representative, and registered address against 法人番号 without buying a TSR subscription.
- **Supply chain researchers** — Map suppliers by JSIC industry code and prefecture, then pull government contracts to gauge stability.
- **Japan market entrants** — Identify potential distributors or partners by filtering companies on capital ≥ ¥100M in Tokyo.
- **Procurement analysts** — Track which companies are winning government contracts, and in which ministries, over time.

---

### How gBizINFO Scraper Works

1. Pick a search mode. Supply either a list of 法人番号 (byNumber) or a set of filters like company name, prefecture, capital range (bySearch).
2. The scraper paginates the gBizINFO search API and collects matching corporate numbers.
3. Each hit is then fetched from the detail endpoint, which returns the rich record — capital, employees, representative, JSIC industry, and the rest.
4. If you toggled on enrichments, it fires one extra API call per company for certifications, procurement, subsidies, commendations, or patent counts, then flattens the arrays into formatted strings.

---

### Input

```json
{
    "searchMode": "bySearch",
    "nameQuery": "ソニー",
    "maxItems": 50,
    "includeCertifications": false,
    "includeProcurement": false
}
````

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `searchMode` | string | `bySearch` | `bySearch` (filter queries) or `byNumber` (explicit 法人番号 list). |
| `corporateNumbers` | array | `[]` | 13-digit 法人番号 list. Used only when `searchMode=byNumber`. |
| `nameQuery` | string | `""` | Company name partial match. Accepts Japanese or English. |
| `corporateType` | string | `""` | Corporate type code. `301` 株式会社, `302` 有限会社, `305` 合同会社, etc. Comma-separate for multiple. |
| `prefectureCode` | string | `""` | JIS X 0401 2-digit prefecture code. `13` Tokyo, `27` Osaka, `14` Kanagawa. |
| `capitalMin` | integer | `0` | Minimum capital (JPY). |
| `capitalMax` | integer | `0` | Maximum capital (JPY). |
| `employeeMin` | integer | `0` | Minimum employee count. |
| `employeeMax` | integer | `0` | Maximum employee count. |
| `existingOnly` | boolean | `true` | Exclude companies with closed/merged registry status. |
| `includeCertifications` | boolean | `false` | Fetch certifications (ISO, DX認定, METI). Adds one API call per record. |
| `includeProcurement` | boolean | `false` | Fetch government contracts received. Adds one API call per record. |
| `includeSubsidies` | boolean | `false` | Fetch subsidies awarded. Adds one API call per record. |
| `includePatents` | boolean | `false` | Fetch total patent count. Adds one API call per record. |
| `includeCommendations` | boolean | `false` | Fetch commendations/awards. Adds one API call per record. |
| `apiToken` | string | `""` | Optional personal gBizINFO token. Blank uses METI's public demo token. |
| `maxItems` | integer | `50` | Maximum records to return. |

#### Enrich a specific 法人番号 list

```json
{
    "searchMode": "byNumber",
    "corporateNumbers": ["7010401022916", "1010001126313", "7000012010029"],
    "includeProcurement": true,
    "includeCertifications": true,
    "maxItems": 3
}
```

#### Find Tokyo software companies with ¥100M+ capital

```json
{
    "searchMode": "bySearch",
    "prefectureCode": "13",
    "capitalMin": 100000000,
    "corporateType": "301",
    "maxItems": 100
}
```

***

### gBizINFO Scraper Output Fields

```json
{
    "corporate_number": "7010401022916",
    "name": "日本電気株式会社",
    "name_en": "NEC Corporation",
    "kana": "にっぽんでんき",
    "representative_name": "取締役代表執行役社長兼CEO 森 田 隆 之",
    "postal_code": "1080014",
    "location": "東京都港区芝５丁目７番１号",
    "status": "-",
    "capital_stock": 427831000000,
    "employee_number": 21004,
    "company_size_male": 16869,
    "company_size_female": 5635,
    "business_items": "107,108,110,111,112,114,115,116,117,118",
    "business_summary": "社会公共事業、社会基盤事業、エンタープライズ事業、ネットワークサービス事業、グローバル事業",
    "company_url": "https://jpn.nec.com/inclusion-diversity/",
    "qualification_grade": "A、A、A、A",
    "date_of_establishment": "1899-07-17",
    "update_date": "2018-11-21",
    "certifications": ["2025-02-01 | ＤＸ認定制度 | 経済産業省"],
    "procurement": ["2021-07-20 | 海洋生分解性プラスチックの社会実装に向けた技術開発事業 | 国立研究開発法人新エネルギー・産業技術総合開発機構"],
    "subsidies": [],
    "commendations": [],
    "patent_count": -1,
    "source_url": "https://info.gbiz.go.jp/hojin/ichiran/7010401022916",
    "scraped_at": "2026-04-23T10:48:12.723Z"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `corporate_number` | string | 13-digit 法人番号. |
| `name` | string | Corporation name in Japanese. |
| `name_en` | string | English name (if registered). |
| `kana` | string | Name reading in kana. |
| `representative_name` | string | Representative name and title. |
| `postal_code` | string | 7-digit postal code (no hyphen). |
| `location` | string | Registered address in Japanese. |
| `status` | string | Registry status (`-` active, `除` closed/merged). |
| `capital_stock` | number | Capital stock (JPY). |
| `employee_number` | number | Total employees. |
| `company_size_male` | number | Male employees. |
| `company_size_female` | number | Female employees. |
| `business_items` | string | JSIC-like business-item codes, comma-joined. |
| `business_summary` | string | Business description (Japanese). |
| `company_url` | string | Corporate website URL. |
| `qualification_grade` | string | Government procurement grade (格付け等級). |
| `date_of_establishment` | string | YYYY-MM-DD founding date. |
| `update_date` | string | Last registry update date. |
| `certifications` | array | `date \| title \| grantor` strings (if enabled). |
| `procurement` | array | `date \| title \| amount \| awarder` strings (if enabled). |
| `subsidies` | array | `date \| title \| amount \| grantor` strings (if enabled). |
| `commendations` | array | `date \| title \| grantor` strings (if enabled). |
| `patent_count` | integer | Total patent count. `-1` unless `includePatents=true`. |
| `source_url` | string | gBizINFO web page for this company. |
| `scraped_at` | string | ISO timestamp when the record was collected. |

***

### FAQ

#### How do I scrape Japanese company data from gBizINFO?

gBizINFO Scraper accepts either a list of 法人番号 or a filter query (name, prefecture, capital, industry). Drop your input, run it, collect the JSON. The API returns results fast — a 50-company pull with base fields finishes in under a minute.

#### Do I need a gBizINFO API token?

No. The actor ships with METI's publicly-embedded demo token and works out of the box. That said, METI publishes the demo token for evaluation, not production volume — bring your own free token from <https://info.gbiz.go.jp/hojin/various_registration/form> if you plan to run larger jobs.

#### What data can I get from gBizINFO?

gBizINFO Scraper returns 法人番号, company name (JP/EN/kana), representative, registered address, capital stock, employee count (plus male/female split), JSIC industry codes, company URL, and registry status. Turn on the enrichment flags to also pull government contracts, certifications (ISO, DX認定, METI), subsidies received, commendations, and patent counts.

#### Can I filter companies by prefecture or capital?

gBizINFO Scraper supports prefecture (JIS 2-digit code), capital range, employee range, corporate type, and name-match filters. Combine them to build specific prospect lists — for example, Tokyo 株式会社 with capital between ¥100M and ¥1B and 50+ employees.

#### Does gBizINFO Scraper need proxies?

No. The gBizINFO API has no WAF, no CAPTCHA, and generous rate limits. The actor runs direct against `info.gbiz.go.jp` with a polite ~6 req/s pace. Proxy configuration is exposed in the input, but leave it off by default.

#### How much does gBizINFO Scraper cost to run?

$0.10 per run start plus $0.001 per company record. A 1,000-company pull with no enrichments costs about $1.10. Enrichment flags add API calls but not charges — cost scales with records, not requests.

***

### Need More Features?

Need different enrichment fields, historical snapshots, or a bulk download format? [File an issue](https://console.apify.com/actors/issues) or get in touch.

### Why Use gBizINFO Scraper?

- **Affordable** — $0.001 per company record, so a 10,000-company enrichment run costs ~$10.10.
- **Unique coverage** — The only Apify actor wrapping gBizINFO, which itself is richer than the bare 法人番号 registry and an order of magnitude cheaper than commercial Japanese corporate databases.
- **Clean output** — Returns flat JSON with consistent field names. No nested arrays to untangle, no katakana encoding surprises, no HTML leftover from a page scrape.

# Actor input Schema

## `sp_intended_usage` (type: `string`):

Please describe how you plan to use the data extracted by this crawler.

## `sp_improvement_suggestions` (type: `string`):

Provide any feedback or suggestions for improvements.

## `sp_contact` (type: `string`):

Provide your email address so we can get in touch with you.

## `searchMode` (type: `string`):

byNumber = enrich a known list of 法人番号 corporate numbers; bySearch = query companies by name/industry/prefecture filters.

## `corporateNumbers` (type: `array`):

List of 13-digit 法人番号 (corporate numbers) to enrich. Used only when Search Mode is 'By Corporate Number'.

## `nameQuery` (type: `string`):

Company name search (partial match). Accepts Japanese or English. Used in bySearch mode.

## `corporateType` (type: `string`):

Filter by corporate type code. 101=National org, 201=Local gov, 301=株式会社 (KK), 302=有限会社 (YK), 303=合名, 304=合資, 305=合同 (GK), 399=Other, 401=Foreign, 499=Other. Leave empty for all. Comma-separate for multiple.

## `prefectureCode` (type: `string`):

Filter by prefecture 2-digit JIS code. Examples: 13=Tokyo (東京都), 27=Osaka (大阪府), 14=Kanagawa (神奈川県), 01=Hokkaido (北海道). Leave empty for all prefectures.

## `capitalMin` (type: `integer`):

Filter by minimum capital amount (資本金) in JPY. 0 for no minimum.

## `capitalMax` (type: `integer`):

Filter by maximum capital amount (資本金) in JPY. 0 for no maximum.

## `employeeMin` (type: `integer`):

Filter by minimum employee count. 0 for no minimum.

## `employeeMax` (type: `integer`):

Filter by maximum employee count. 0 for no maximum.

## `existingOnly` (type: `boolean`):

If true, only return companies with active (non-closed) registry status.

## `includeCertifications` (type: `boolean`):

Fetch certifications (ISO, METI/経産省認定, DX認定, etc.) per company. Adds one API call per record.

## `includeProcurement` (type: `boolean`):

Fetch government contracts/procurement records awarded per company. Adds one API call per record.

## `includeSubsidies` (type: `boolean`):

Fetch subsidies awarded per company. Adds one API call per record.

## `includePatents` (type: `boolean`):

Fetch total patent count per company. Adds one API call per record (can be slow for large companies).

## `includeCommendations` (type: `boolean`):

Fetch commendations/awards received per company. Adds one API call per record.

## `apiToken` (type: `string`):

Your personal gBizINFO API token from https://info.gbiz.go.jp/hojin/various\_registration/form (free). If left blank, the actor uses the public gBizINFO demo token, which works for evaluation but is subject to METI's fair-use limits. Provide your own token for reliable large runs.

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

Maximum number of company records to return.

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

Proxy settings. gBizINFO API does not require proxies.

## Actor input object example

```json
{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "searchMode": "bySearch",
  "corporateNumbers": [],
  "nameQuery": "",
  "corporateType": "",
  "prefectureCode": "",
  "capitalMin": 0,
  "capitalMax": 0,
  "employeeMin": 0,
  "employeeMax": 0,
  "existingOnly": true,
  "includeCertifications": false,
  "includeProcurement": false,
  "includeSubsidies": false,
  "includePatents": false,
  "includeCommendations": false,
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "searchMode": "bySearch",
    "corporateNumbers": [],
    "nameQuery": "",
    "corporateType": "",
    "prefectureCode": "",
    "capitalMin": 0,
    "capitalMax": 0,
    "employeeMin": 0,
    "employeeMax": 0,
    "existingOnly": true,
    "includeCertifications": false,
    "includeProcurement": false,
    "includeSubsidies": false,
    "includePatents": false,
    "includeCommendations": false,
    "apiToken": "",
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("jungle_synthesizer/gbizinfo-japan-company-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 = {
    "sp_intended_usage": "Describe your intended use...",
    "sp_improvement_suggestions": "Share your suggestions here...",
    "sp_contact": "Share your email here...",
    "searchMode": "bySearch",
    "corporateNumbers": [],
    "nameQuery": "",
    "corporateType": "",
    "prefectureCode": "",
    "capitalMin": 0,
    "capitalMax": 0,
    "employeeMin": 0,
    "employeeMax": 0,
    "existingOnly": True,
    "includeCertifications": False,
    "includeProcurement": False,
    "includeSubsidies": False,
    "includePatents": False,
    "includeCommendations": False,
    "apiToken": "",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("jungle_synthesizer/gbizinfo-japan-company-scraper").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 '{
  "sp_intended_usage": "Describe your intended use...",
  "sp_improvement_suggestions": "Share your suggestions here...",
  "sp_contact": "Share your email here...",
  "searchMode": "bySearch",
  "corporateNumbers": [],
  "nameQuery": "",
  "corporateType": "",
  "prefectureCode": "",
  "capitalMin": 0,
  "capitalMax": 0,
  "employeeMin": 0,
  "employeeMax": 0,
  "existingOnly": true,
  "includeCertifications": false,
  "includeProcurement": false,
  "includeSubsidies": false,
  "includePatents": false,
  "includeCommendations": false,
  "apiToken": "",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call jungle_synthesizer/gbizinfo-japan-company-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Japan Company Data Scraper (gBizINFO / gBiz)",
        "description": "Extract Japanese company profiles from gBizINFO (METI): 4.5M+ companies with capital, employees, representative, JSIC industry, address, URL, government contracts, certifications, subsidies. For B2B sales, KYC, M&A. Free API; optional token for high-volume runs.",
        "version": "1.0",
        "x-build-id": "zQkMNaW1ebPCebTt4"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/jungle_synthesizer~gbizinfo-japan-company-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-jungle_synthesizer-gbizinfo-japan-company-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/jungle_synthesizer~gbizinfo-japan-company-scraper/runs": {
            "post": {
                "operationId": "runs-sync-jungle_synthesizer-gbizinfo-japan-company-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/jungle_synthesizer~gbizinfo-japan-company-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-jungle_synthesizer-gbizinfo-japan-company-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",
                "required": [
                    "searchMode",
                    "maxItems",
                    "sp_intended_usage",
                    "sp_improvement_suggestions"
                ],
                "properties": {
                    "sp_intended_usage": {
                        "title": "What is the intended usage of this data?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Please describe how you plan to use the data extracted by this crawler."
                    },
                    "sp_improvement_suggestions": {
                        "title": "How can we improve this crawler for you?",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide any feedback or suggestions for improvements."
                    },
                    "sp_contact": {
                        "title": "Contact Email",
                        "minLength": 1,
                        "type": "string",
                        "description": "Provide your email address so we can get in touch with you."
                    },
                    "searchMode": {
                        "title": "Search Mode",
                        "enum": [
                            "byNumber",
                            "bySearch"
                        ],
                        "type": "string",
                        "description": "byNumber = enrich a known list of 法人番号 corporate numbers; bySearch = query companies by name/industry/prefecture filters.",
                        "default": "bySearch"
                    },
                    "corporateNumbers": {
                        "title": "Corporate Numbers (byNumber mode)",
                        "type": "array",
                        "description": "List of 13-digit 法人番号 (corporate numbers) to enrich. Used only when Search Mode is 'By Corporate Number'.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "nameQuery": {
                        "title": "Company Name",
                        "type": "string",
                        "description": "Company name search (partial match). Accepts Japanese or English. Used in bySearch mode.",
                        "default": ""
                    },
                    "corporateType": {
                        "title": "Corporate Type",
                        "type": "string",
                        "description": "Filter by corporate type code. 101=National org, 201=Local gov, 301=株式会社 (KK), 302=有限会社 (YK), 303=合名, 304=合資, 305=合同 (GK), 399=Other, 401=Foreign, 499=Other. Leave empty for all. Comma-separate for multiple.",
                        "default": ""
                    },
                    "prefectureCode": {
                        "title": "Prefecture Code (JIS X 0401)",
                        "type": "string",
                        "description": "Filter by prefecture 2-digit JIS code. Examples: 13=Tokyo (東京都), 27=Osaka (大阪府), 14=Kanagawa (神奈川県), 01=Hokkaido (北海道). Leave empty for all prefectures.",
                        "default": ""
                    },
                    "capitalMin": {
                        "title": "Minimum Capital (JPY)",
                        "type": "integer",
                        "description": "Filter by minimum capital amount (資本金) in JPY. 0 for no minimum.",
                        "default": 0
                    },
                    "capitalMax": {
                        "title": "Maximum Capital (JPY)",
                        "type": "integer",
                        "description": "Filter by maximum capital amount (資本金) in JPY. 0 for no maximum.",
                        "default": 0
                    },
                    "employeeMin": {
                        "title": "Minimum Employees",
                        "type": "integer",
                        "description": "Filter by minimum employee count. 0 for no minimum.",
                        "default": 0
                    },
                    "employeeMax": {
                        "title": "Maximum Employees",
                        "type": "integer",
                        "description": "Filter by maximum employee count. 0 for no maximum.",
                        "default": 0
                    },
                    "existingOnly": {
                        "title": "Exclude Closed Companies",
                        "type": "boolean",
                        "description": "If true, only return companies with active (non-closed) registry status.",
                        "default": true
                    },
                    "includeCertifications": {
                        "title": "Include Certifications",
                        "type": "boolean",
                        "description": "Fetch certifications (ISO, METI/経産省認定, DX認定, etc.) per company. Adds one API call per record.",
                        "default": false
                    },
                    "includeProcurement": {
                        "title": "Include Government Contracts",
                        "type": "boolean",
                        "description": "Fetch government contracts/procurement records awarded per company. Adds one API call per record.",
                        "default": false
                    },
                    "includeSubsidies": {
                        "title": "Include Subsidies",
                        "type": "boolean",
                        "description": "Fetch subsidies awarded per company. Adds one API call per record.",
                        "default": false
                    },
                    "includePatents": {
                        "title": "Include Patent Count",
                        "type": "boolean",
                        "description": "Fetch total patent count per company. Adds one API call per record (can be slow for large companies).",
                        "default": false
                    },
                    "includeCommendations": {
                        "title": "Include Commendations",
                        "type": "boolean",
                        "description": "Fetch commendations/awards received per company. Adds one API call per record.",
                        "default": false
                    },
                    "apiToken": {
                        "title": "gBizINFO API Token (Optional)",
                        "type": "string",
                        "description": "Your personal gBizINFO API token from https://info.gbiz.go.jp/hojin/various_registration/form (free). If left blank, the actor uses the public gBizINFO demo token, which works for evaluation but is subject to METI's fair-use limits. Provide your own token for reliable large runs."
                    },
                    "maxItems": {
                        "title": "Max Items",
                        "type": "integer",
                        "description": "Maximum number of company records to return.",
                        "default": 50
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings. gBizINFO API does not require proxies.",
                        "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
                                    }
                                }
                            },
                            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
