本文へスキップ

ニュースの一覧

GET/v1/news

ニュースを新しい順に返します。トピック、種類、メディアで絞り込めます。

リクエスト

Shell
curl "https://api.nogitsu.com/v1/news"

パラメーター

  • cursor

    クエリ任意

    前のページの nextCursor の値。最初のページでは省略します。

    テキスト

  • kind

    クエリ任意

    この種類のニュースのみ。

    テキスト

    使用できる値official_announcementcatalog_updaterumorindustry
  • topic

    クエリ任意

    この種類の出来事に関するニュースのみ。

    テキスト

    使用できる値release_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
  • mediumKind

    クエリ任意

    見る作品(screen)または読む作品(reading)に関するニュースのみ。

    テキスト

    使用できる値screenreading
  • limit

    クエリ任意

    1ページに返す項目数。

    整数

    1〜20既定値:20

レスポンス

リクエストが成功すると、次のJSONとともに200が返ります。

  • itemsオブジェクトのリスト
    • idテキスト (uuid)
    • slugテキスト
    • kindテキスト
      使用できる値official_announcementcatalog_updaterumorindustry
    • topicテキスト
      使用できる値release_startrelease_enddate_announceddate_changehiatus_returnsequel_announcedtrailer_added
    • publishedAtテキスト (date-time)
    • recordedAtテキスト (date-time)
    • isRetrospectivetrue または false
    • workオブジェクト
      • idテキスト (uuid)
      • slugテキスト
      • mediumテキスト
        使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormatテキスト
        使用できる値tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatusテキスト
        使用できる値not_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titleテキスト
      • nativeTitleテキストnull になる場合あり
      • romanizedTitleテキストnull になる場合あり
      • contentRatingテキスト
        使用できる値unknownall_agesteenmatureadult
      • startYear整数null になる場合あり

        -9007199254740991〜9007199254740991

      • coverオブジェクトnull になる場合あり
        • urlテキスト (uri)
        • width整数null になる場合あり

          0〜9007199254740991

        • height整数null になる場合あり

          0〜9007199254740991

        • blurhashテキストnull になる場合あり
        • providerテキストnull になる場合あり
          使用できる値anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidths整数のリスト

          0〜9007199254740991

      • contentWarningsテキストのリスト
        使用できる値violencegoresexual-contentsuicide
    • relatedWorkオブジェクトnull になる場合あり
      • idテキスト (uuid)
      • slugテキスト
      • mediumテキスト
        使用できる値animedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormatテキスト
        使用できる値tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatusテキスト
        使用できる値not_yet_releasedreleasingfinishedhiatuscancelledunknown
      • titleテキスト
      • nativeTitleテキストnull になる場合あり
      • romanizedTitleテキストnull になる場合あり
      • contentRatingテキスト
        使用できる値unknownall_agesteenmatureadult
      • startYear整数null になる場合あり

        -9007199254740991〜9007199254740991

      • coverオブジェクトnull になる場合あり
        • urlテキスト (uri)
        • width整数null になる場合あり

          0〜9007199254740991

        • height整数null になる場合あり

          0〜9007199254740991

        • blurhashテキストnull になる場合あり
        • providerテキストnull になる場合あり
          使用できる値anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
        • variantWidths整数のリスト

          0〜9007199254740991

      • contentWarningsテキストのリスト
        使用できる値violencegoresexual-contentsuicide
    • bannerオブジェクトnull になる場合あり
      • urlテキスト (uri)
      • width整数null になる場合あり

        0〜9007199254740991

      • height整数null になる場合あり

        0〜9007199254740991

      • blurhashテキストnull になる場合あり
      • providerテキストnull になる場合あり
        使用できる値anime_offline_databaseanimapanilistmyanimelistanidbanime_news_networkanime_filler_listkitsuanime_planetanisearchtvdbimdbtmdbsimklmangaupdatesmangabakawikipedia
      • variantWidths整数のリスト

        0〜9007199254740991

    • factsオブジェクト
      • startDateテキスト (date)null になる場合あり
      • endDateテキスト (date)null になる場合あり
      • videoKeyテキストnull になる場合あり
  • nextCursorテキストnull になる場合あり

エラー

他の操作と同様に、この操作も無効なパラメーターでは400、何も見つからない場合は404、リクエストが多すぎる場合は429を返すことがあります。すべてのエラーは同じ形式です。

エラーについて読む