Buscar obras

GET/v1/search/works

Retorna obras cujos títulos correspondem a um texto, com as melhores correspondências primeiro.

Requisição

Shell

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

Parâmetros

q
consultaobrigatório
Texto a buscar.
texto
medium
consultaopcional
Apenas obras desta mídia.
texto
Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
limit
consultaopcional
Quantos itens retornar em uma página.
número inteiro
De 1 a 25Padrão: 10
visibleContentRatings
consultaopcional
Classificações etárias a incluir, separadas por vírgulas: all_ages, teen, mature, adult. Omita-o para ocultar obras adultas.
texto

Resposta

Uma requisição bem-sucedida responde 200 com este JSON:

hitslista de objeto
- idtexto (uuid)
- mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
- slugtexto
- titletexto
- nativeTitletextopode ser null
- romanizedTitletextopode ser null
- contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
- publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- yearnúmero inteiropode ser null
  De -9007199254740991 a 9007199254740991
- scorenúmero inteiropode ser null
  De 0 a 1000
- coverobjetopode ser null
  urltexto (uri)
  variantWidthslista de número inteiro
  De 0 a 9007199254740991
- contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
foundnúmero inteiro
De 0 a 9007199254740991

Erros

Como toda operação, esta pode responder 400 para parâmetros inválidos, 404 quando nada é encontrado e 429 quando você envia requisições demais. Todos os erros compartilham o mesmo formato.

Leia sobre erros