Google Custom Search API的gl参数失效，如何获取地域针对性搜索结果？

目标 #

希望根据用户输入获取特定国家（如尼日利亚、泰国、美国等）的定制化搜索结果，因此在API请求中使用gl参数指定地域。

请求配置示例 #

我的API请求示例如下：

https://www.googleapis.com/customsearch/v1
  ?key=MyAPIKey
  &cx=MySearchEngineID
  &hl=en
  &q=writing agency
  &gl=ng
  &num=10
  &start=1

观察结果 #

• gl参数已正确附加到API请求中；
• 即使指定gl=ng（尼日利亚），结果未体现地域针对性排名；
• 未使用gl参数时，API正常返回全球搜索结果；
• 请求URL和参数记录正确，API响应无错误。

已尝试操作 #

• 复查API文档确认gl参数支持地域化结果；
• 测试不同地域代码（如gl=us），结果仍为全球范围；
• 确认key、cx等参数有效可用；
• 标准化URL并与目标对比确保准确性。

核心问题 #

搜索结果未按指定地域排序，针对已知在尼日利亚应有效查询的目标URL始终显示“无排名”，但手动在Google搜索时，该URL在相同关键词和地域下排名首页。

疑问 #

1. gl参数为何未按预期影响搜索结果？
2. Google Custom Search API是否存在相关限制或细节？
3. 是否需添加其他参数以实现地域化结果？

构建API请求的代码片段 #

try {
    while (currentPage <= maxPages) {
      console.log(`Querying page ${currentPage}, startIndex: ${startIndex}`);

      // Construct the API request URL
      const params = {
        key: process.env.GOOGLE_API_KEY,
        cx: process.env.SEARCH_ENGINE_ID,
        hl: "en", // Language
        q: keyword, // Search query
        gl: validatedCountry, // Geolocation
        num: 10, // Results per page
        start: startIndex, // Start index
      };

      const apiUrl = `https://www.googleapis.com/customsearch/v1?${qs.stringify(params)}`;
      console.log("Constructed API Request URL:", apiUrl);

      const response = await axios.get(apiUrl);
      console.log("API Response Request:", response.data.queries.request[0]);
      const searchResults = response.data.items || [];

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