获取类目关键词搜索量趋势

计费规则
本接口按时间范围计费。每处理 6 个月（向上取整）计为 5 Credits 消耗。
○ 公式：Credit 消耗 = ⌈月数 ÷ 6⌉ × 5
○ 示例：请求查询 24 个月的类目关键词搜索量趋势，将消耗 20 Credits。

用于获取指定类目下某一相关性等级关键词在指定月份范围内的月度搜索量趋势，返回每月汇总搜索量、关键词数量以及对应的环比和同比数据。

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用 /v1/marketInsights/category/resource/status，确认资源状态为 success。
○ country、resourceId、categoryId、correlationType、startMonth 为必填字段；endMonth 为可选字段。
○ startMonth 和 endMonth 格式均为 YYYY-MM；endMonth 不传或为空时默认查询至最新可用月份的数据，传入时不能早于 startMonth。查询范围包含开始月份和结束月份。
○ correlationType 支持 high（高相关）、medium（中相关）、low（低相关）。
○ 返回数据按自然月统计，localDate 格式为 YYYY-MM。
○ mom 表示与上一个自然月比较，yoy 表示与上一年同月比较。
○ 对比基期不存在时，previous、amount、rate 返回 null；基期为 0 时增长率可能返回 Infinity 或 -Infinity。

可用日期： 调用 GET /v1/foundation/marketInsights/availableDates?country={country}，传入与当前请求相同的国家；从 SearchTermsInfo 的 monthly 记录获取可查询月份范围，endMonth 为空时查询至最新可用月份。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功返回类目关键词月度搜索量趋势。

Bodyapplication/json

示例

{
    "trends": [
        {
            "date": "2026-06",
            "searchVolume": {
                "value": 28640,
                "mom": {
                    "previous": 25400,
                    "amount": 3240,
                    "rate": "0.1250"
                },
                "yoy": {
                    "previous": 25400,
                    "amount": 3240,
                    "rate": "0.1250"
                }
            },
            "searchTermCount": {
                "value": 520,
                "mom": {
                    "previous": 480,
                    "amount": 40,
                    "rate": "0.1250"
                },
                "yoy": {
                    "previous": 480,
                    "amount": 40,
                    "rate": "0.1250"
                }
            }
        }
    ]
}

获取类目关键词搜索量趋势

请求参数

请求示例代码

返回响应