跳转到主要内容
POST
分析亚马逊研究证据
不创建 Run、不调用 Provider。来源 token 按当前 Workspace 和 Key policy 检查。价格采用单一序列的时间加权基线,明确缺口、阈值和定义变更。成本是调用方假设,未知不补零。评论计数仅代表去重样本。机会评分是分析者判断,须通过可比历史序列等证据门槛;已有数据费用由 source_charge_usd 单列。

请求体

application/json
analysis
enum<string>
必填
可用选项:
price_history
token
string
必填
Required string length: 1 - 16384
price_type
enum<string>
必填
可用选项:
AMAZON,
NEW,
LISTPRICE
from_at
string<date-time> | null

ISO 8601 UTC 时间戳。

to_at
string<date-time> | null

ISO 8601 UTC 时间戳。

minimum_change_percent
string | null

精确非负百分比数值(15.00 表示 15%),小数位 2 至 6 位。

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
minimum_change_amount
string | null

指定币种的精确非负十进制金额,小数位 2 至 6 位,不换汇。

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
group_tolerance_amount
string | null

指定币种的精确非负十进制金额,小数位 2 至 6 位,不换汇。

Maximum string length: 24
Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
minimum_available_hours
integer | null
必填范围: x >= 1
unavailable_break_hours
integer | null
必填范围: x >= 1

响应

亚马逊分析结果

analysis
enum<string>
必填
可用选项:
price_history,
economics,
reviews,
opportunity
result_status
enum<string>
必填
可用选项:
success,
no_result,
pending,
error
output
object
必填
charge_usd
enum<string>
必填
可用选项:
0.00
source_charge_usd
string | null
必填

精确的美元十进制字符串,小数位数为 2–6,采用唯一规范格式。求和时使用十进制运算或乘以 10^6 转为整数,不使用浮点数。

Pattern: ^(0|[1-9]\d*)\.(\d{2}|\d{2}\d{0,3}[1-9])$
runs
object[]
必填
source_result_urls
string[]
必填
error
object | null
必填
request_charge
object

当前请求的受理与费用证据。在同一件用户工作中保存 created_run_ids,每个已结算 Run 只计一次费用。更换 task_id 不会把幂等重放变成新 Run。读取结果的费用为零,受理列表为空。