---
title: "剧集推荐"
method: GET
path: "/getSeriesRecommendList"
tags: ["Recommend"]
---

# 剧集推荐

`GET /getSeriesRecommendList`

根据推荐位返回对应的推荐剧集列表。

响应契约：SeriesCardList。

需要登录。 需要请求签名。 响应会经过加密中间件。

认证要求：需要登录。

签名要求：需要请求签名。

响应处理：默认会经过响应加密。

## Query parameters

- `position` integer, required — 推荐位标识。
- `series_id` integer — 当前剧集 ID。
- `page_no` integer — 页码。
- `page_size` integer — 每页条数。

## Headers

- `lang` string — 语言代码，例如 en、zh、es。
- `device_number` string — 设备唯一标识。
- `app_version` string — 客户端版本号。
- `timestamp` integer — 请求时间戳（秒）。
- `signature` string — 接口签名。

## Response `200`

请求成功

- object
  - `code` integer, required
  - `msg` string, required
  - `data` SeriesCardList, required
    - `list` object[]
      - `series_id` integer
      - `video_type` integer
      - `series_name` string
      - `description` string
      - `cover` string
      - `tv_cover` string
      - `serial_status` integer
      - `watch_num` string
      - `watch_num_int` integer
      - `collect_num` integer
      - `collect_num_str` string
      - `last_series_no` integer
      - `section_num` integer
      - `tag_ids` string
      - `tag_list` object[]
        - `tag_id` integer, required — 标签内部数字 ID，对应 series_tag_group.id；前端生成链接时不要依赖该字段。
        - `tag_name` string, required — 当前语言下的标签展示名称。
        - `url_title` string, required — 标签 URL 基础 slug，不包含 web_tag_id。
        - `web_tag_id` string, required — 由 tag_id 编码得到的对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。
      - `tag` string
      - `series_topic` string
      - `show_video_type` integer
      - `icon_type` integer
      - `icon_text` string
      - `icon_color` string
      - `icon` string
  - `info` object, required
  - `is_encrypt` 0 | 1, required
  - `request_id` string, required
  - `response_time` integer, required
  - `original_data` object

## Other responses

- `400` — 请求失败

---

[API](https://skmtc.dev/flextv/apis/flextv-api.md) · [All operations](https://skmtc.dev/flextv/apis/flextv-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/flextv/flextv-api/revisions/84f55eb57fd0/schema)