Explorer les œuvres

GET/v1/search/works/explore

La recherche filtrée derrière la page Explorer : combinez genres, thèmes, formats, saisons, années, notes, studios et plus encore, et obtenez un total pour chaque valeur de filtre.

Requête

Shell

curl "https://api.nogitsu.com/v1/search/works/explore?medium=anime&genres=fantasy"

Paramètres

q
requêtefacultatif
Texte à rechercher.
texte
medium
requêtefacultatif
Uniquement les œuvres de ce format.
texte
Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
genres
requêtefacultatif
Uniquement les œuvres ayant tous ces genres ; slugs séparés par des virgules.
l’une de plusieurs formes
themes
requêtefacultatif
Uniquement les œuvres ayant tous ces thèmes ; slugs séparés par des virgules.
l’une de plusieurs formes
demographics
requêtefacultatif
Uniquement les œuvres destinées à l’un de ces publics ; slugs séparés par des virgules.
l’une de plusieurs formes
excludedWarnings
requêtefacultatif
Exclure les œuvres ayant ces avertissements de contenu ; slugs séparés par des virgules.
l’une de plusieurs formes
statuses
requêtefacultatif
Uniquement les œuvres ayant ces statuts de parution, séparés par des virgules.
l’une de plusieurs formes
formats
requêtefacultatif
Uniquement les œuvres dans ces formats, séparés par des virgules.
l’une de plusieurs formes
seasons
requêtefacultatif
Uniquement les œuvres qui ont commencé durant ces saisons, séparées par des virgules.
l’une de plusieurs formes
countries
requêtefacultatif
Uniquement les œuvres de ces pays d’origine ; codes à deux lettres séparés par des virgules.
l’une de plusieurs formes
readingDirections
requêtefacultatif
Uniquement les œuvres qui se lisent dans ces sens, séparés par des virgules.
l’une de plusieurs formes
contentRatings
requêtefacultatif
Uniquement les œuvres ayant ces classifications par âge, séparées par des virgules.
l’une de plusieurs formes
visibleContentRatings
requêtefacultatif
Classifications par âge à inclure, séparées par des virgules : all_ages, teen, mature, adult. Omettez-le pour masquer les œuvres pour adultes.
texte
studios
requêtefacultatif
Uniquement les œuvres de ce studio. Répétez le paramètre pour accepter l’un de plusieurs studios.
l’une de plusieurs formes
publishers
requêtefacultatif
Uniquement les œuvres de cet éditeur. Répétez le paramètre pour accepter l’un de plusieurs éditeurs.
l’une de plusieurs formes
creators
requêtefacultatif
Uniquement les œuvres de ce créateur. Répétez le paramètre pour accepter l’un de plusieurs créateurs.
l’une de plusieurs formes
yearFrom
requêtefacultatif
Uniquement les œuvres qui ont commencé cette année-là ou après.
nombre entier
De 1900 à 2100
yearTo
requêtefacultatif
Uniquement les œuvres qui ont commencé cette année-là ou avant.
nombre entier
De 1900 à 2100
scoreMin
requêtefacultatif
Uniquement les œuvres ayant au moins cette note, de 0 à 10.
nombre
De 0 à 10
unitsMin
requêtefacultatif
Uniquement les œuvres ayant au moins ce nombre d’épisodes ou de chapitres.
nombre entier
De 0 à 100000
unitsMax
requêtefacultatif
Uniquement les œuvres ayant au plus ce nombre d’épisodes ou de chapitres.
nombre entier
De 0 à 100000
durationMin
requêtefacultatif
Uniquement les œuvres dont les épisodes durent au moins ce nombre de minutes.
nombre entier
De 0 à 100000
durationMax
requêtefacultatif
Uniquement les œuvres dont les épisodes durent au plus ce nombre de minutes.
nombre entier
De 0 à 100000
volumesMin
requêtefacultatif
Uniquement les œuvres ayant au moins ce nombre de tomes.
nombre entier
De 0 à 100000
volumesMax
requêtefacultatif
Uniquement les œuvres ayant au plus ce nombre de tomes.
nombre entier
De 0 à 100000
hasTrailer
requêtefacultatif
true pour n’obtenir que les œuvres qui ont une bande-annonce.
texte
sort
requêtefacultatif
Ordre des résultats.
texte
Valeurs autoriséesrelevancepopularityscorenewest
Par défaut : popularity
page
requêtefacultatif
Numéro de page, à partir de 1.
nombre entier
De 1 à 100Par défaut : 1

Réponse

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

hitsliste de objet
- idtexte (uuid)
- mediumtexte
  Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
- slugtexte
- titletexte
- nativeTitletextepeut être null
- romanizedTitletextepeut être null
- contentRatingtexte
  Valeurs autoriséesunknownall_agesteenmatureadult
- publicationFormattexte
  Valeurs autoriséestvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexte
  Valeurs autoriséesnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- yearnombre entierpeut être null
  De -9007199254740991 à 9007199254740991
- scorenombre entierpeut être null
  De 0 à 1000
- coverobjetpeut être null
  urltexte (uri)
  variantWidthsliste de nombre entier
  De 0 à 9007199254740991
- contentWarningsliste de texte
  Valeurs autoriséesviolencegoresexual-contentsuicide
foundnombre entier
De 0 à 9007199254740991
pagenombre entier
De 0 à 9007199254740991
pageSizenombre entier
De 0 à 9007199254740991
facetsobjet
- genresliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- themesliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- demographicsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- contentWarningsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- statusesliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- formatsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- seasonsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- countriesliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- readingDirectionsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- contentRatingsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- studiosliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- publishersliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991
- creatorsliste de objet
  valuetexte
  countnombre entier
  De 0 à 9007199254740991

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