searchSpeeches
Retrieve specific Diet speeches by filtering keywords, speaker names, meeting types, or dates using the Japanese National Diet Library's API. Returns up to 100 records with text and meeting details.
Instructions
Searches for specific speeches from the Kokkai API (発言単位出力). Returns speech text and info about the meeting it belongs to. Max 100 records.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
any | No | Keywords to search in speech content. Partial match. Multiple terms separated by space for AND search. | |
closing | No | Limit search to meetings held during recess. Default false. | |
contentsAndIndex | No | Limit search to table of contents and index. Default false. | |
from | No | Start date for meeting search (YYYY-MM-DD). Default '0000-01-01'. | |
issueFrom | No | Starting issue number (up to 3 digits, 0 for TOC/index/appendix/supplement). | |
issueID | No | Unique ID for a meeting record (21 alphanumeric characters, e.g., '100105254X00119470520'). Exact match. | |
issueTo | No | Ending issue number (up to 3 digits, 0 for TOC/index/appendix/supplement). | |
maximumRecords | No | Maximum number of records to retrieve (1-100) for speeches. Default is 30. | |
nameOfHouse | No | Name of the House (e.g., '衆議院' for House of Representatives, '参議院' for House of Councillors). '両院' and '両院協議会' yield the same results. | |
nameOfMeeting | No | Name of the meeting (e.g., plenary session, committee). Partial match. Multiple terms separated by space for OR search. | |
searchRange | No | Specifies where to search for keywords from 'any' parameter: '冒頭' (opening), '本文' (body), or '冒頭・本文' (both). Default '冒頭・本文'. | |
sessionFrom | No | Starting Diet session number (up to 3 digits). | |
sessionTo | No | Ending Diet session number (up to 3 digits). | |
speaker | No | Speaker's name. Partial match. Multiple names separated by space for OR search. | |
speakerGroup | No | Speaker's affiliated political group. Partial match. | |
speakerPosition | No | Speaker's position/title. Partial match. | |
speakerRole | No | Speaker's role: '証人' (witness), '参考人' (expert witness/referential speaker), '公述人' (public speaker). | |
speechID | No | Unique ID for a speech (format: issueID_paddedSpeechNumber, e.g., '100105254X00119470520_000'). Exact match. | |
speechNumber | No | Exact match for speech number (e.g., 10). | |
startRecord | No | Start position for retrieving search results (1-based). Default is 1. | |
supplementAndAppendix | No | Limit search to supplements and appendices. Default false. | |
until | No | End date for meeting search (YYYY-MM-DD). Default '9999-12-31'. |