Kokkai NDL API

https://kokkai.ndl.go.jp/api/
Admin
The National Diet of Japan's parliamentary records search API that enables developers to search and...
Tokens:80,748
Snippets:1,085
Trust Score:10
Update:5 months ago
Show doc for...
Tokens:
Raw
### Meeting API

Source: https://kokkai.ndl.go.jp/api.html

Retrieves detailed information about parliamentary meetings.

```APIDOC
## GET /api/meeting

### Description
Retrieves detailed information about parliamentary meetings, including speeches.

### Method
GET

### Endpoint
https://kokkai.ndl.go.jp/api/meeting?{search_conditions}

### Parameters
#### Query Parameters
- **startRecord** (integer) - Optional - Specifies the starting position for retrieving search results. Defaults to 1.
- **maximumRecords** (integer) - Optional - Specifies the maximum number of records to retrieve per request. Defaults to 3. Range: 1-10.
- **nameOfHouse** (string) - Optional - Specifies the house name (e.g., "衆議院", "参議院", "両院", "両院協議会").
- **nameOfMeeting** (string) - Optional - Specifies the meeting name (e.g., "本会議", "委員会"). Supports partial matching and OR search with spaces.
- **any** (string) - Optional - Specifies keywords to search within the content. Supports partial matching and AND search with spaces.
- **speaker** (string) - Optional - Specifies the speaker's name. Supports partial matching and OR search with spaces.
- **from** (string) - Optional - Specifies the start date for the meeting (YYYY-MM-DD). Defaults to "0000-01-01".
- **until** (string) - Optional - Specifies the end date for the meeting (YYYY-MM-DD). Defaults to "9999-12-31".
- **supplementAndAppendix** (boolean) - Optional - Filters results to include only supplements and appendices. Defaults to false.
- **contentsAndIndex** (boolean) - Optional - Filters results to include only contents and indexes. Defaults to false.
- **searchRange** (string) - Optional - Specifies the search range for keywords (e.g., "冒頭", "本文", "冒頭・本文"). Defaults to "冒頭・本文".
- **closing** (boolean) - Optional - Filters results to include only records from closed sessions. Defaults to false.
- **speechNumber** (integer) - Optional - Specifies the speech number for exact matching.
- **speakerPosition** (string) - Optional - Specifies the speaker's position. Supports partial matching.
- **speakerGroup** (string) - Optional - Specifies the speaker's affiliation. Supports partial matching.
- **speakerRole** (string) - Optional - Specifies the speaker's role (e.g., "証人", "参考人", "公述人").
- **speechID** (string) - Optional - Specifies the speech ID for exact matching (format: issueID_speechNumber).
- **issueID** (string) - Optional - Specifies the issue ID (meeting record ID) for exact matching.
- **sessionFrom** (integer) - Optional - Specifies the starting session number.
- **sessionTo** (integer) - Optional - Specifies the ending session number.
- **issueFrom** (integer) - Optional - Specifies the starting issue number.
- **issueTo** (integer) - Optional - Specifies the ending issue number.
- **recordPacking** (string) - Optional - Specifies the response format ("xml" or "json"). Defaults to "xml".

### Response
#### Success Response (200)
- **numberOfRecords** (integer) - Total number of records found.
- **numberOfReturn** (integer) - Number of records returned in this request.
- **startRecord** (integer) - The starting position of the returned records.
- **nextRecordPosition** (integer) - The starting position for the next set of records, if available.
- **records** (array) - An array of meeting records.
  - **recordData** (object)
    - **meetingRecord** (object)
      - **issueID** (string) - Meeting record ID.
      - **imageKind** (string) - Type of image (e.g., "会議録", "目次").
      - **searchObject** (string) - Search scope (e.g., "議事冒頭", "本文").
      - **session** (string) - Session number.
      - **nameOfHouse** (string) - Name of the house.
      - **nameOfMeeting** (string) - Name of the meeting.
      - **issue** (string) - Issue number.
      - **date** (string) - Meeting date.
      - **closing** (string) - Closing flag.
      - **speechRecord** (object) - Details about speeches within the meeting.
        - **speechID** (string) - Speech ID.
        - **speechOrder** (string) - Order of the speech.
        - **speaker** (string) - Speaker's name.
        - **speakerYomi** (string) - Speaker's name in Yomi (kana).
        - **speakerGroup** (string) - Speaker's affiliation.
        - **speakerPosition** (string) - Speaker's position.
        - **speakerRole** (string) - Speaker's role.
        - **speech** (string) - The content of the speech.
        - **startPage** (string) - Starting page of the speech.
        - **createTime** (string) - Record creation timestamp.
        - **updateTime** (string) - Record update timestamp.
        - **speechURL** (string) - URL to the speech.

### Request Example
```json
{
  "example": "GET /api/meeting?nameOfHouse=参議院&date=2023-01-20"
}
```

### Response Example
```json
{
  "example": "{\n  \"numberOfRecords\": 50,\n  \"numberOfReturn\": 3,\n  \"startRecord\": 1,\n  \"nextRecordPosition\": 4,\n  \"records\": [\n    {\n      \"recordData\": {\n        \"meetingRecord\": {\n          \"issueID\": \"100105254X00120230120\",\n          \"imageKind\": \"会議録\",\n          \"searchObject\": \"冒頭・本文\",\n          \"session\": \"210\",\n          \"nameOfHouse\": \"参議院\",\n          \"nameOfMeeting\": \"本会議\",\n          \"issue\": \"2\",\n          \"date\": \"2023-01-20\",\n          \"closing\": \"false\",\n          \"speechRecord\": {\n            \"speechID\": \"100105254X00120230120_001\",\n            \"speechOrder\": \"1\",\n            \"speaker\": \"佐藤 花子\",\n            \"speakerYomi\": \"さとう はなこ\",\n            \"speakerGroup\": \"立憲民主党・無所属\",\n            \"speakerPosition\": \"議員\",\n            \"speakerRole\": \"議員\",\n            \"speech\": \"〇〇問題について、政府の見解を伺います。\",\n            \"startPage\": \"10\",\n            \"createTime\": \"2023-01-20T11:00:00Z\",\n            \"updateTime\": \"2023-01-20T11:00:00Z\",\n            \"speechURL\": \"https://kokkai.ndl.go.jp/api/speech/100105254X00120230120_001\"\n          }\n        }\n      }\n    }\n  ]\n}"
}
```
```

--------------------------------

### Meeting List API

Source: https://kokkai.ndl.go.jp/api.html

Retrieves a simplified list of meeting records based on search criteria.

```APIDOC
## GET /api/meeting_list

### Description
Retrieves a simplified list of parliamentary meeting records.

### Method
GET

### Endpoint
https://kokkai.ndl.go.jp/api/meeting_list?{search_conditions}

### Parameters
#### Query Parameters
- **startRecord** (integer) - Optional - Specifies the starting position for retrieving search results. Defaults to 1.
- **maximumRecords** (integer) - Optional - Specifies the maximum number of records to retrieve per request. Defaults to 30. Range: 1-100.
- **nameOfHouse** (string) - Optional - Specifies the house name (e.g., "衆議院", "参議院", "両院", "両院協議会").
- **nameOfMeeting** (string) - Optional - Specifies the meeting name (e.g., "本会議", "委員会"). Supports partial matching and OR search with spaces.
- **any** (string) - Optional - Specifies keywords to search within the content. Supports partial matching and AND search with spaces.
- **speaker** (string) - Optional - Specifies the speaker's name. Supports partial matching and OR search with spaces.
- **from** (string) - Optional - Specifies the start date for the meeting (YYYY-MM-DD). Defaults to "0000-01-01".
- **until** (string) - Optional - Specifies the end date for the meeting (YYYY-MM-DD). Defaults to "9999-12-31".
- **supplementAndAppendix** (boolean) - Optional - Filters results to include only supplements and appendices. Defaults to false.
- **contentsAndIndex** (boolean) - Optional - Filters results to include only contents and indexes. Defaults to false.
- **searchRange** (string) - Optional - Specifies the search range for keywords (e.g., "冒頭", "本文", "冒頭・本文"). Defaults to "冒頭・本文".
- **closing** (boolean) - Optional - Filters results to include only records from closed sessions. Defaults to false.
- **speechNumber** (integer) - Optional - Specifies the speech number for exact matching.
- **speakerPosition** (string) - Optional - Specifies the speaker's position. Supports partial matching.
- **speakerGroup** (string) - Optional - Specifies the speaker's affiliation. Supports partial matching.
- **speakerRole** (string) - Optional - Specifies the speaker's role (e.g., "証人", "参考人", "公述人").
- **speechID** (string) - Optional - Specifies the speech ID for exact matching (format: issueID_speechNumber).
- **issueID** (string) - Optional - Specifies the issue ID (meeting record ID) for exact matching.
- **sessionFrom** (integer) - Optional - Specifies the starting session number.
- **sessionTo** (integer) - Optional - Specifies the ending session number.
- **issueFrom** (integer) - Optional - Specifies the starting issue number.
- **issueTo** (integer) - Optional - Specifies the ending issue number.
- **recordPacking** (string) - Optional - Specifies the response format ("xml" or "json"). Defaults to "xml".

### Response
#### Success Response (200)
- **numberOfRecords** (integer) - Total number of records found.
- **numberOfReturn** (integer) - Number of records returned in this request.
- **startRecord** (integer) - The starting position of the returned records.
- **nextRecordPosition** (integer) - The starting position for the next set of records, if available.
- **records** (array) - An array of meeting records.
  - **recordData** (object)
    - **meetingRecord** (object)
      - **issueID** (string) - Meeting record ID.
      - **imageKind** (string) - Type of image (e.g., "会議録", "目次").
      - **searchObject** (string) - Search scope (e.g., "議事冒頭", "本文").
      - **session** (string) - Session number.
      - **nameOfHouse** (string) - Name of the house.
      - **nameOfMeeting** (string) - Name of the meeting.
      - **issue** (string) - Issue number.
      - **date** (string) - Meeting date.
      - **closing** (string) - Closing flag.
      - **speechRecord** (object) - Details about speeches within the meeting.
        - **speechID** (string) - Speech ID.
        - **speechOrder** (string) - Order of the speech.
        - **speaker** (string) - Speaker's name.
        - **speakerYomi** (string) - Speaker's name in Yomi (kana).
        - **speakerGroup** (string) - Speaker's affiliation.
        - **speakerPosition** (string) - Speaker's position.
        - **speakerRole** (string) - Speaker's role.
        - **speech** (string) - The content of the speech.
        - **startPage** (string) - Starting page of the speech.
        - **createTime** (string) - Record creation timestamp.
        - **updateTime** (string) - Record update timestamp.
        - **speechURL** (string) - URL to the speech.

### Request Example
```json
{
  "example": "GET /api/meeting_list?nameOfHouse=衆議院&from=2023-01-01&to=2023-12-31"
}
```

### Response Example
```json
{
  "example": "{\n  \"numberOfRecords\": 100,\n  \"numberOfReturn\": 10,\n  \"startRecord\": 1,\n  \"nextRecordPosition\": 11,\n  \"records\": [\n    {\n      \"recordData\": {\n        \"meetingRecord\": {\n          \"issueID\": \"100105254X00120230101\",\n          \"imageKind\": \"会議録\",\n          \"searchObject\": \"冒頭・本文\",\n          \"session\": \"210\",\n          \"nameOfHouse\": \"衆議院\",\n          \"nameOfMeeting\": \"本会議\",\n          \"issue\": \"1\",\n          \"date\": \"2023-01-20\",\n          \"closing\": \"false\",\n          \"speechRecord\": {\n            \"speechID\": \"100105254X00120230101_001\",\n            \"speechOrder\": \"1\",\n            \"speaker\": \"山田 太郎\",\n            \"speakerYomi\": \"やまだ たろう\",\n            \"speakerGroup\": \"自由民主党・無所属の会\",\n            \"speakerPosition\": \"議員\",\n            \"speakerRole\": \"議員\",\n            \"speech\": \"本日は、〇〇法案について質問いたします。\",\n            \"startPage\": \"5\",\n            \"createTime\": \"2023-01-20T10:00:00Z\",\n            \"updateTime\": \"2023-01-20T10:00:00Z\",\n            \"speechURL\": \"https://kokkai.ndl.go.jp/api/speech/100105254X00120230101_001\"\n          }\n        }\n      }\n    }\n  ]\n}"
}
```
```
Tokens:
Raw