Explorar obras

GET/v1/search/works/explore

A busca filtrada por trás da página Explorar: combine gêneros, temas, formatos, temporadas, anos, notas, estúdios e mais, e receba uma contagem para cada valor de filtro.

Requisição

Shell

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

Parâmetros

q
consultaopcional
Texto a buscar.
texto
medium
consultaopcional
Apenas obras desta mídia.
texto
Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
genres
consultaopcional
Apenas obras com todos estes gêneros; slugs separados por vírgulas.
um de vários formatos
themes
consultaopcional
Apenas obras com todos estes temas; slugs separados por vírgulas.
um de vários formatos
demographics
consultaopcional
Apenas obras para qualquer um destes públicos; slugs separados por vírgulas.
um de vários formatos
excludedWarnings
consultaopcional
Deixa de fora obras com estes avisos de conteúdo; slugs separados por vírgulas.
um de vários formatos
statuses
consultaopcional
Apenas obras com estes status de lançamento, separados por vírgulas.
um de vários formatos
formats
consultaopcional
Apenas obras nestes formatos, separados por vírgulas.
um de vários formatos
seasons
consultaopcional
Apenas obras que começaram nestas temporadas, separadas por vírgulas.
um de vários formatos
countries
consultaopcional
Apenas obras destes países de origem; códigos de duas letras separados por vírgulas.
um de vários formatos
readingDirections
consultaopcional
Apenas obras lidas nestes sentidos, separados por vírgulas.
um de vários formatos
contentRatings
consultaopcional
Apenas obras com estas classificações etárias, separadas por vírgulas.
um de vários formatos
visibleContentRatings
consultaopcional
Classificações etárias a incluir, separadas por vírgulas: all_ages, teen, mature, adult. Omita-o para ocultar obras adultas.
texto
studios
consultaopcional
Apenas obras deste estúdio. Repita o parâmetro para aceitar qualquer um de vários estúdios.
um de vários formatos
publishers
consultaopcional
Apenas obras desta editora. Repita o parâmetro para aceitar qualquer uma de várias editoras.
um de vários formatos
creators
consultaopcional
Apenas obras deste criador. Repita o parâmetro para aceitar qualquer um de vários criadores.
um de vários formatos
yearFrom
consultaopcional
Apenas obras que começaram neste ano ou depois.
número inteiro
De 1900 a 2100
yearTo
consultaopcional
Apenas obras que começaram neste ano ou antes.
número inteiro
De 1900 a 2100
scoreMin
consultaopcional
Apenas obras com pelo menos esta nota, de 0 a 10.
número
De 0 a 10
unitsMin
consultaopcional
Apenas obras com pelo menos esta quantidade de episódios ou capítulos.
número inteiro
De 0 a 100000
unitsMax
consultaopcional
Apenas obras com no máximo esta quantidade de episódios ou capítulos.
número inteiro
De 0 a 100000
durationMin
consultaopcional
Apenas obras cujos episódios duram pelo menos estes minutos.
número inteiro
De 0 a 100000
durationMax
consultaopcional
Apenas obras cujos episódios duram no máximo estes minutos.
número inteiro
De 0 a 100000
volumesMin
consultaopcional
Apenas obras com pelo menos esta quantidade de volumes.
número inteiro
De 0 a 100000
volumesMax
consultaopcional
Apenas obras com no máximo esta quantidade de volumes.
número inteiro
De 0 a 100000
hasTrailer
consultaopcional
true para apenas obras que têm trailer.
texto
sort
consultaopcional
Ordem dos resultados.
texto
Valores permitidosrelevancepopularityscorenewest
Padrão: popularity
page
consultaopcional
Número da página, a partir de 1.
número inteiro
De 1 a 100Padrão: 1

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
pagenúmero inteiro
De 0 a 9007199254740991
pageSizenúmero inteiro
De 0 a 9007199254740991
facetsobjeto
- genreslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- themeslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- demographicslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- contentWarningslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- statuseslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- formatslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- seasonslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- countrieslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- readingDirectionslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- contentRatingslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- studioslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- publisherslista de objeto
  valuetexto
  countnúmero inteiro
  De 0 a 9007199254740991
- creatorslista de objeto
  valuetexto
  countnú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