如何使用Google Custom Search API获取指定关键词的首张谷歌图片URL

问题排查&修复步骤 #

• 第一步：确认你创建的Google Custom Search Engine（CSE）已开启「图片搜索」权限，该开关位于CSE管理面板的基础设置栏，未开启时即使携带searchType=image参数也不会返回图片资源。
• 第二步：优化请求参数，新增num=1控制只返回1条结果（匹配你取首张图的需求，节省API配额），可新增fields=items(link)参数过滤冗余返回字段，修改后的请求如下：
  https://www.googleapis.com/customsearch/v1?key=AIzaSyCRNQbDeEcMTlakA8aJeFoFj9Ci9ZQTvsw&cx=017576662512468239146:omuauf_lfve&q=tomatoes&searchType=image&num=1&fields=items(link)
• 第三步：正常返回结果中，items数组下第一个元素的link字段即为目标图片的原始URL，典型返回结构参考：

{
  "items": [
    {
      "link": "https://upload.wikimedia.org/wikipedia/commons/8/89/Tomato_je.jpg"
    }
  ]
}

常见异常排查 #

• 检查API密钥的调用配额是否耗尽，Google Custom Search API免费额度为每日100次查询，超出后会返回错误响应，无正常结果数据
• 确认cx参数对应的搜索引擎ID填写正确，ID填写错误会导致返回结果与预期不符

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