[中文]

用途:

• 搜索

参数:

• keyword: 搜索关键字
• search_type: 搜索类型，默认为Top，其他可选值为Latest，Media，People, Lists
• cursor: 游标，默认为None，用于翻页，后续从上一次请求的返回结果中获取

返回:

• 搜索结果

关于搜索结果准确性的说明:

• X 的搜索并不保证关键词或话题标签一定出现在推文正文（text 字段）中。
• 匹配范围远大于正文，还包括：被引用的推文、外链文章的元数据、媒体内容以及账号信号。
• 因此返回的推文完全可能是一条合法匹配，但关键词根本不在 text 字段里。
• 如果在结果上再做一次"正文必须包含关键词"的字面子串过滤，会丢弃掉很大一部分有效结果 （实测可达 94.6% 的丢弃率）。
• 若发现结果看起来"不准"，请优先检查是否在调用侧做了这类字面过滤。

[English]

Purpose:

• Search

Parameters:

• keyword: Search keyword
• search_type: Search type, default is Top, other optional values are Latest, Media, People, Lists
• cursor: Cursor, default is None, used for paging, obtained from the last request

Return:

• Search results

Note on search result accuracy:

• X's search does not guarantee the keyword or hashtag appears in the tweet text.
• Matching happens against more than the caption — it can include the quoted tweet, linked article metadata, media, and account signals.
• So a returned tweet can be a legitimate match with the term absent from the text field entirely.
• Requiring a literal substring match in text will discard a large share of valid results, which is consistent with the 94.6% drop rate observed in practice.
• If results look inaccurate, first check whether such a literal filter is being applied downstream.

[示例/Example]

keyword = "Elon Musk" search_type = "Top" cursor = None