The pages are in English; this contents, the search and the buttons are in Japanese.
Where to find a feed
日本語 · English
kyogijo holds no league data and runs no server: a race or a game plays from a feed you choose, read by your own browser (see the race feed and feeds). This page says where to find one: the known public feeds for each sport, what each gives, a sample address, how to find a race's or game's id, and a link to each source's own docs and terms. You are responsible for following the terms of the source you use. Our own sample feeds come first: made up, served from the demo's site, in our open format, so that you can see what a feed looks like and try the address field with one.
The list is one data file, examples/feeds/where-to-find.json, which the demo reads for its suggestions; a test holds this page to it.
Racing#
| Source | What it gives | Sample address | Finding a race | Docs and terms |
|---|---|---|---|---|
| Sample feed (made up) | The package's own simulated race in kyogijo's open race timeline: 20 invented cars over 50 laps of the Las Vegas Strip Circuit, with lap times, pit stops and the flag. No real race, driver or team. | examples/races/las-vegas-sample.json on the demo's site | None needed: the address is the file. | The race feed; MIT, with the package |
| OpenF1 | An unofficial, community-run API of Formula 1 timing for sessions since 2023: every car's laps (start and duration), and from the same session its pit stops and drivers, which kyogijo also asks for. Historical sessions are free; live timing needs an account of theirs. Read by kyogijo's OpenF1 adapter. | https://api.openf1.org/v1/laps?session_key=9644 | A session_key: list a weekend's sessions at https://api.openf1.org/v1/sessions?year=2024&circuit_short_name=Las%20Vegas and take the Race's session_key, then ask https://api.openf1.org/v1/laps?session_key=<it>. | openf1.org: CC BY-NC-SA 4.0, for educational, research and non-commercial fan use (their FAQ); not associated with Formula 1 |
| Jolpica F1 (the Ergast API's successor) | Results, and each car's position and time on every lap, for Formula 1 races over many seasons. kyogijo has no adapter for its shape yet: save its answer and turn it into the open race timeline (each lap's time added up gives the times the cars crossed the line). | https://api.jolpi.ca/ergast/f1/2024/22/laps.json?limit=100 | A season and a round: https://api.jolpi.ca/ergast/f1/2024.json lists the season's races and their round numbers. | github.com/jolpica/jolpica-f1: read the terms of use linked from its README |
Ice hockey#
| Source | What it gives | Sample address | Finding a game | Docs and terms |
|---|---|---|---|---|
| Sample feed (made up) | A whole made-up game in kyogijo's open timeline format: both sides, the players, the puck twice a second, the shots, goals and whistles, the stoppages and penalties, and the three periods. | examples/games/canada-japan.json on the demo's site | One game, at this address. It is served from this site, the same as any feed of your own would be. | The example game; MIT, with the package |
| NHL play-by-play (public) | Every play of an NHL game with its period, its time and, for most, its place on the ice (feet from centre ice); both teams, the rosters and the game's state (live or final). No tracking: the puck is moved between the plays. Read by kyogijo's NHL adapter. It may refuse a page of another site (CORS). | https://api-web.nhle.com/v1/gamecenter/2023020204/play-by-play | The game id is ten digits: the season's first year, 02 for the regular season or 03 for the playoffs, and the game's number (2023020204 is regular-season game 204 of 2023-24). The schedule of a day, api-web.nhle.com/v1/schedule/<yyyy-mm-dd>, lists each game with its id. | Community reference (unofficial); NHL.com terms of service |
A source that does not let pages on other sites read it (CORS) cannot be read from the demo's page: the page says so, and you can paste its answer or save it and choose the file instead.