Saltar al contenido

Buscar valores de filtro

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

Devuelve nombres de estudios, editoriales o creadores que empiezan por el texto que indiques, con cuántas obras coinciden con cada uno.

Solicitud

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

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

  • facet

    consultaobligatorio

    Qué nombres consultar.

    texto

    Valores permitidosstudiospublisherscreators
  • prefix

    consultaobligatorio

    El comienzo del nombre que buscas.

    texto

Respuesta

Una solicitud correcta responde 200 con este JSON:

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