---
title: "生成视频号作品分享链接/Generate WeChat Channels Video Share URL"
method: POST
path: "/api/v1/wechat_channels/v2/fetch_video_share_url"
tags: ["WeChat-Channels-V2-API"]
---

# 生成视频号作品分享链接/Generate WeChat Channels Video Share URL

`POST /api/v1/wechat_channels/v2/fetch_video_share_url`

## Request

- Base URL: `https://api.tikhub.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.tikhub.io/api/v1/wechat_channels/v2/fetch_video_share_url`
- Auth: HTTP bearer

# [中文]
### 用途:
- 给定作品 `object_id`，返回一条可对外分享的 `weixin.qq.com/sph/…` 短链（与 `fetch_video_detail` 的 `share_url` 入参互为反向）。
- 价格：0.01$/次
- ⏱️ 由于微信服务器原因，本接口响应较慢，请将客户端请求超时（timeout）设置为 30 秒；timeout 设置过小会造成已扣费但收不到响应的情况。
### 参数:
- object_id: 作品 objectId（纯数字），示例 `14941130915890399732`。来自 `fetch_user_videos` / `fetch_video_detail` 的视频 `id`。
- raw: 可选，默认 True。True=原始响应；False=精简解析结构。
### 返回:
- 作品分享短链

### 响应结构与 JSON Path:
#### `raw=false`（精简）:
- 入参回显: `$.data.object_id`
- 生成的分享短链（可直接喂 `fetch_video_detail` 的 `share_url`）: `$.data.share_url`
#### `raw=true`（原始）:
- 状态码: `$.data.baseResponse.ret`
- 分享短链: `$.data.feedH5Url`
- 列表形式（批量时逐项）: `$.data.urlList[N].feedH5Url` / `$.data.urlList[N].objectId`
- 对应关系: raw=false 的 `share_url` 取自 raw=true 的 `feedH5Url`（或 `urlList[0].feedH5Url`），`object_id` 即入参回显。

# [English]
### Purpose:
- Given a video `object_id`, return a shareable `weixin.qq.com/sph/…` short link (the inverse of the `share_url` input of `fetch_video_detail`).
- Price: $0.01 per request
- ⏱️ Due to WeChat server latency, this endpoint responds slowly; please set your client request timeout to 30 seconds — a timeout that is too small may result in being billed without receiving the response.
### Parameters:
- object_id: Video objectId (numeric), e.g. `14941130915890399732`. From the video `id` of `fetch_user_videos` / `fetch_video_detail`.
- raw: Optional, default True. True=raw response; False=simplified parsed structure.
### Return:
- Video share short link

### Response structure & JSON Path:
#### `raw=false` (simplified):
- Input echo: `$.data.object_id`
- Generated share link (feed directly into `share_url` of `fetch_video_detail`): `$.data.share_url`
#### `raw=true` (raw):
- Status code: `$.data.baseResponse.ret`
- Share link: `$.data.feedH5Url`
- List form (per item when batched): `$.data.urlList[N].feedH5Url` / `$.data.urlList[N].objectId`
- Mapping: `share_url` of raw=false comes from `feedH5Url` (or `urlList[0].feedH5Url`) of raw=true; `object_id` is the input echo.

## Request body

- FetchVideoShareUrlRequest
  - `object_id` string, required: 作品 objectId（纯数字）/Video objectId (numeric)
  - `raw` boolean: True=原始响应；False=精简解析结构/True=raw response; False=simplified parsed structure

## Response `200`

Successful Response

- ResponseModel
  - `code` integer: HTTP status code | HTTP状态码
  - `request_id` string, nullable: Unique request identifier | 唯一请求标识符
  - `message` string: Response message (EN-US) | 响应消息 (English)
  - `message_zh` string: Response message (ZH-CN) | 响应消息 (中文)
  - `support` string: Support message | 支持消息
  - `time` string: The time the response was generated | 生成响应的时间
  - `time_stamp` integer: The timestamp the response was generated | 生成响应的时间戳
  - `time_zone` string: The timezone of the response time | 响应时间的时区
  - `docs` string, nullable: Link to the API Swagger documentation for this endpoint | 此端点的 API Swagger 文档链接
  - `cache_message` string, nullable: Cache message (EN-US) | 缓存消息 (English)
  - `cache_message_zh` string, nullable: Cache message (ZH-CN) | 缓存消息 (中文)
  - `cache_url` string, nullable: The URL to access the cached result | 访问缓存结果的 URL
  - `router` string: The endpoint that generated this response | 生成此响应的端点
  - `params` unknown
  - `data` unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-08** `96a122a5f220`: 2 info
  - added the optional property `detail/items/ctx` to the response with the `422` status
  - added the optional property `detail/items/input` to the response with the `422` status
- **2026-09-01** `50f9ec6e1cd3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/wechat_channels/v2/fetch_video_share_url/post.md)

---

[API](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi.md) - [All operations](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/llms.txt) - [OpenAPI document](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/revisions/86a3483c705a?raw)