---
title: "Web 标签详情页"
method: GET
path: "/webGetTagDetail"
tags: ["WebIndex"]
---

# Web 标签详情页

`GET /webGetTagDetail`

返回当前请求语言下的标签头部信息、后台 TDK、关联标签和分页短剧列表，同时兼容系统内容标签与 Web 自定义标签。tag_info.is_custom_tag 标识标签类型：1 为 Web 自定义标签，0 为系统内容标签。Web 自定义标签仅在已上架且未删除时可访问，“全部标签页显示”开关只影响 /webGetTagAll，不影响已上架标签通过详情链接直接访问。TDK 优先返回后台配置的 Title、Description、Keywords，未配置的字段使用系统默认值。自定义标签短剧按后台绑定权重倒序，系统内容标签短剧按上架时间倒序。关联标签仅返回同语言、已上架的 Web 自定义标签，按创建时间倒序；完整名称中当前标签作为独立词出现时，tag_name 删除该独立词，否则原样返回，点击时使用该项的 url_title 和 web_tag_id 进入其完整标签详情页。受国家版权过滤影响，单页 list 数量可能少于 page_size。

响应契约：TagDetail。

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

认证要求：无需登录。

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

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

## Query parameters

- `page_no` integer — 页码，从 1 开始；默认 1。
- `page_size` integer — 每页短剧数，默认 10，最大 100；小于等于 0 时按 10 处理。
- `url_title` string — 标签 slug 或完整详情页 slug，例如 urban1 或 urban1-pjy82pmz24；与 web_tag_id 至少传一个，建议前端传完整 slug。
- `web_tag_id` string — 标签对外 hash ID，例如 pjy82pmz24；请求中间件会解码为内部 tag_id。与 url_title 至少传一个。
- `tag_id` 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` TagDetail, required — Web 标签详情页数据。
    - `tag_info` object, required — 标签头部及 TDK 信息。标签不存在、语言不匹配或 Web 自定义标签已下架/删除时返回空对象。
      - `tag_id` integer — 标签内部数字 ID，对应 series_tag_group.id。
      - `tag_name` string — 当前语言下的完整标签名称。
      - `url_title` string — 当前标签 URL 基础 slug，不包含 web_tag_id。
      - `web_tag_id` string — 当前标签对外 hash ID。英文详情页地址为 /genres/{url_title}-{web_tag_id}，非英文地址为 /{lang}/genres/{url_title}-{web_tag_id}。
      - `is_custom_tag` 0 | 1 — 是否为 Web 自定义标签：1 是，0 否（系统内容标签）。
      - `title` string — 页面 SEO Title。Web 自定义标签优先返回后台 TDK 配置中的 seo_title；未配置时返回标签名称。
      - `description` string — 页面 SEO Description。Web 自定义标签优先返回后台 TDK 配置中的 seo_description；未配置时返回系统生成的默认描述。
      - `keywords` string — 页面 SEO Keywords。Web 自定义标签优先返回后台 TDK 配置中的 seo_keywords；未配置时返回标签名称。
      - `series_total` integer — 符合语言、上架、审核通过、未隐藏条件的关联短剧总数。国家版权过滤在分页查询后执行，因此 list 实际数量可能少于 page_size。
    - `related_tags` object[], required — 关联标签列表，仅包含同语言、已上架的 Web 自定义标签，按创建时间倒序，默认最多 10 条。后台配置的关联标签均可返回；完整名称中当前标签作为独立词出现时，仅删除该独立词作为展示名称，否则原样展示。
      - `tag_id` integer, required — 完整关联标签的内部数字 ID。
      - `tag_name` string, required — 关联标签展示文本，已移除当前标签词。例如当前标签为 work、完整关联标签为 good work 时返回 good。
      - `url_title` string, required — 完整关联标签的 URL 基础 slug，例如 good-work。
      - `web_tag_id` string, required — 完整关联标签的对外 hash ID；与 url_title 拼接后跳转到完整关联标签详情页。
    - `paging` object, required — 短剧列表分页信息，total 与 tag_info.series_total 一致。
      - `page_no` integer, required — 当前页码，从 1 开始。
      - `page_size` integer, required — 接口实际采用的每页条数。
      - `total` integer, required — 满足当前接口查询条件的记录总数，不是总页数。
    - `list` object[], required — 当前页短剧列表。Web 自定义标签按后台绑定权重倒序；系统内容标签按短剧上架时间倒序。
      - `series_id` integer, required — 短剧 ID。
      - `series_name` string, required — 当前请求语言下的短剧名称；存在多语言配置时优先返回多语言名称。
      - `description` string, required — 当前请求语言下的短剧简介；存在多语言配置时优先返回多语言简介。
      - `cover` string, required — 适用于 Web 卡片展示的完整封面图片 URL。
      - `serial_status` 0 | 1, required — 连载状态：0 连载中，1 已完结。
      - `video_type` 1 | 2 | 3 | 4 | 5 | 6 | 7, required — 内容类型：1 短剧，2 电视剧，3 电影，4 动漫，5 UGC 视频，6 广告，7 AI 剧。
      - `section_num` integer, required — 当前短剧集数或最新更新集数。
      - `section_id` integer, required — 首集分集 ID；不存在首集时为 0。
      - `show_video_type` integer, required — 视频类型展示控制字段；当前接口固定返回 0，为前端兼容保留。
      - `icon_type` integer, required — 卡片角标类型，0 表示不展示角标；其他值按客户端既有角标规则处理。
      - `icon_text` string, required — 卡片角标文案，无角标时为空字符串。
      - `collect_num` integer, required — 用于页面展示的收藏数量整数值。
      - `collect_num_str` string, required — 格式化后的收藏数量，例如 1.2K、3.4M。
      - `watch_num_int` integer, required — 用于页面展示的观看数量整数值。
      - `watch_num_str` string, required — 格式化后的观看数量，例如 56K、2.3M。
      - `tag` object[], required — 短剧自身的系统内容标签，不包含通过 web_custom_tag_series 绑定的 Web 自定义标签。
        - `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}。
  - `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)