生成类目洞察资源

POST

/v1/marketInsights/category/resource

计费规则
本接口按资源生成次数计费。每成功生成 1 个类目洞察资源，计为 500 Credits 消耗。
○ 公式：Credit 消耗 = 生成成功的类目洞察资源数量 × 500
○ 示例：成功生成 1 个类目洞察资源，将消耗 500 Credits。

用于发起指定站点与类目的类目洞察资源生成任务。接口以异步方式返回 resourceId；请使用该 resourceId 调用“查询市场资源状态”接口获取生成进度。

使用说明：
○ categoryId 与 country 均为必填参数。
○ 本接口采用单任务串行生成机制：同一时刻仅允许一个类目洞察资源处于生成中。当前任务完成前，请勿重复发起新的资源生成请求。
○ 资源生成完成并返回 success 前，请勿使用该 resourceId 请求依赖类目洞察资源的后续接口。

请求参数

Header 参数

Body 参数application/json必填

示例

{
  "categoryId": "us_202605_87_akde91",
  "country": "US"
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://openapi.xydc.com/v1/marketInsights/category/resource' \
--header 'X-Auth-Version: 2.0' \
--header 'X-Api-Key: your_api_key' \
--header 'Content-Type: application/json' \
--data '{
  "categoryId": "us_202605_87_akde91",
  "country": "US"
}'

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
  "resourceId": "3cdd069d0jj1f754"
}

修改于 2026-07-28 09:27:19

资源生成

查询市场资源状态