Service
NHK television and radio schedules for all of Japan from the NHK番組表API: a channel's programs for any day of the coming week, programs by genre, what is on air right now, and one broadcast event in full with its credits, series, episode and playback availability. 情報提供:ＮＨＫ (Information provided by NHK; shown together with other data: ＮＨＫ番組の情報提供:ＮＨＫ).
100.00%30-day uptimeAvg response366ms
Selecting a row opens the reference for that API.
| Method | API | Path | Summary |
|---|---|---|---|
| POST | /v1/nhk-program-guide/get-broadcast-event | Reads one broadcast event in full by its broadcast_event_id from a listing: every program field of list-programs plus the short synopsis, additional notes, the cast and crew with roles and readings, music pieces with performers, the series (reading, catchphrase, description, page, NHK On Demand page, related links, keywords, hashtags, logo and image), the episode (page, synopsis, image), the broadcast service and the Hybridcast and data broadcast flags. Use after a listing or now-on-air gave an id, when someone asks who appears in a program, what music it plays or where to watch it. Do NOT use to find programs (use the listing operations). Returns the event; an id the guide no longer holds (events live for today and the following seven days) is NO_DATA. | |
| POST | /v1/nhk-program-guide/get-now-on-air | Reads what a channel or bundle is broadcasting right now in one area: the program before, the one on air and the ones that follow (six rows per channel), each with the program fields of list-programs and a broadcast_status of ended, on_air or upcoming derived from the provider's clock (as_of). Use when someone asks what is on now or what comes next. Do NOT use for a full day (use list-programs) or for a program's credits (use get-broadcast-event with the broadcast_event_id). Returns medium, as_of, area_code, area_name, channels and programs with program_count. | |
| POST | /v1/nhk-program-guide/list-areas | Lists the 54 broadcast areas of NHK's regional network with the three-digit area code the listing operations take, the Japanese name and the romanised city name, such as 130 東京 Tokyo or 270 大阪 Osaka. Use when an area code is needed or to see which regional feeds exist. Do NOT use to list programs (use list-programs with the code). Returns areas with total_count; no upstream call is made. | |
| POST | /v1/nhk-program-guide/list-genres | Lists the 108 ARIB STD-B10 genre codes list-programs-by-genre takes, each with its four-digit code, the major category in English (news, sports, drama, music ...), the Japanese category label and the Japanese middle-classification name, such as 0300 drama ドラマ 国内ドラマ. Use when a genre code is needed or to see which genres exist. Do NOT use to list programs (use list-programs-by-genre with the code). Returns genres with total_count, optionally for one category; no upstream call is made. |
Issue a sandbox key and make your first reservation.
APIFuse holds the partner credentials. You hold one managed key.
Receive events such as reservation confirmations and delivery updates.
Service outages and gateway errors normalise into one error model.
| POST | /v1/nhk-program-guide/list-programs | Lists every program a channel (or a bundle of channels such as tv) broadcasts on one date in one Japanese area, from NHK's own program guide: broadcast event id, title, episode title, synopsis, start and end time (Japan time), duration, genres, series and episode pages, hashtags, live and rerun flags, captions, sign language, audio features and NHK ONE playback availability. Use when someone asks what is on an NHK channel on a given day or wants a schedule to pick from. Do NOT use for what is on right now (use get-now-on-air), for one genre only (use list-programs-by-genre) or for a program's credits and music (use get-broadcast-event). Returns medium, date, area_code, area_name, channels and programs in broadcast order with program_count; a date outside today and the following seven days is rejected by the guide (INVALID_REQUEST). |
| POST | /v1/nhk-program-guide/list-programs-by-genre | Lists the programs of one ARIB genre (a four-digit code from list-genres, such as 0000 for regular news, 0300 for domestic drama or 0101 for baseball) that a channel or bundle broadcasts on one date in one area, with the same program fields as list-programs. Use when someone asks for one kind of program on a day, such as the dramas or the sports broadcasts. Do NOT use for a whole day's schedule (use list-programs) or to find out which genre codes exist (use list-genres). Returns medium, date, area_code, area_name, the requested genre with its labels, channels and programs with program_count; every returned program carries the requested genre. |
| POST | /v1/nhk-program-guide/list-services | Lists the service codes the listing operations take: the eight NHK television channels (g1, g2, e1, e3, s1, s2, s5, s6), the two radio channels (r1, r3) and the bundles that answer several channels at once (g, e, s, tv, radio), each with its medium, Japanese and English name, kind and member channels. Use when a service code is needed or to see which channels NHK offers. Do NOT use to list programs (use list-programs with the code). Returns services with total_count, optionally for one medium; no upstream call is made. |