Zum Inhalt springen

Werke auflisten

GET/v1/works

Liefert Werke seitenweise, sortiert nach Beliebtheit, Wertung, Neuheit oder nächstem Termin. Grenze die Liste nach Medium, Genre, Season, Erscheinungsstatus oder Leserichtung ein.

Anfrage

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

Parameter

  • medium

    Queryoptional

    Nur Werke dieses Mediums.

    Text

    Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
  • releaseStatus

    Queryoptional

    Nur Werke mit diesem Erscheinungsstatus.

    Text

    Erlaubte Wertenot_yet_releasedreleasingfinishedhiatuscancelledunknown
  • readingDirection

    Queryoptional

    Nur Werke mit dieser Leserichtung.

    Text

    Erlaubte Wertertlltrvertical_scroll
  • genre

    Queryoptional

    Nur Werke mit diesem Genre, per Slug.

    Text

  • hasBanner

    Queryoptional

    true, um nur Werke mit Bannerbild zu erhalten.

    Text

  • hasTrailer

    Queryoptional

    true, um nur Werke mit Trailer zu erhalten.

    Text

  • minCoverWidth

    Queryoptional

    Nur Werke, deren Cover mindestens so viele Pixel breit ist.

    Ganzzahl

    Von 1 bis 10000

  • season

    Queryoptional

    Nur Werke, die in dieser Season gestartet sind.

    Text

    Erlaubte Wertewinterspringsummerfall
  • seasonYear

    Queryoptional

    Jahr der Season; zusammen mit season verwenden.

    Ganzzahl

    Von 1900 bis 2100

  • sort

    Queryoptional

    Reihenfolge der Ergebnisse.

    Text

    Erlaubte Wertepopularityscorenewestsoonest

    Standard: popularity

  • limit

    Queryoptional

    Wie viele Elemente eine Seite liefern soll.

    Ganzzahl

    Von 1 bis 50Standard: 20

  • cursor

    Queryoptional

    Der nextCursor-Wert der vorherigen Seite. Lass ihn für die erste Seite weg.

    Text

  • language

    Queryoptional

    Zweibuchstabiger Sprachcode für die Texte in der Antwort, etwa en oder tr. Lass ihn für Englisch weg.

    Text

    Standard: en

Antwort

Eine erfolgreiche Anfrage antwortet mit 200 und diesem JSON:

  • itemsListe von Objekt
    • idText (uuid)
    • slugText
    • mediumText
      Erlaubte Werteanimedonghuaanimationmangamanhwamanhuawebtoon
    • publicationFormatText
      Erlaubte Wertetvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatusText
      Erlaubte Wertenot_yet_releasedreleasingfinishedhiatuscancelledunknown
    • readingDirectionTextkann null sein
      Erlaubte Wertertlltrvertical_scroll
    • primaryTitleText
    • englishTitleTextkann null sein
    • nativeTitleTextkann null sein
    • romanizedTitleTextkann null sein
    • contentRatingText
      Erlaubte Werteunknownall_agesteenmatureadult
    • seasonTextkann null sein
      Erlaubte Wertewinterspringsummerfall
    • seasonYearGanzzahlkann null sein

      Von -9007199254740991 bis 9007199254740991

    • startDateText (date)kann null sein
    • totalUnitsGanzzahlkann null sein

      Von -9007199254740991 bis 9007199254740991

    • aggregateScoreGanzzahlkann null sein

      Von 0 bis 1000

    • scoreRankGanzzahlkann null sein

      Von 0 bis 9007199254740991

    • popularityRankGanzzahlkann null sein

      Von 0 bis 9007199254740991

    • audienceSizeGanzzahlkann null sein

      Von 0 bis 9007199254740991

    • coverObjektkann null sein
      • urlText (uri)
      • widthGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • heightGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • blurhashTextkann null sein
      • providerTextkann null sein
        Erlaubte Werteanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsListe von Ganzzahl

        Von 0 bis 9007199254740991

    • bannerObjektkann null sein
      • urlText (uri)
      • widthGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • heightGanzzahlkann null sein

        Von 0 bis 9007199254740991

      • blurhashTextkann null sein
      • providerTextkann null sein
        Erlaubte Werteanime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidthsListe von Ganzzahl

        Von 0 bis 9007199254740991

    • trailerObjektkann null sein
      • hostText
        Erlaubte Werteyoutube
      • keyText
    • primaryStudioTextkann null sein
    • genresListe von Objekt
      • slugText
      • labelText
    • contentWarningsListe von Text
      Erlaubte Werteviolencegoresexual-contentsuicide
    • descriptionObjektkann null sein
      • textText
      • languageText
      • isMachineGeneratedtrue oder false
    • sourceUrlText (uri)kann null sein
  • nextCursorTextkann null sein

Fehler

Wie jede Operation kann auch diese mit 400 bei ungültigen Parametern antworten, mit 404, wenn nichts gefunden wird, und mit 429, wenn du zu viele Anfragen sendest. Alle Fehler haben dieselbe Form.

Mehr über Fehler