Google Trends 自动补全

Google Trends 自动补全接口，返回趋势相关的查询建议。

本页给出 Google Trends 自动补全的字段定义、参数分组、必填约束以及可用过滤参数。

元数据

字段	值
引擎名称	Google Trends 自动补全
原始名称	Google Trends Autocomplete
内部标识（scraper）	`google_trends_autocomplete`
接口标识（engine）	`google_trends_autocomplete`
网站	Google
网站地址	trends.google.com
输出格式	`json`
版本	`1.0.0`
参数数量	`2`
参数分组	搜索词 (1), 地区与语言 (1)

请求示例

下面的请求体是本次文档更新时实际用于验证 google_trends_autocomplete 的请求。对于 /v1/serp，engine 字段应传当前引擎的 scraper 值。

curl -X POST "https://run.xcrawl.com/v1/serp" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"engine":"google_trends_autocomplete","q":"open"}'

响应示例

下面的 JSON 片段来自同一次真实响应。为了避免页面被超长字段淹没，超长字符串、data URL 和大型数组做了裁剪。

{
  "search_metadata": {
    "cached": true,
    "created_at": "2026-03-26 08:21:02 UTC",
    "id": "01KMMKQ25KTN2N1DENSSGPYJ9M",
    "json_endpoint": "https://serp.xcrawl.com/01KMMKQ25KTN2N1DENSSGPYJ9M.json",
    "processed_at": "2026-03-26 08:21:02 UTC",
    "raw_html_file": "https://serp.xcrawl.com/01KMMKQ25KTN2N1DENSSGPYJ9M.html",
    "status": "completed",
    "total_time_taken": 2
  },
  "search_parameters": {
    "engine": "google_trends_autocomplete",
    "q": "open"
  },
  "total_credits_used": 1,
  "suggestions": [
    {
      "link": "https://trends.google.com/trends/explore?q=/g/11bxc656v6",
      "q": "/g/11bxc656v6",
      "title": "OpenAI",
      "type": "Artificial intelligence company"
    },
    {
      "_note": "4 more items omitted"
    }
  ]
}