Listar obras

GET/v1/works

Devuelve obras página a página, ordenadas por popularidad, puntuación, novedad o proximidad. Filtra la lista por formato, género, temporada, estado de publicación o sentido de lectura.

Solicitud

Shell

curl "https://api.nogitsu.com/v1/works?medium=anime&limit=3"

Parámetros

medium
consultaopcional
Solo obras de este formato.
texto
Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
releaseStatus
consultaopcional
Solo obras con este estado de publicación.
texto
Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
readingDirection
consultaopcional
Solo obras que se leen en este sentido.
texto
Valores permitidosrtlltrvertical_scroll
genre
consultaopcional
Solo obras con este género, por slug.
texto
hasBanner
consultaopcional
true para obtener solo obras que tienen imagen de banner.
texto
hasTrailer
consultaopcional
true para obtener solo obras que tienen tráiler.
texto
minCoverWidth
consultaopcional
Solo obras cuya portada mide al menos estos píxeles de ancho.
número entero
De 1 a 10000
season
consultaopcional
Solo obras que empezaron en esta temporada.
texto
Valores permitidoswinterspringsummerfall
seasonYear
consultaopcional
Año de la temporada; úsalo junto con season.
número entero
De 1900 a 2100
sort
consultaopcional
Orden de los resultados.
texto
Valores permitidospopularityscorenewestsoonest
Predeterminado: popularity
limit
consultaopcional
Cuántos elementos devolver en una página.
número entero
De 1 a 50Predeterminado: 20
cursor
consultaopcional
El valor nextCursor de la página anterior. Omítelo para la primera página.
texto
language
consultaopcional
Código de idioma de dos letras para los textos de la respuesta, como en o tr. Omítelo para inglés.
texto
Predeterminado: en

Respuesta

Una solicitud correcta responde 200 con este JSON:

itemslista de objeto
- idtexto (uuid)
- slugtexto
- mediumtexto
  Valores permitidosanimedonghuaanimationmangamanhwamanhuawebtoon
- publicationFormattexto
  Valores permitidostvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
- releaseStatustexto
  Valores permitidosnot_yet_releasedreleasingfinishedhiatuscancelledunknown
- readingDirectiontextopuede ser null
  Valores permitidosrtlltrvertical_scroll
- primaryTitletexto
- englishTitletextopuede ser null
- nativeTitletextopuede ser null
- romanizedTitletextopuede ser null
- contentRatingtexto
  Valores permitidosunknownall_agesteenmatureadult
- seasontextopuede ser null
  Valores permitidoswinterspringsummerfall
- seasonYearnúmero enteropuede ser null
  De -9007199254740991 a 9007199254740991
- startDatetexto (date)puede ser null
- totalUnitsnúmero enteropuede ser null
  De -9007199254740991 a 9007199254740991
- aggregateScorenúmero enteropuede ser null
  De 0 a 1000
- scoreRanknúmero enteropuede ser null
  De 0 a 9007199254740991
- popularityRanknúmero enteropuede ser null
  De 0 a 9007199254740991
- audienceSizenúmero enteropuede ser null
  De 0 a 9007199254740991
- coverobjetopuede ser null
  urltexto (uri)
  widthnúmero enteropuede ser null
  De 0 a 9007199254740991
  heightnúmero enteropuede ser null
  De 0 a 9007199254740991
  blurhashtextopuede ser null
  providertextopuede ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número entero
  De 0 a 9007199254740991
- bannerobjetopuede ser null
  urltexto (uri)
  widthnúmero enteropuede ser null
  De 0 a 9007199254740991
  heightnúmero enteropuede ser null
  De 0 a 9007199254740991
  blurhashtextopuede ser null
  providertextopuede ser null
  Valores permitidosanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
  variantWidthslista de número entero
  De 0 a 9007199254740991
- trailerobjetopuede ser null
  hosttexto
  Valores permitidosyoutube
  keytexto
- primaryStudiotextopuede ser null
- genreslista de objeto
  slugtexto
  labeltexto
- contentWarningslista de texto
  Valores permitidosviolencegoresexual-contentsuicide
- descriptionobjetopuede ser null
  texttexto
  languagetexto
  isMachineGeneratedtrue o false
- sourceUrltexto (uri)puede ser null
nextCursortextopuede ser null

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