Buscar obras

GET/v1/search/works

Devuelve obras cuyos títulos coinciden con un texto, primero las mejores coincidencias.

Solicitud

Shell

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

Parámetros

q
consultaobligatorio
Texto que buscar.
texto
medium
consultaopcional
Solo obras de este formato.
texto
Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
limit
consultaopcional
Cuántos elementos devolver en una página.
número entero
De 1 a 25Predeterminado: 10
visibleContentRatings
consultaopcional
Clasificaciones por edad que incluir, separadas por comas: all_ages, teen, mature, adult. Omítelo para ocultar las obras para adultos.
texto

Respuesta

Una solicitud correcta responde 200 con este JSON:

hitslista de objeto
- idtexto (uuid)
- mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
- slugtexto
- titletexto
- nativeTitletextopuede ser null
- romanizedTitletextopuede ser null
- contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
- publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- yearnúmero enteropuede ser null
  De -9007199254740991 a 9007199254740991
- scorenúmero enteropuede ser null
  De 0 a 1000
- coverobjetopuede ser null
  urltexto (uri)
  variantWidthslista de número entero
  De 0 a 9007199254740991
- contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
foundnúmero entero
De 0 a 9007199254740991

Errores

Como todas las operaciones, esta puede responder 400 si los parámetros no son válidos, 404 si no se encuentra nada y 429 si envías demasiadas solicitudes. Todos los errores comparten una misma forma.

Lee sobre los errores