---
title: "Get one first page popup V3."
method: GET
path: "/recommend/getFistPagePopV3"
tags: ["Recommend"]
---

# Get one first page popup V3.

`GET /recommend/getFistPagePopV3`

Return one popup. Old first-page popup list is rotated on server side; if old popup is empty, fallback to drama popup V2.

响应契约：HomePopupItem。

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

认证要求：需要登录。

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

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

## Query parameters

- `series_id` integer — Current series id, used to filter self.

## 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` HomePopupItem, required — First page popup item returned by getFistPagePopV3.
    - `id` integer — Popup id.
    - `config_id` integer — Popup config id.
    - `source_config_id` integer — Source config id.
    - `recommend_name` string — Popup title.
    - `image` string — Popup image URL.
    - `cover` string — Series cover URL.
    - `series_name` string — Series name.
    - `jump_type` 'play' | 'open_url' | 'inner_url' | 'rand_series' — Jump type.
    - `jump_value` string — Jump target value.
    - `pop_up_style` integer — Popup style.
    - `url` string — URL for open_url or inner_url.
    - `series_id` integer — Target series id.
    - `is_collect` 0 | 1 — Whether collected: 0/1.
    - `tags` object[] — Reserved tag list.
    - `end_time` integer — End time in milliseconds.
    - `every_hour` integer — Popup interval hours.
    - `pop_time` integer — Popup count limit in interval.
    - `daily_limit` integer — Daily exposure limit.
    - `trace_id` string — Trace id to report with reportHomePopupEvent.
    - `request_id` string — Popup request id for client tracking. Same as trace_id.
    - `home_status` 0 | 1 — Home scene status: 0/1.
    - `foryou_status` 0 | 1 — ForYou scene status: 0/1.
    - `play_status` 0 | 1 — Player scene status: 0/1.
  - `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)