获取微博主页推荐时间轴/Get user recommend timeline

功能说明/Function Description

获取微博主页的推荐时间轴内容，基于用户的关注和兴趣展示个性化推荐的微博动态，支持分页加载。/Get recommended timeline content from Weibo homepage, displaying personalized recommended Weibo posts based on user's following and interests, supports pagination.

参数说明/Parameter Description

refresh (可选/Optional): 刷新类型/Refresh type

类型/Type: 整数/Integer

默认值/Default: 0

可选值/Options: 0 或 1/0 or 1

示例/Example: 0

说明/Description: 控制刷新行为的参数/Parameter to control refresh behavior

0: 正常刷新，获取常规推荐内容/Normal refresh, get regular recommended content

1: 强制刷新，获取最新的推荐内容/Force refresh, get latest recommended content

group_id (可选/Optional): 分组ID/Group ID

类型/Type: 字符串/String

默认值/Default: "102803"

示例/Example: "102803"

说明/Description: 推荐内容的分组标识，可通过 fetch_all_groups 接口获取/Group identifier for recommended content, can be obtained through fetch_all_groups API

containerid (可选/Optional): 容器ID/Container ID

类型/Type: 字符串/String

默认值/Default: "102803"

示例/Example: "102803"

说明/Description: 内容容器的标识符，通常与 group_id 相同/Content container identifier, usually same as group_id

extparam (可选/Optional): 扩展参数/Extended parameters

类型/Type: 字符串/String

默认值/Default: "discover|new_feed"

示例/Example: "discover|new_feed"

说明/Description: 扩展参数，控制内容发现和新内容展示/Extended parameters to control content discovery and new content display

max_id (可选/Optional): 最大ID/Max ID

类型/Type: 字符串/String

默认值/Default: "0"

示例/Example: "0"

说明/Description: 用于分页的最大ID标识/Max ID identifier for pagination

count (可选/Optional): 获取数量/Count

类型/Type: 整数/Integer

默认值/Default: 10

示例/Example: 10

说明/Description: 单次请求获取的推荐微博数量，建议范围5-20/Number of recommended posts per request, suggested range 5-20

分页机制/Pagination Mechanism

第一次请求/First request: max_id="0" count=10
后续请求/Subsequent requests:   max_id="{上次返回的最大ID/Max ID from previous response}" count=10

返回数据结构/Return Data Structure

{
  "code": 200,
  "data": {
    "statuses": [
      {
        "推荐微博内容/Recommended content": "包含微博文本、图片、视频等/Contains post text, images, videos, etc.",
        "作者信息/Author info": "发布者的用户信息/Publisher's user information",
        "互动数据/Interaction data": "点赞、评论、转发数/Likes, comments, repost counts",
        "推荐理由/Recommendation reason": "推荐算法的理由说明/Algorithm reasoning explanation",
        "发布时间/Post time": "微博发布的时间戳/Post timestamp"
      }
    ],
    "since_id": "<不依赖于时间的分页标识/Time-independent pagination ID>",
    "max_id": "下一页的最大ID/Max ID for next page",
    "total_number": "总数量统计/Total count statistics"
  }
}

使用场景/Use Cases

获取个性化推荐的微博内容/Get personalized recommended Weibo content

实现推荐时间轴展示页面/Implement recommended timeline display page

基于用户兴趣的内容发现/Content discovery based on user interests

推荐内容的分页浏览/Paginated browsing of recommended content

与 fetch_all_groups 接口的配合使用/Combined Use with fetch_all_groups API

使用示例/Usage Examples

最佳实践/Best Practices

分组选择/Group selection: 先调用 fetch_all_groups 获取可用分组，再选择合适的分组ID/First call fetch_all_groups to get available groups, then select appropriate group ID

首次加载/Initial load: 使用默认参数获取最新推荐内容/Use default parameters to get latest recommended content

分页加载/Pagination: 使用返回的 max_id 和 count 进行下一页加载/Use returned max_id and count for next page loading

数量控制/Count control: 建议 count 设置在5-20之间，避免单次数据量过大/Recommend setting count between 5-20 to avoid excessive data per request

刷新策略/Refresh strategy:

正常情况使用 refresh=0 获取常规推荐内容/Use refresh=0 for regular recommended content under normal circumstances

需要最新内容时使用 refresh=1 强制刷新/Use refresh=1 for force refresh when latest content is needed

缓存策略/Caching strategy: 可以对推荐数据进行适当缓存，提升响应速度/Can properly cache recommended data to improve response speed

刷新频率/Refresh frequency: 推荐内容更新较频繁，建议间隔1-3分钟刷新/Recommended content updates frequently, suggest refreshing every 1-3 minutes

注意事项/Important Notes

推荐内容基于用户的关注和兴趣算法/Recommended content based on user following and interest algorithms

内容会根据用户行为和偏好动态调整/Content dynamically adjusts based on user behavior and preferences

所有参数都有合理的默认值，可根据需要调整/All parameters have reasonable defaults, can be adjusted as needed

返回的微博包含关注用户和推荐用户的内容/Returned posts include content from followed and recommended users

建议合理控制请求频率/Recommend reasonable request frequency control

性能优化建议/Performance Optimization Suggestions

合理设置 count 参数，避免单次请求数据量过大/Reasonably set count parameter to avoid excessive data per request

利用 max_id 和 count 进行高效的分页加载/Use max_id and count for efficient pagination

对推荐数据进行本地缓存和去重处理/Perform local caching and deduplication of recommended data

根据用户活跃度调整刷新频率/Adjust refresh frequency based on user activity

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Successful Response

Body

Example

{
    "code": 200,
    "request_id": "string",
    "message": "Request successful. This request will incur a charge.",
    "message_zh": "请求成功，本次请求将被计费。",
    "support": "Discord: https://discord.gg/aMEAS8Xsvz",
    "time": "2025-09-16 03:14:36",
    "time_stamp": 1758017676,
    "time_zone": "America/Los_Angeles",
    "docs": "string",
    "router": "",
    "params": {},
    "data": null
}

🟠422Parameter Error

获取微博主页推荐时间轴/Get user recommend timeline

获取微博主页推荐时间轴/Get Weibo homepage recommend timeline#

功能说明/Function Description#

参数说明/Parameter Description#

分页机制/Pagination Mechanism#

返回数据结构/Return Data Structure#

使用场景/Use Cases#

与 fetch_all_groups 接口的配合使用/Combined Use with fetch_all_groups API#

使用示例/Usage Examples#

最佳实践/Best Practices#

注意事项/Important Notes#

性能优化建议/Performance Optimization Suggestions#

Request

Request Code Samples

Responses

获取微博主页推荐时间轴/Get Weibo homepage recommend timeline

功能说明/Function Description

参数说明/Parameter Description

分页机制/Pagination Mechanism

返回数据结构/Return Data Structure

使用场景/Use Cases

与 fetch_all_groups 接口的配合使用/Combined Use with fetch_all_groups API

使用示例/Usage Examples

最佳实践/Best Practices

注意事项/Important Notes

性能优化建议/Performance Optimization Suggestions