Rechercher des œuvres

GET/v1/search/works

Renvoie les œuvres dont le titre correspond à un texte, les meilleures correspondances en premier.

Requête

Shell

curl "https://api.nogitsu.com/v1/search/works?q=frieren"

Paramètres

q
requêteobligatoire
Texte à rechercher.
texte
medium
requêtefacultatif
Uniquement les œuvres de ce format.
texte
Valeurs autoriséesanimedonghuaanimationmangamanhwamanhuawebtoon
limit
requêtefacultatif
Nombre d’éléments à renvoyer sur une page.
nombre entier
De 1 à 25Par défaut : 10
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

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

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