# Japan Company Intelligence — 適時開示・法人情報 API (`agentworkflowlab/japan-company-intel`) Actor

Unified Japanese company intelligence: TDnet timely disclosures, EDINET filings, and gBizINFO corporate registry data from a single query (company name or securities code).

- **URL**: https://apify.com/agentworkflowlab/japan-company-intel.md
- **Developed by:** [Agent Workflow Lab](https://apify.com/agentworkflowlab) (community)
- **Categories:** AI, Integrations, News
- **Stats:** 2 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## 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 Intelligence — 適時開示・法人情報 API

Get **Japanese company intelligence in one call**: TDnet timely disclosures (適時開示), EDINET filings (有価証券報告書・大量保有報告書), and gBizINFO corporate registry data — unified into clean JSON, queryable by company name or securities code.

Built for analysts, investors, AI agents, and anyone who needs structured Japanese market data without navigating Japanese-only government portals.

### What you get

| Source | Data | Key required? |
|---|---|---|
| **TDnet** (Tokyo Stock Exchange) | Timely disclosures: earnings revisions, buybacks, M&A, executive changes, dividend announcements | No |
| **EDINET** (Financial Services Agency) | Official filings: annual/quarterly securities reports, large shareholding reports | Free key (bring your own) |
| **gBizINFO** (METI) | Corporate registry: corporate number, address, representative, capital, employees | Free token (bring your own) |

All sources are **official government/exchange data** — no scraping of private websites, no ToS gray zones.

### Modes

#### 1. Company report
Query one company by **name** (トヨタ自動車) or **4-digit securities code** (7203) and get its recent disclosures, filings, and registry profile.

```json
{
    "mode": "company_report",
    "query": "7203",
    "maxDisclosures": 30
}
````

#### 2. Market feed

Get the latest disclosures across the whole market, optionally filtered by keyword — e.g. monitor every 自己株式 (buyback), 上方修正 (upward revision), or MBO announcement as it happens.

```json
{
    "mode": "market_feed",
    "keyword": "自己株式",
    "maxDisclosures": 50
}
```

### Output example

```json
{
    "type": "tdnet_disclosure",
    "source": "TDnet",
    "companyCode": "72030",
    "companyName": "トヨタ自動車",
    "title": "役員人事に関するお知らせ",
    "pubdate": "2026-06-17 16:00:00",
    "documentUrl": "https://..."
}
```

A `report_summary` item is always appended with source counts and any warnings.

### Why bring your own EDINET/gBizINFO keys?

Both keys are **free** and take ~5 minutes to obtain:

- EDINET: https://api.edinet-fsa.go.jp/ (email registration)
- gBizINFO: https://info.gbiz.go.jp/hojin/api\_registration/form

The Actor works without them (TDnet-only mode), but adding them unlocks the full report. Keys are marked secret and never stored.

### Notes & limitations

- Company-name queries against TDnet match recent disclosures only; securities codes are more reliable.
- gBizINFO lookup requires a company **name** (the registry has no securities-code index).
- English company names are not yet supported for TDnet queries — use the securities code instead.
- This Actor returns public regulatory data as-is. It is not investment advice.

### Use cases

- **AI agents / RAG**: feed structured Japanese disclosure data into LLM pipelines (MCP-friendly output).
- **Investor monitoring**: schedule daily runs with keyword filters (buybacks, revisions, MBO) and pipe to Slack/email via Apify integrations.
- **Due diligence**: one-call company snapshot combining exchange, regulator, and registry data.
- **Market research**: track disclosure activity across the Japanese market without reading Japanese portals.

### Support

Open an issue on the Actor's Issues tab — maintained actively, typical response within 1–2 business days.

# Actor input Schema

## `query` (type: `string`):

Japanese company name (e.g. トヨタ自動車, ソニー) or 4-digit TSE securities code (e.g. 7203). Leave empty with mode=market\_feed to get the latest market-wide disclosures.

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

company\_report: full intelligence report for one company. market\_feed: latest timely disclosures across the whole market (optionally filtered by keyword).

## `keyword` (type: `string`):

Optional keyword to filter disclosure titles in market\_feed mode, e.g. 上方修正, 自己株式, MBO, 業績予想.

## `maxDisclosures` (type: `integer`):

Maximum number of timely disclosures to return.

## `includeEdinet` (type: `boolean`):

Include recent EDINET filings (annual/quarterly reports, large shareholding reports). Requires edinetApiKey.

## `includeGbiz` (type: `boolean`):

Include corporate registry basics (address, corporate number, representative, employees, subsidies, procurement awards). Requires gbizApiToken.

## `edinetApiKey` (type: `string`):

Your own EDINET v2 API subscription key (free at https://api.edinet-fsa.go.jp/). If omitted, EDINET section is skipped.

## `gbizApiToken` (type: `string`):

Your own gBizINFO API token (free at https://info.gbiz.go.jp/hojin/api\_registration/form). If omitted, gBizINFO section is skipped.

## `edinetLookbackDays` (type: `integer`):

How many days back to scan EDINET filing lists (each day = 1 API call).

## `language` (type: `string`):

Language for summary labels in the output report.

## Actor input object example

```json
{
  "query": "7203",
  "mode": "company_report",
  "maxDisclosures": 30,
  "includeEdinet": true,
  "includeGbiz": true,
  "edinetLookbackDays": 14,
  "language": "en"
}
```

# Actor output Schema

## `items` (type: `string`):

All result items from the default dataset: TDnet disclosures, EDINET filings, gBizINFO registry records, and a final report\_summary item.

## `overview` (type: `string`):

Run results in Apify Console table view.

# 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 = {};

// Run the Actor and wait for it to finish
const run = await client.actor("agentworkflowlab/japan-company-intel").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 = {}

# Run the Actor and wait for it to finish
run = client.actor("agentworkflowlab/japan-company-intel").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 '{}' |
apify call agentworkflowlab/japan-company-intel --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Japan Company Intelligence — 適時開示・法人情報 API",
        "description": "Unified Japanese company intelligence: TDnet timely disclosures, EDINET filings, and gBizINFO corporate registry data from a single query (company name or securities code).",
        "version": "0.1",
        "x-build-id": "A9G9Z0UeAY6uBw0jF"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/agentworkflowlab~japan-company-intel/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-agentworkflowlab-japan-company-intel",
                "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/agentworkflowlab~japan-company-intel/runs": {
            "post": {
                "operationId": "runs-sync-agentworkflowlab-japan-company-intel",
                "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/agentworkflowlab~japan-company-intel/run-sync": {
            "post": {
                "operationId": "run-sync-agentworkflowlab-japan-company-intel",
                "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": [
                    "mode"
                ],
                "properties": {
                    "query": {
                        "title": "Company name or securities code",
                        "type": "string",
                        "description": "Japanese company name (e.g. トヨタ自動車, ソニー) or 4-digit TSE securities code (e.g. 7203). Leave empty with mode=market_feed to get the latest market-wide disclosures."
                    },
                    "mode": {
                        "title": "Mode",
                        "enum": [
                            "company_report",
                            "market_feed"
                        ],
                        "type": "string",
                        "description": "company_report: full intelligence report for one company. market_feed: latest timely disclosures across the whole market (optionally filtered by keyword).",
                        "default": "company_report"
                    },
                    "keyword": {
                        "title": "Keyword filter (market_feed mode)",
                        "type": "string",
                        "description": "Optional keyword to filter disclosure titles in market_feed mode, e.g. 上方修正, 自己株式, MBO, 業績予想."
                    },
                    "maxDisclosures": {
                        "title": "Max disclosures",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Maximum number of timely disclosures to return.",
                        "default": 30
                    },
                    "includeEdinet": {
                        "title": "Include EDINET filings",
                        "type": "boolean",
                        "description": "Include recent EDINET filings (annual/quarterly reports, large shareholding reports). Requires edinetApiKey.",
                        "default": true
                    },
                    "includeGbiz": {
                        "title": "Include gBizINFO registry data",
                        "type": "boolean",
                        "description": "Include corporate registry basics (address, corporate number, representative, employees, subsidies, procurement awards). Requires gbizApiToken.",
                        "default": true
                    },
                    "edinetApiKey": {
                        "title": "EDINET API key (optional)",
                        "type": "string",
                        "description": "Your own EDINET v2 API subscription key (free at https://api.edinet-fsa.go.jp/). If omitted, EDINET section is skipped."
                    },
                    "gbizApiToken": {
                        "title": "gBizINFO API token (optional)",
                        "type": "string",
                        "description": "Your own gBizINFO API token (free at https://info.gbiz.go.jp/hojin/api_registration/form). If omitted, gBizINFO section is skipped."
                    },
                    "edinetLookbackDays": {
                        "title": "EDINET lookback days",
                        "minimum": 1,
                        "maximum": 60,
                        "type": "integer",
                        "description": "How many days back to scan EDINET filing lists (each day = 1 API call).",
                        "default": 14
                    },
                    "language": {
                        "title": "Report language",
                        "enum": [
                            "ja",
                            "en"
                        ],
                        "type": "string",
                        "description": "Language for summary labels in the output report.",
                        "default": "en"
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```