Skip to content

2023-01-04 - `v2` API

Compare
Choose a tag to compare
@beeequeue beeequeue released this 04 Jan 18:16
· 205 commits to master since this release

/api/v2/*

All endpoints under /v2 have a new query parameter: include

It's a comma-separated list of Sources to return from the database, if you want to save a teeny amount of bandwidth.

e.g. include=anilist,anidb,kitsu

GET/POST /api/v2/ids

Works just like before, except:

  • Can query with and get back the new Sources
  • Except for querying with thetvdb - see below for more details

GET /api/v2/thetvdb?id={number}

This endpoint exists for one reason: TheTVDB stores entire shows as entries instead of the usual seasons that all anime sites use.

This means that many TheTVDB ID maps to multiple IDs in for other services, for example thetvdb:70799 (Beyblade) has 8(!) entries in other sites.

The one-to-many relation would break the old API endpoint, so you'll have to use this one if you want to query by thetvdb.

The new sources are:

  • Anime-Planet (anime-planet)
  • aniSearch (anisearch)
  • IMDB (imdb)
  • LiveChart (livechart)
  • notify.moe (notify-moe)
  • TheMovieDB (themoviedb)
  • TheTVDB (thetvdb)