# e-Stat Japan Statistics API (`tsukasa/e-stat-japan-statistics-api`) Actor Access Japan's official e-Stat government statistics API and export structured JSON for AI agents, data analysis, and automation. - **URL**: https://apify.com/tsukasa/e-stat-japan-statistics-api.md - **Developed by:** [Tsukasa Kobayashi](https://apify.com/tsukasa) (community) - **Categories:** Automation - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, NaN 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 ## e-Stat Japan Statistics API Fetch structured data from Japan's official government statistics portal, [e-Stat](https://www.e-stat.go.jp/), and push it directly into an Apify Dataset โ€” ready for AI agents, data pipelines, and analytics workflows. ### ๐Ÿ‡ฏ๐Ÿ‡ต What is e-Stat? e-Stat is the official Japanese government statistics portal maintained by the Ministry of Internal Affairs and Communications. It provides access to hundreds of thousands of datasets covering population, economy, labor, education, health, and more โ€” all freely available via API. ### โœจ What This Actor Does - Calls the e-Stat REST API (`getStatsData`) - Parses the response into clean, flat JSON records - Pushes structured records to an Apify Dataset - Works out-of-the-box with AI agents (Claude, GPT, etc.) via the Apify API ### ๐Ÿ“ฅ Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `app_id` | string | โœ… Yes | โ€” | Your e-Stat API key (free) | | `stat_id` | string | No | `0003103532` | e-Stat `statsDataId` (dataset identifier) | | `limit` | integer | No | `100` | Max number of records to fetch (up to 100,000) | ### ๐Ÿ“ค Output Format Each record in the dataset contains: ```json { "value": "125124977", "unit": "ไบบ", "stat_name": "ๅ›ฝๅ‹ข่ชฟๆŸป", "gov_org": "็ทๅ‹™็œ็ตฑ่จˆๅฑ€", "title": "ไบบๅฃๅŠใณไธ–ๅธฏ๏ผˆ็ทๅ‹™็œ็ตฑ่จˆๅฑ€๏ผ‰", "survey_date": "20201001", "@area": "00000", "@time": "2020100000", "@unit": "ไบบ" } ```` ### ๐Ÿ”‘ How to Get an e-Stat API Key 1. Go to [e-Stat User Registration](https://www.e-stat.go.jp/mypage/user/preregister) 2. Register for a free account 3. Navigate to **API Function** โ†’ **Application registration** 4. Copy your `appId` The API key is free and has no usage limits for standard access. ### ๐Ÿ” Finding Dataset IDs (statsDataId) 1. Visit [e-Stat search](https://www.e-stat.go.jp/stat-search) 2. Search for the statistics you want 3. Open a dataset โ†’ the URL will contain `statsDataId=XXXXXXXXXX` #### Popular Dataset IDs | ID | Dataset | |----|---------| | `0003103532` | Population Census (ๅ›ฝๅ‹ข่ชฟๆŸป) | | `0003215843` | Consumer Price Index (ๆถˆ่ฒป่€…็‰ฉไพกๆŒ‡ๆ•ฐ) | | `0003143513` | Labor Force Survey (ๅŠดๅƒๅŠ›่ชฟๆŸป) | | `0003411572` | GDP and National Accounts (ๅ›ฝๆฐ‘็ตŒๆธˆ่จˆ็ฎ—) | ### ๐Ÿค– Use Cases - **AI Agents**: Feed real-time Japanese government statistics into LLM pipelines - **Data Analysis**: Pull population, economic, or labor data for research - **Dashboard Building**: Automate data ingestion for BI tools (Tableau, Looker, etc.) - **Academic Research**: Structured access to official Japanese statistical datasets ### ๐Ÿ’ฐ Pricing This Actor uses pay-per-use pricing on Apify. You are charged only for the compute units used per run โ€” typically less than $0.01 per 1,000 records. ### ๐Ÿ“š Resources - [e-Stat API Documentation (Japanese)](https://www.e-stat.go.jp/api/) - [e-Stat API Documentation (English)](https://www.e-stat.go.jp/en/api/) - [Apify Documentation](https://docs.apify.com) # Actor input Schema ## `app_id` (type: `string`): Get your free API key at https://www.e-stat.go.jp/mypage/user/preregister ## `stat_id` (type: `string`): statsDataId from e-Stat. Default: 0003103532 (Population Census) ## `limit` (type: `integer`): Number of records to fetch per run (max 100000) ## Actor input object example ```json { "stat_id": "0003103532", "limit": 100 } ``` # 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 = {}; // Run the Actor and wait for it to finish const run = await client.actor("tsukasa/e-stat-japan-statistics-api").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 = {} # Run the Actor and wait for it to finish run = client.actor("tsukasa/e-stat-japan-statistics-api").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 tsukasa/e-stat-japan-statistics-api --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=tsukasa/e-stat-japan-statistics-api", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "e-Stat Japan Statistics API", "description": "Access Japan's official e-Stat government statistics API and export structured JSON for AI agents, data analysis, and automation.", "version": "0.0", "x-build-id": "JFhteehBTgCXbjuaX" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tsukasa~e-stat-japan-statistics-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tsukasa-e-stat-japan-statistics-api", "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/tsukasa~e-stat-japan-statistics-api/runs": { "post": { "operationId": "runs-sync-tsukasa-e-stat-japan-statistics-api", "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/tsukasa~e-stat-japan-statistics-api/run-sync": { "post": { "operationId": "run-sync-tsukasa-e-stat-japan-statistics-api", "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": [ "app_id" ], "properties": { "app_id": { "title": "e-Stat API Key (appId)", "type": "string", "description": "Get your free API key at https://www.e-stat.go.jp/mypage/user/preregister" }, "stat_id": { "title": "Statistics Dataset ID (statsDataId)", "type": "string", "description": "statsDataId from e-Stat. Default: 0003103532 (Population Census)", "default": "0003103532" }, "limit": { "title": "Max records to fetch", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Number of records to fetch per run (max 100000)", "default": 100 } } }, "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 } } } } } } } } } } ```