wopian/kitsu-season-trends

🦊 Kitsu seasonal anime trends

Season Trends

Kitsu season trends for the currently airing anime

Using the Data

All the data is free to use and available from:

• JSON format in ./data or online at season.moe/data/{year}-{season}.json
• MessagePack format online at season.moe/msgpack/{year}-{season}.msgpack

Data Format

Property names are compressed to save storage space and bandwidth.

Seasonal Data

Data grouped by airing season - Winter, Spring, Summer and Autumn/Fall.

As of January 2022, the previous season is updated in tandem with the current season.

{
  data: [
    {
      i: 12, // Kitsu anime ID
      t: 'One Piece', // Canonical title
      u: 0, // Subtype (0: TV, 1: ONA)
      n: 0, // 0: Leftover, 1: New
      d: [ // Data array containing each daily update
        {
          i: 0, // Index
          d: 450263, // Hours since epoch (x3600000 to get datetime)
          w: 82.19, // Wilson's confidence level (0.95) out of 100 (omitted if 0)
          l: 82.4, // Laplace smoothing out of 100 (omitted if 0)
          p: 100359.75, // Upvotes, ratings >= 3 out of 5, omitted if 0)
          o: 21433.25, // Downvotes, ratings < 3 out of 5, omitted if 0)
          r: 121793, // Users Rated (omitted if 0)
          u: 186101, // Users (omitted if 0)
          f: 6578 // Users Favourited (omitted if 0)
        }
      ]
    }
  ],
  meta: {
    current: 52, // Total started airing this season
    total: 226 // Total shows being tracked
  },
  updated: '2021-05-13T23:03:55.841Z' // ISO date of the last cron update
}

Anime Data

{
  data: [
    {
      i: 0 // index
      d: 450263, // Hours since epoch (x3600000 to get datetime)
      w: 82.19 // Wilson's confidence level (0.95) out of 100 (omitted if 0)
      l: 82.4 // Laplace smoothing out of 100 (omitted if 0)
      p: 100359.75 // Upvotes, ratings >= 3 out of 5, omitted if 0)
      o: 21433.25 // Downvotes, ratings < 3 out of 5, omitted if 0)
      r: 121793 // Users Rated (omitted if 0)
      u: 186101 // Users (omitted if 0)
      f: 6578 // Users Favourited (omitted if 0)
    }
  ],
  meta: {
    i: 12, // Kitsu anime ID
    t: 'One Piece', // Canonical title
    u: 0, // Subtype (0: TV, 1: ONA)
  }
}

Development

Requirements

• git >= 2.0.0
• node.js >= 8.0.0
• yarn >= 1.0.0

Commands

• yarn start - live reload local server
• yarn lint - lint source code
• yarn build - build from source
• yarn cron - manually run cron task to fetch new data

Guide

1. Fork the repo

2. Clone the repo (git clone https://github.com/{yourusername}/api-docs.git)

3. Create a new branch (git checkout -b improve-docs)

4. Install dependencies (yarn install)

5. Make the appropriate changes in the source files

6. Check your changes for issues (yarn test)

7. Commit your changes (git commit -am 'Improve docs')

8. Push to your branch (git push origin improve-docs)

9. Create a Pull Request

License

All code released under the MIT license