Skip to content
🦊 Kitsu seasonal anime trends
JavaScript CSS HTML Shell
Branch: master
Clone or download

README.md

Season Trends

web badge uptime badge contributors badge travis badge david badge david dev badge donate badge

Kitsu season trends for the currently airing anime

Using the Data

All the data is free to use and available in:

  • 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

{
  data: [
    {
      i: 12, // Kitsu anime ID
      t: 'One Piece', // Canonical title
      u: 0, // Subtype (0: TV, 1: ONA)
      n: 1, // 0: Leftover, 1: New
      d: [ // Data array containing each daily update
        {
          i: 0, // Index
          d: 416359, // Hours since epoch (x3600000 to get datetime)
          m: 8.54,  // Mean score (omitted if 0)
          r: 14030, // Users Rated (omitted if 0)
          u: 25518, // Users (omitted if 0)
          f: 2387, // Users Favourited (omitted if 0)
        }
      ]
    }
  ],
  meta: {
    current: 65, // Total started airing this season
    total: 277 // Total shows being tracked
  }
  updated: '2017-07-22T15:12:09.391Z' // ISO date of the last cron update
}

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

You can’t perform that action at this time.