# Japan Government Procurement Scraper (`hitujino56/jp-procurement`) Actor

Official Japanese government procurement data (入札情報). Uses KKJ REST API for lowest legal risk. Returns bid notices, results, amounts, and agencies.

- **URL**: https://apify.com/hitujino56/jp-procurement.md
- **Developed by:** [K S](https://apify.com/hitujino56) (community)
- **Categories:** Lead generation, Developer tools
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $5.00 / 1,000 procurement results

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/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Japan Government Procurement Scraper

Structured Japanese government procurement and bidding data from official public sources. This Apify Actor fetches bid notices, contract awards, and procurement metadata from Japan's national procurement information systems, starting with the KKJ (官公需情報ポータル) REST API.

### What Data Does This Scraper Collect?

This actor collects **metadata only** from Japanese government procurement listings:

- Bid notice titles and descriptions
- Issuing government agencies (ministries, prefectures, municipalities)
- Publication dates and submission deadlines
- Procurement types (一般競争入札, 企画競争, 随意契約, etc.)
- Award amounts (in JPY) and awarded companies, when available
- Category classifications and regional information

**Important:** This scraper collects only publicly available procurement metadata. No personal information (PII) is collected. Content such as full specification documents is not scraped — only structured metadata fields.

### Data Sources

| Source | Type | Status |
|--------|------|--------|
| **KKJ (官公需情報ポータル)** | Official REST API | Active |

The KKJ portal aggregates procurement information from central government ministries and agencies across Japan. The REST API requires no authentication and returns XML responses, making it the lowest-risk and most reliable data source for Japanese government procurement data.

### Output Fields

| Field | Type | Description |
|-------|------|-------------|
| `id` | string | Unique identifier (source-prefixed, e.g., `kkj-CFT-2026-001234`) |
| `title` | string | Procurement title / bid notice name |
| `agency` | string | Issuing government agency |
| `publishDate` | string | Publication date (ISO 8601) |
| `deadline` | string | Submission deadline (ISO 8601) |
| `type` | string | Procurement type (e.g., 一般競争入札) |
| `source` | string | Data source identifier (`kkj`) |
| `sourceUrl` | string | URL to original listing |
| `awardAmount` | number? | Award amount in JPY |
| `awardee` | string? | Awarded company name |
| `category` | string? | Industry / category classification |
| `region` | string? | Prefecture / region |
| `description` | string? | Brief description |
| `scrapedAt` | string | Scrape timestamp (ISO 8601) |
| `schemaVersion` | string | Schema version for compatibility |

### Usage Example

**Input:**

```json
{
  "keyword": "システム開発",
  "dateFrom": "2026-03-01",
  "dateTo": "2026-03-31",
  "maxResults": 100
}
```

**Expected Output (single record):**

```json
{
  "id": "kkj-CFT-2026-001234",
  "title": "情報システム運用保守業務",
  "agency": "経済産業省",
  "publishDate": "2026-03-15T00:00:00.000Z",
  "deadline": "2026-04-15T00:00:00.000Z",
  "type": "一般競争入札",
  "source": "kkj",
  "sourceUrl": "https://www.kkj.go.jp/notice/CFT-2026-001234",
  "category": "情報システム",
  "region": "東京都",
  "description": "経済産業省における情報システムの運用保守業務",
  "scrapedAt": "2026-03-20T10:30:00.000Z",
  "schemaVersion": "1.0.0"
}
```

### Who Uses This Data?

- **B2B sales teams** targeting government contracts
- **Market researchers** analyzing government spending trends
- **Compliance teams** monitoring procurement transparency
- **Data analysts** studying public sector IT procurement patterns
- **Consultants** advising on government contract opportunities in Japan

### Legal Compliance

This actor uses only the **official public REST API** provided by KKJ (官公需情報ポータル), a government-operated portal specifically designed for public access to procurement information. Key compliance points:

- **Public data only** — All collected information is published by government agencies for public consumption
- **No PII** — No personal information is collected; only agency and corporate entity names
- **API-based** — Uses the official REST API, not HTML scraping, minimizing legal risk
- **Rate limited** — Requests are throttled to avoid excessive load on government servers
- **Japan Copyright Act Art. 30-4** — Japan's copyright law explicitly permits text and data mining for information analysis purposes

### Pricing

**$5.00 per 1,000 results** via Apify platform usage (pay-per-event).

### Changelog

- **v0.1** — Initial release with KKJ API integration

# Actor input Schema

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

検索キーワード (e.g., 'システム開発', 'コンサルティング')

## `dateFrom` (type: `string`):

公示日の開始日 (YYYY-MM-DD)

## `dateTo` (type: `string`):

公示日の終了日 (YYYY-MM-DD)

## `agency` (type: `string`):

発注機関名でフィルタ

## `maxResults` (type: `integer`):

最大取得件数

## Actor input object example

```json
{
  "keyword": "",
  "maxResults": 1000
}
```

# 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("hitujino56/jp-procurement").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("hitujino56/jp-procurement").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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 hitujino56/jp-procurement --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,hitujino56/jp-procurement"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/aaR1XIvGnTxHbQVUI/builds/AK3sLzfDRhiJq4HU9/openapi.json