如何获取YouTube API当前搜索词？Python脚本搜索结果与网页不一致

我之前也踩过这个坑，明明参数看起来都没问题，但API返回的结果和网页搜出来的就是对不上，咱们一步步来排查可能的原因：

1. 个性化推荐的差异 #

YouTube网页搜索会结合你的浏览历史、登录状态、地区、设备偏好做个性化推荐，但默认情况下，你用API调用时是匿名状态，不会带上这些用户上下文数据。API的order="relevance"排序逻辑只基于视频的公开元数据（标题、标签、描述），和网页的个性化排序肯定会有差异。

解决办法：

• 如果要贴近非登录状态的网页结果，添加regionCode参数（比如regionCode="US"或你所在地区的代码），指定搜索的地区范围
• 添加relevanceLanguage参数（比如relevanceLanguage="zh-CN"），匹配网页的语言偏好
• 如果需要完全匹配登录后的网页结果，得用OAuth2授权调用API，带上用户的访问令牌，这样API会结合用户的个性化数据返回结果

2. 网页默认筛选参数你没加 #

网页搜索默认会自动应用一些筛选规则，但API需要你手动指定这些参数，比如：

• 安全搜索：网页默认会过滤敏感内容，API需要添加safeSearch="moderate"或"strict"
• 时间范围：网页可能默认显示“最近一年”或“最近一个月”的结果，你代码里publishedAfter设为None，API会返回全时段的视频，可根据网页的时间范围设置这个参数（格式是ISO 8601，比如"2023-01-01T00:00:00Z"）
• 视频可嵌入性：网页优先显示可嵌入的视频，API可以添加videoEmbeddable="true"

3. API排序逻辑和网页不同步 #

YouTube的网页搜索算法会频繁更新，但API的relevance排序规则更新可能滞后，或者两者本身就采用不同的计算逻辑。你可以尝试切换order参数为"viewCount"或"date"，看看是否更贴近网页的某些排序选项，或者查看官方文档确认relevance的最新规则。

调整后的代码示例 #

给你补全一些关键参数后的代码，你可以根据自己的搜索场景调整：

def getVideo():
    parameters = {
        "part": "snippet",
        "maxResults": 5,
        "order": "relevance",
        "pageToken": "",
        "publishedAfter": "2023-01-01T00:00:00Z",  # 匹配网页的时间范围
        "publishedBefore": None,
        "q": "你的搜索关键词",
        "key": api_key,
        "type": "video",
        "regionCode": "CN",  # 你的地区代码
        "safeSearch": "moderate",
        "relevanceLanguage": "zh-CN",
        "videoEmbeddable": "true"
    }
    url = "https://www.googleapis.com/youtube/v3/search"
    # 这里添加你的请求逻辑，比如用requests.get(url, params=parameters)

最后小提示 #

如果还是不一致，建议打开网页搜索的“筛选”面板，把所有选中的条件（比如时长、类型、上传时间）都对应到API的参数里，这样匹配度会更高。另外，API的搜索结果也受配额限制，但这只会导致返回结果少，不会出现结果不一致的情况。

内容的提问来源于stack exchange，提问作者Cren1993