---
title: "获取帖子详情/Get post detail"
method: GET
path: "/api/v1/youtube/web_v2/get_post_detail"
tags: ["YouTube-Web-V2-API"]
---

# 获取帖子详情/Get post detail

`GET /api/v1/youtube/web_v2/get_post_detail`

## 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/youtube/web_v2/get_post_detail`
- Auth: HTTP bearer

# [中文]
### 用途:
- 获取YouTube帖子（社区帖子）的详细信息
- 包含帖子内容、附件、互动数据等

### 参数详解:

#### 必选参数:
**post_id** (string)
- **作用**: 帖子ID
- **获取方式**: 从帖子URL中提取，例如 `https://www.youtube.com/post/UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy`
- **示例**: `"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"`

#### 可选参数:
**language_code** (string, 可选) - 语言代码，默认 `"zh-CN"`

**country_code** (string, 可选) - 国家代码，默认 `"US"`

**need_format** (bool, 可选) - 是否格式化数据，默认 `true`

### 返回数据:
#### 当 need_format=true 时:
- post: 帖子详情
  - post_id: 帖子ID
  - post_url: 帖子URL
  - author_name: 作者名称
  - author_channel_id: 作者频道ID
  - author_url: 作者频道URL
  - author_thumbnails: 作者头像缩略图
  - content_text: 帖子文本内容
  - published_time: 发布时间（相对时间）
  - vote_count: 点赞数
  - comment_count: 评论数
  - attachment: 附件数据（图片/多图/视频/投票等，可能为null）
- channel_metadata: 频道元数据（名称、描述、URL等）
- comments_continuation_token: 评论分页token（可用于获取评论）

#### 当 need_format=false 时:
- 返回原始数据

### 注意事项:
- post_id 以 "Ugk" 开头
- 帖子附件支持: 图片、多图、视频、投票等类型

### 价格:
- $0.001 USD / 请求

# [English]
### Purpose:
- Get YouTube post (community post) detail information
- Includes post content, attachments, engagement data

### Parameters:

#### Required:
**post_id** (string)
- **Purpose**: Post ID
- **How to get**: Extract from post URL, e.g., `https://www.youtube.com/post/UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy`
- **Example**: `"UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"`

#### Optional:
**language_code** (string, optional) - Language code, default `"zh-CN"`

**country_code** (string, optional) - Country code, default `"US"`

**need_format** (bool, optional) - Whether to format data, default `true`

### Returns:
#### When need_format=true:
- post: Post detail
  - post_id: Post ID
  - post_url: Post URL
  - author_name: Author name
  - author_channel_id: Author channel ID
  - author_url: Author channel URL
  - author_thumbnails: Author avatar thumbnails
  - content_text: Post text content
  - published_time: Published time (relative)
  - vote_count: Like count
  - comment_count: Comment count
  - attachment: Attachment data (image/multi_image/video/poll, may be null)
- channel_metadata: Channel metadata (name, description, URL, etc.)
- comments_continuation_token: Comments pagination token

#### When need_format=false:
- Returns raw data

### Notes:
- post_id starts with "Ugk"
- Post attachments support: image, multi_image, video, poll types

### Price:
- $0.001 USD / request

### [示例/Example]
#### 获取帖子详情: post_id = "UgkxiCSRfD6g7SPlWGPDa3vbP7aIsytXRkvy"

## Query parameters

- `post_id` string, required: 帖子ID/Post ID
- `language_code` string: 语言代码（如zh-CN, en-US等）/Language code
- `country_code` string: 国家代码（如US, JP等）/Country code
- `need_format` boolean: 是否需要清洗数据，提取关键内容，移除冗余数据/Whether to clean and format the data

## 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`: 2 info
  - the `cache_message` response's property default value changed from `This request will be cached. You can access the cached result directly using the URL below, valid for 24 hours. Accessing the cache will not incur additional charges.` to `This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.` for the status `200`
  - the `cache_message_zh` response's property default value changed from `本次请求将被缓存，你可以使用下面的 URL 直接访问缓存结果，有效期为 24 小时，访问缓存不会产生额外费用。` to `本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。` for the status `200`
- **2026-04-14** `ee5b7c9c88f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tikhub/apis/tikhub-douyin-tiktok-xiaohongshu-lemon8-bilibili-kuaishou-pi/changes/api/v1/youtube/web_v2/get_post_detail/get.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)
