获取类目关键词列表

计费规则
本接口按实际返回的关键词数量计费。每返回 20 个关键词（向上取整）计为 1 Credit 消耗。
○ 公式：Credit 消耗 = ⌈返回的关键词数量 ÷ 20⌉
○ 示例：返回 50 个关键词，将消耗 3 Credits。

用于分页获取指定类目在指定自然月的关键词列表，支持关键词模糊搜索、相关性筛选和数值范围筛选，不支持品牌筛选。本接口只返回关键词当月数据，不返回每个关键词的月趋势；月度数据请调用“关键词ABA数据趋势（月）”。

使用说明：
○ 先调用 /v1/marketInsights/category/resource 生成类目洞察资源，再调用 /v1/marketInsights/category/resource/status，确认资源状态为 success。
○ country、resourceId、categoryId、month、filters、rangeFilters、page、pageSize、query 均为必填字段。
○ month 用于指定统计自然月，格式为 YYYY-MM，例如 2026-06。
○ 本接口仅支持按自然月查询，不支持近 30 天统计。
○ filters、rangeFilters 使用按筛选字段命名的对象结构；未使用的子字段传空数组，不搜索时 query 传空字符串。
○ filters 仅支持 correlationType，相关性值使用 high、medium、low。
○ rangeFilters 仅支持 searchVolume、searchFrequencyRank、costPerClick、adjustedClickConversionRate、searchTermCompetitiveDifficulty、organicRotationRate。
○ 每个范围使用 {min, max}，区间语义为 [min, max)：下限包含、上限不包含；不限制某一侧时传 null。
○ 列表项不包含 trends；需要趋势时，将列表中的 searchTerm 批量传给 /v1/searchTerms/abaReport/trends/monthly。

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

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "resourceId": "3cdd069d0jj1f754",
    "categoryId": "us_202605_87_akde91",
    "country": "US",
    "month": "2026-06",
    "filters": {
        "correlationType": [
            "high",
            "medium"
        ]
    },
    "rangeFilters": {
        "searchVolume": [
            {
                "min": 0,
                "max": 0
            }
        ],
        "searchFrequencyRank": [
            {
                "min": 0,
                "max": 0
            }
        ],
        "costPerClick": [
            {
                "min": "string",
                "max": "string"
            }
        ],
        "adjustedClickConversionRate": [
            {
                "min": "string",
                "max": "string"
            }
        ],
        "searchTermCompetitiveDifficulty": [
            {
                "min": 0,
                "max": 0
            }
        ],
        "organicRotationRate": [
            {
                "min": "string",
                "max": "string"
            }
        ]
    },
    "page": 1,
    "pageSize": 20,
    "query": "headphones"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

成功返回不含月趋势的类目关键词分页列表。

Bodyapplication/json

示例

{
    "list": [
        {
            "searchTerm": "wireless headphones",
            "searchFrequencyRank": 1250,
            "searchVolume": 28640,
            "categoryRelevance": "string",
            "categoryRelevantSearchVolume": 28640,
            "cpc": {
                "value": "string",
                "min": "string",
                "max": "string"
            },
            "adjustedClickConversionRate": "string",
            "searchTermCompetitiveDifficulty": 62,
            "organicRotationRate": "string",
            "correlationType": "high"
        }
    ],
    "total": 328,
    "page": 1,
    "pageSize": 20
}