Lister les œuvres

GET/v1/works

Renvoie les œuvres page par page, triées par popularité, note, nouveauté ou date la plus proche. Affinez la liste par format, genre, saison, statut de parution ou sens de lecture.

Requête

Shell

curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

Paramètres

medium
requêtefacultatif
Uniquement les œuvres de ce format.
texte
Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
requêtefacultatif
Uniquement les œuvres ayant ce statut de parution.
texte
Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
requêtefacultatif
Uniquement les œuvres qui se lisent dans ce sens.
texte
Valeurs autoriséesrtlltrvertical_scroll
genre
requêtefacultatif
Uniquement les œuvres de ce genre, par slug.
texte
hasBanner
requêtefacultatif
true pour n’obtenir que les œuvres qui ont une bannière.
texte
hasTrailer
requêtefacultatif
true pour n’obtenir que les œuvres qui ont une bande-annonce.
texte
minCoverWidth
requêtefacultatif
Uniquement les œuvres dont la couverture mesure au moins ce nombre de pixels de large.
nombre entier
De 1 à 10000
season
requêtefacultatif
Uniquement les œuvres qui ont commencé durant cette saison.
texte
Valeurs autoriséeswinterspringsummerfall
seasonYear
requêtefacultatif
Année de la saison ; à utiliser avec season.
nombre entier
De 1900 à 2100
sort
requêtefacultatif
Ordre des résultats.
texte
Valeurs autoriséespopularityscorenewestsoonest
Par défaut : popularity
limit
requêtefacultatif
Nombre d’éléments à renvoyer sur une page.
nombre entier
De 1 à 50Par défaut : 20
cursor
requêtefacultatif
La valeur nextCursor de la page précédente. Omettez-la pour la première page.
texte
language
requêtefacultatif
Code de langue à deux lettres pour les textes de la réponse, comme en ou tr. Omettez-le pour l’anglais.
texte
Par défaut : en

Réponse

Une requête réussie répond 200 avec ce JSON :

itemsliste de objet
- idtexte (uuid)
- slugtexte
- mediumtexte
  Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormattexte
  Valeurs autoriséestvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexte
  Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectiontextepeut être null
  Valeurs autoriséesrtlltrvertical_scroll
- primaryTitletexte
- englishTitletextepeut être null
- nativeTitletextepeut être null
- romanizedTitletextepeut être null
- contentRatingtexte
  Valeurs autoriséesunknownall_agesteenmatureadult
- seasontextepeut être null
  Valeurs autoriséeswinterspringsummerfall
- seasonYearnombre entierpeut être null
  De -9007199254740991 à 9007199254740991
- startDatetexte (date)peut être null
- totalUnitsnombre entierpeut être null
  De -9007199254740991 à 9007199254740991
- aggregateScorenombre entierpeut être null
  De 0 à 1000
- scoreRanknombre entierpeut être null
  De 0 à 9007199254740991
- popularityRanknombre entierpeut être null
  De 0 à 9007199254740991
- audienceSizenombre entierpeut être null
  De 0 à 9007199254740991
- coverobjetpeut être null
  urltexte (uri)
  widthnombre entierpeut être null
  De 0 à 9007199254740991
  heightnombre entierpeut être null
  De 0 à 9007199254740991
  blurhashtextepeut être null
  providertextepeut être null
  Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
- bannerobjetpeut être null
  urltexte (uri)
  widthnombre entierpeut être null
  De 0 à 9007199254740991
  heightnombre entierpeut être null
  De 0 à 9007199254740991
  blurhashtextepeut être null
  providertextepeut être null
  Valeurs autoriséesanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
- trailerobjetpeut être null
  hosttexte
  Valeurs autoriséesyoutube
  keytexte
- primaryStudiotextepeut être null
- genresliste de objet
  slugtexte
  labeltexte
- contentWarningsliste de texte
  Valeurs autoriséesviolencegoresexual-contentsuicide
- descriptionobjetpeut être null
  texttexte
  languagetexte
  isMachineGeneratedtrue ou false
- sourceUrltexte (uri)peut être null
nextCursortextepeut être null

Erreurs

Comme toutes les opérations, celle-ci peut répondre 400 en cas de paramètres invalides, 404 lorsque rien n’est trouvé et 429 lorsque vous envoyez trop de requêtes. Toutes les erreurs partagent la même forme.

En savoir plus sur les erreurs