获取类目关键词分析

计费规则
本接口按次数计费。每处理 1 个类目计为 5 Credits 消耗。
○ 公式：Credit 消耗 = 5
○ 示例：请求包含 1 个类目，将消耗 5 Credits。

用于获取指定类目在指定自然月、指定关键词相关性等级下的关键词分析汇总详情，包括 CPC、点击转化率、竞争难度、自然滚动率、关键词集中度及关键词排名层级分布。

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用 /v1/marketInsights/category/resource/status，确认资源状态为 success。
○ country、resourceId、categoryId、month、correlationType 均为必填字段。
○ month 用于指定统计自然月，格式为 YYYY-MM，例如 2026-06。
○ correlationType 用于筛选关键词相关性等级，支持高相关、中相关和低相关。
○ 本接口仅支持按自然月查询，不支持近 30 天统计。
○ CR10、CR50、80% 流量所需词数 和核心词占比的环比数据与上一个自然月比较。
○ 汇总指标无数据时返回 null。

可用日期： 调用 GET /v1/foundation/marketInsights/availableDates?country={country}，传入与当前请求相同的国家；从 SearchTermsInfo 的 monthly 记录获取可查询月份范围，month 必须在该范围内，格式为 YYYY-MM。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功返回类目关键词分析汇总详情。

Bodyapplication/json

示例

{
    "summary": {
        "avgCpc": {
            "value": "string",
            "min": "string",
            "max": "string"
        },
        "avgCvr": {
            "value": "string",
            "min": "string",
            "max": "string"
        },
        "avgSearchTermCompetitiveDifficulty": {
            "value": 0,
            "min": 0,
            "max": 0
        },
        "avgOrganicRotationRate": {
            "value": "string",
            "min": "string",
            "max": "string"
        },
        "cr10": {
            "value": "string",
            "mom": {
                "previous": "string",
                "amount": "string",
                "rate": "string"
            }
        },
        "cr50": {
            "value": "string",
            "mom": {
                "previous": "string",
                "amount": "string",
                "rate": "string"
            }
        },
        "k80": {
            "value": 0,
            "mom": {
                "previous": 0,
                "amount": 0,
                "rate": "string"
            }
        },
        "k80N": {
            "value": "string",
            "mom": {
                "previous": "string",
                "amount": "string",
                "rate": "string"
            }
        }
    },
    "distribution": [
        {
            "searchVolume": [
                {
                    "tier": "head",
                    "value": 0,
                    "ratio": "string"
                }
            ],
            "searchTermCount": [
                {
                    "tier": "head",
                    "value": 0,
                    "ratio": "string"
                }
            ]
        }
    ]
}

获取类目关键词分析

请求参数

请求示例代码

返回响应