본문으로 건너뛰기

다가오는 화 조회

GET/v1/schedule

지정한 시점부터 1~7일 동안 정확한 방영 시각이 있는 화를 반환해요.

요청

Shell
curl "https://api.nogitsu.com/v1/schedule?from=2026-11-03T00%3A00%3A00.000Z&days=1"

매개변수

  • from

    쿼리필수

    기간의 시작(ISO 8601 날짜와 시각).

    텍스트 (date-time)

  • days

    쿼리선택

    시작부터 포함할 일수.

    정수

    1부터 7까지기본값: 1

  • limit

    쿼리선택

    한 페이지에 반환할 항목 수.

    정수

    1부터 100까지기본값: 50

  • language

    쿼리선택

    응답 텍스트의 두 글자 언어 코드(예: en, tr). 영어라면 생략하세요.

    텍스트

    기본값: en

응답

요청이 성공하면 다음 JSON과 함께 200으로 응답해요.

  • items객체 목록
    • unitId텍스트 (uuid)
    • episodeNumber숫자

      0 이상

    • airsAt텍스트 (date-time)
    • work객체
      • id텍스트 (uuid)
      • slug텍스트
      • medium텍스트
        허용되는 값animedonghuaanimationmangamanhwamanhuawebtoon
      • publicationFormat텍스트
        허용되는 값tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
      • releaseStatus텍스트
        허용되는 값not_yet_releasedreleasingfinishedhiatuscancelledunknown
      • readingDirection텍스트null일 수 있음
        허용되는 값rtlltrvertical_scroll
      • primaryTitle텍스트
      • englishTitle텍스트null일 수 있음
      • nativeTitle텍스트null일 수 있음
      • romanizedTitle텍스트null일 수 있음
      • contentRating텍스트
        허용되는 값unknownall_agesteenmatureadult
      • season텍스트null일 수 있음
        허용되는 값winterspringsummerfall
      • seasonYear정수null일 수 있음

        -9007199254740991부터 9007199254740991까지

      • startDate텍스트 (date)null일 수 있음
      • totalUnits정수null일 수 있음

        -9007199254740991부터 9007199254740991까지

      • aggregateScore정수null일 수 있음

        0부터 1000까지

      • scoreRank정수null일 수 있음

        0부터 9007199254740991까지

      • popularityRank정수null일 수 있음

        0부터 9007199254740991까지

      • audienceSize정수null일 수 있음

        0부터 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까지

      • 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까지

      • trailer객체null일 수 있음
        • host텍스트
          허용되는 값youtube
        • key텍스트
      • primaryStudio텍스트null일 수 있음
      • genres객체 목록
        • slug텍스트
        • label텍스트
      • contentWarnings텍스트 목록
        허용되는 값violencegoresexual-contentsuicide
      • description객체null일 수 있음
        • text텍스트
        • language텍스트
        • isMachineGeneratedtrue 또는 false
      • sourceUrl텍스트 (uri)null일 수 있음

오류

다른 모든 작업처럼 이 작업도 매개변수가 잘못되면 400, 찾는 것이 없으면 404, 요청을 너무 많이 보내면 429로 응답할 수 있어요. 모든 오류는 같은 형식이에요.

오류 알아보기