跳到主要内容

搜索作品

GET/v1/search/works

返回标题与文本匹配的作品,最佳匹配排在前面。

请求

Shell
curl "https://api.nogitsu.com/v1/search/works?q=frieren"

参数

  • q

    查询必填

    要搜索的文本。

    文本

  • medium

    查询可选

    仅限此媒介的作品。

    文本

    允许的值animedonghuaanimationmangamanhwamanhuawebtoon
  • limit

    查询可选

    每页返回的条目数。

    整数

    1 到 25默认值:10

  • visibleContentRatings

    查询可选

    要包含的年龄分级,以逗号分隔:all_ages、teen、mature、adult。省略时隐藏成人作品。

    文本

响应

请求成功时返回 200 和以下 JSON:

  • hits对象 列表
    • id文本 (uuid)
    • medium文本
      允许的值animedonghuaanimationmangamanhwamanhuawebtoon
    • slug文本
    • title文本
    • nativeTitle文本可为 null
    • romanizedTitle文本可为 null
    • contentRating文本
      允许的值unknownall_agesteenmatureadult
    • publicationFormat文本
      允许的值tvtv_shortmovieovaonaspecialmusicserializedone_shotdoujinlight_novelweb_novel
    • releaseStatus文本
      允许的值not_yet_releasedreleasingfinishedhiatuscancelledunknown
    • year整数可为 null

      -9007199254740991 到 9007199254740991

    • score整数可为 null

      0 到 1000

    • cover对象可为 null
      • url文本 (uri)
      • variantWidths整数 列表

        0 到 9007199254740991

    • contentWarnings文本 列表
      允许的值violencegoresexual-contentsuicide
  • found整数

    0 到 9007199254740991

错误

与所有操作一样,此操作在参数无效时可能返回 400,找不到内容时返回 404,请求过多时返回 429。所有错误的结构都相同。

了解错误