Explore our Marketplace to buy and sell APIs, services, and social media solutions. Connect with a vibrant community of developers, businesses, and creators!

搜索用户微博/Search user posts

GET

https://api.tikhub.io/api/v1/weibo/web_v2/search_user_posts

Weibo-Web-V2-API

Last modified:2025-09-16 22:31:04

OperationId:search_user_posts_api_v1_weibo_web_v2_search_user_posts_get

搜索用户微博/Search user posts

功能说明/Function Description

在指定用户的微博中搜索包含特定关键词的微博内容，支持多种过滤条件和时间范围限制。/Search for Weibo content containing specific keywords in a specified user's posts, supporting various filtering conditions and time range restrictions.

参数说明/Parameter Description

uid (必填/Required): 微博用户ID/Weibo user ID

类型/Type: 字符串/String

示例/Example: "7277477906"

说明/Description: 要搜索微博的目标用户ID/Target user ID to search posts from

q (必填/Required): 搜索关键词/Search keyword

类型/Type: 字符串/String

示例/Example: "python"

说明/Description: 要在微博内容中搜索的关键词/Keywords to search in Weibo content

支持/Supports: 中文、英文、数字、特殊字符/Chinese, English, numbers, special characters

page (可选/Optional): 页码/Page number

类型/Type: 整数/Integer

默认值/Default: 1

示例/Example: 1

说明/Description: 用于分页获取搜索结果/Used for paginated search results

starttime (可选/Optional): 开始时间戳/Start timestamp

类型/Type: 整数（Unix时间戳）/Integer (Unix timestamp)

默认值/Default: None

示例/Example: 1640995200 (2022-01-01 00:00:00)

说明/Description: 搜索此时间之后发布的微博/Search posts published after this time

endtime (可选/Optional): 结束时间戳/End timestamp

类型/Type: 整数（Unix时间戳）/Integer (Unix timestamp)

默认值/Default: None

示例/Example: 1672531199 (2022-12-31 23:59:59)

说明/Description: 搜索此时间之前发布的微博/Search posts published before this time

内容类型过滤参数 ⚙️/Content Type Filter Parameters ⚙️

以下参数用于控制搜索结果中包含的微博类型，所有参数默认为1（包含）：/The following parameters control the types of Weibo posts included in search results, all default to 1 (include):

hasori (可选/Optional): 是否包含原创微博/Whether to include original posts

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含原创/Include original, 0=排除原创/Exclude original

说明/Description: 控制是否搜索用户自己发布的原创内容/Control whether to search original content posted by the user

hasret (可选/Optional): 是否包含转发微博/Whether to include retweets

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含转发/Include retweets, 0=排除转发/Exclude retweets

说明/Description: 控制是否搜索用户转发的微博/Control whether to search posts retweeted by the user

hastext (可选/Optional): 是否包含文字微博/Whether to include text posts

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含文字/Include text, 0=排除文字/Exclude text

说明/Description: 控制是否搜索纯文字类型的微博/Control whether to search text-only posts

haspic (可选/Optional): 是否包含图片微博/Whether to include image posts

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含图片/Include images, 0=排除图片/Exclude images

说明/Description: 控制是否搜索包含图片的微博/Control whether to search posts containing images

hasvideo (可选/Optional): 是否包含视频微博/Whether to include video posts

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含视频/Include videos, 0=排除视频/Exclude videos

说明/Description: 控制是否搜索包含视频的微博/Control whether to search posts containing videos

hasmusic (可选/Optional): 是否包含音乐微博/Whether to include music posts

类型/Type: 整数 (0或1)/Integer (0 or 1)

默认值/Default: 1

选项/Options: 1=包含音乐/Include music, 0=排除音乐/Exclude music

说明/Description: 控制是否搜索包含音乐的微博/Control whether to search posts containing music

搜索策略示例 🎯/Search Strategy Examples 🎯

时间参数使用说明 📅/Time Parameter Usage 📅

返回数据结构/Return Data Structure

{
  "code": 200,
  "data": {
    "list": [
      {
        "微博ID": "string",
        "微博内容": "string",
        "发布时间": "string",
        "微博类型": "string",
        "媒体文件": [],
        "互动数据": {
          "转发数": "number",
          "评论数": "number",
          "点赞数": "number"
        }
      }
    ],
    "total_count": "搜索结果总数",
    "next_page": "下一页标识"
  }
}

使用场景 🚀/Use Cases 🚀

内容分析/Content analysis: 分析用户在特定话题上的观点和态度/Analyze user opinions and attitudes on specific topics

趋势追踪/Trend tracking: 追踪用户对某个事件的关注程度/Track user attention to specific events

内容挖掘/Content mining: 挖掘用户的兴趣点和专业领域/Mine user interests and professional areas

时间分析/Time analysis: 分析用户在不同时期对同一话题的看法变化/Analyze changes in user opinions on the same topic over time

媒体偏好/Media preferences: 了解用户偏好的内容形式（文字/图片/视频）/Understand user preferred content formats (text/images/videos)

最佳实践建议 💡/Best Practice Recommendations 💡

关键词选择/Keyword selection: 使用具体且相关的关键词，避免过于宽泛/Use specific and relevant keywords, avoid being too broad

时间范围/Time range: 合理设置时间范围，避免搜索跨度过大/Set reasonable time ranges, avoid overly large search spans

类型过滤/Type filtering: 根据需求精确控制内容类型，提高结果质量/Precisely control content types based on needs to improve result quality

分页处理/Pagination handling: 合理控制分页，避免一次获取过多数据/Properly control pagination, avoid getting too much data at once

结果缓存/Result caching: 对相同搜索条件的结果进行适当缓存/Appropriately cache results for the same search conditions

注意事项 ⚠️/Notes ⚠️

搜索结果受用户隐私设置影响/Search results are affected by user privacy settings

关键词搜索区分大小写/Keyword search is case-sensitive

时间戳参数需要使用Unix时间戳格式/Timestamp parameters need to use Unix timestamp format

过滤参数组合可能影响搜索结果数量/Filter parameter combinations may affect the number of search results

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

or

Query Params

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request GET 'https://api.tikhub.io/api/v1/weibo/web_v2/search_user_posts?uid=7277477906&q=python&page=1&starttime&endtime&hasori=1&hasret=1&hastext=1&haspic=1&hasvideo=1&hasmusic=1' \
--header 'Authorization: Bearer <token>'

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

Modified at 2025-09-16 22:31:04

获取微博子评论/Get Weibo sub-comments

获取用户微博视频收藏夹列表/Get user video collection list