Saltar al contenido

Explorar obras

GET/v1/search/works/explore

La búsqueda filtrada de la página Explorar: combina géneros, temas, formatos, temporadas, años, puntuaciones, estudios y más, y obtén un recuento para cada valor de filtro.

Solicitud

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

Parámetros

  • q

    consultaopcional

    Texto que buscar.

    texto

  • medium

    consultaopcional

    Solo obras de este formato.

    texto

    Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
  • genres

    consultaopcional

    Solo obras con todos estos géneros; slugs separados por comas.

    una de varias formas

  • themes

    consultaopcional

    Solo obras con todos estos temas; slugs separados por comas.

    una de varias formas

  • demographics

    consultaopcional

    Solo obras para cualquiera de estos públicos; slugs separados por comas.

    una de varias formas

  • excludedWarnings

    consultaopcional

    Excluye las obras con estas advertencias de contenido; slugs separados por comas.

    una de varias formas

  • statuses

    consultaopcional

    Solo obras con estos estados de publicación, separados por comas.

    una de varias formas

  • formats

    consultaopcional

    Solo obras en estos formatos, separados por comas.

    una de varias formas

  • seasons

    consultaopcional

    Solo obras que empezaron en estas temporadas, separadas por comas.

    una de varias formas

  • countries

    consultaopcional

    Solo obras de estos países de origen; códigos de dos letras separados por comas.

    una de varias formas

  • readingDirections

    consultaopcional

    Solo obras que se leen en estos sentidos, separados por comas.

    una de varias formas

  • contentRatings

    consultaopcional

    Solo obras con estas clasificaciones por edad, separadas por comas.

    una de varias formas

  • visibleContentRatings

    consultaopcional

    Clasificaciones por edad que incluir, separadas por comas: all_ages, teen, mature, adult. Omítelo para ocultar las obras para adultos.

    texto

  • studios

    consultaopcional

    Solo obras de este estudio. Repite el parámetro para aceptar cualquiera de varios estudios.

    una de varias formas

  • publishers

    consultaopcional

    Solo obras de esta editorial. Repite el parámetro para aceptar cualquiera de varias editoriales.

    una de varias formas

  • creators

    consultaopcional

    Solo obras de este creador. Repite el parámetro para aceptar cualquiera de varios creadores.

    una de varias formas

  • yearFrom

    consultaopcional

    Solo obras que empezaron este año o después.

    número entero

    De 1900 a 2100

  • yearTo

    consultaopcional

    Solo obras que empezaron este año o antes.

    número entero

    De 1900 a 2100

  • scoreMin

    consultaopcional

    Solo obras con al menos esta puntuación, de 0 a 10.

    número

    De 0 a 10

  • unitsMin

    consultaopcional

    Solo obras con al menos este número de episodios o capítulos.

    número entero

    De 0 a 100000

  • unitsMax

    consultaopcional

    Solo obras con como máximo este número de episodios o capítulos.

    número entero

    De 0 a 100000

  • durationMin

    consultaopcional

    Solo obras cuyos episodios duran al menos estos minutos.

    número entero

    De 0 a 100000

  • durationMax

    consultaopcional

    Solo obras cuyos episodios duran como máximo estos minutos.

    número entero

    De 0 a 100000

  • volumesMin

    consultaopcional

    Solo obras con al menos este número de tomos.

    número entero

    De 0 a 100000

  • volumesMax

    consultaopcional

    Solo obras con como máximo este número de tomos.

    número entero

    De 0 a 100000

  • hasTrailer

    consultaopcional

    true para obtener solo obras que tienen tráiler.

    texto

  • sort

    consultaopcional

    Orden de los resultados.

    texto

    Valores permitidosrelevancepopularityscorenewest

    Predeterminado: popularity

  • page

    consultaopcional

    Número de página, empezando por 1.

    número entero

    De 1 a 100Predeterminado: 1

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

  • pagenúmero entero

    De 0 a 9007199254740991

  • pageSizenúmero entero

    De 0 a 9007199254740991

  • facetsobjeto
    • genreslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • themeslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • demographicslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • contentWarningslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • statuseslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • formatslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • seasonslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • countrieslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • readingDirectionslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • contentRatingslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • studioslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • publisherslista de objeto
      • valuetexto
      • countnúmero entero

        De 0 a 9007199254740991

    • creatorslista de objeto
      • valuetexto
      • countnú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