运行谷歌自定义搜索API代码时出现KeyError: 'list'，求解决方法？

你遇到的KeyError: "list"是因为代码错误引用了谷歌Custom Search API返回结果中不存在的字段，核心问题和修复方案如下：

错误原因 #

谷歌自定义搜索API的响应JSON结构里，搜索结果列表存储在**items字段**中，而不是你代码里写的list。直接访问不存在的list键就会触发KeyError。

修正后的代码 #

import requests

API_KEY = "your_api_key"
SEARCH_ENGINE_ID = "Your_search_engine_id"
QUERY = "kaytontukihenkilo"

url = f"https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={QUERY}&cr=countryFI"

response = requests.get(url)
# 先验证请求是否成功
if response.status_code == 200:
    data = response.json()
    # 检查是否存在结果列表字段
    if "items" in data:
        results = data["items"]
        for result in results:
            print(result["title"])
            print(result["link"])
            print(result["snippet"])
            print()
    else:
        print("未获取到搜索结果")
else:
    print(f"API调用失败，状态码: {response.status_code}")
    # 打印错误详情帮助排查
    print(response.json())

额外排查点 #

• 确认API_KEY和SEARCH_ENGINE_ID配置正确，无拼写错误
• 检查谷歌云平台的Custom Search API配额是否耗尽（免费配额有限）
• 验证关键词kaytontukihenkilo在芬兰地区确实有可搜索结果

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