/kitsu-season-trends

🦊 Kitsu seasonal anime trends

Primary LanguageJavaScriptMIT LicenseMIT

Season Trends

web badge uptime badge contributors badge actions badge

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

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