Pular para o conteúdo

Encontrar valores de filtro

GET/v1/search/works/explore/facet-values

Retorna nomes de estúdios, editoras ou criadores que começam com o texto informado, com quantas obras correspondem a cada um.

Requisição

Shell
curl "https://api.nogitsu.com/v1/search/works/explore/facet-values?facet=studios&prefix=mad"

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

  • facet

    consultaobrigatório

    Quais nomes consultar.

    texto

    Valores permitidosstudiospublisherscreators
  • prefix

    consultaobrigatório

    O início do nome a procurar.

    texto

Resposta

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

  • itemslista 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