​
接口说明

按站点、时间范围及多维指标深度筛选类目。
传入单个 categoryId 即可获取该类目的全维度详尽指标。没有单独的”详情”端点——筛选和详情共用同一接口。

​
请求URL

POST https://scrapeapi.pangolinfo.com/api/v1/amzscope/categories/filter

​
请求头

参数名参数值类型说明
Content-Typeapplication/jsonstring数据格式
AuthorizationBearer xxxstring认证凭证

​
请求参数

参数必填类型说明
marketplaceIdYesstringAmazon 站点 ID
timeRangeYesstring数据聚合时间范围
sampleScopeYesstring数据样本范围
categoryIdNostring指定类目 ID 获取详情（返回单条）
pageNoint页码
sizeNoint每页条数（每页最多10条）
sortFieldNostring排序字段（支持任意响应字段名）
sortOrderNostring排序顺序

​
可选筛选器 — 数值范围

设置 *Min 表示下限，*Max 表示上限，省略则跳过该筛选。
示例：buyBoxPriceAvgMin: 5000

筛选器前缀类型说明
unitSoldSumint总销量
glanceViewsSumint总详情页浏览量
searchVolumeSumint总搜索量
netShippedGmsSumint总商品销售总额 (GMS)
buyBoxPriceAvgint平均黄金购物车价格
searchToPurchaseRatioint搜索到购买转化率
returnRatioint退货率
asinCountint类目中的 ASIN 数
offersPerAsinint每个 ASIN 的平均报价数
newAsinCountint新进入的 ASIN 数
newBrandCountint新进入的品牌数
avgAdSpendPerClickint平均每次点击广告支出

​
可选筛选器 — 档位/级别

字段可选值说明
buyBoxPriceTiersbudget, mainstream, premium, luxury价格档位
searchToPurchaseRatioLevelsto_improve, average, excellent转化率质量
returnRatioLevelsexcellent, average, risk退货率质量
asinCountLevels<P25, P25-P50, P50-P75, >P75竞争程度（分位数）
offersPerAsinLevels<P25, P25-P50, P50-P75, >P75报价密度
newAsinCountLevels<P25, P25-P50, P50-P75, >P75新品进入
newBrandCountLevels<P25, P25-P50, P50-P75, >P75新品牌进入
avgAdSpendPerClickLevels<P25, P25-P50, P50-P75, >P75广告成本级别

​
可选筛选器 — 趋势

适用指标前缀：unitSold, glanceViews, searchVolume, netShippedGms。将 metric 替换为指标前缀。

字段模式可选值说明
metricTrendDirectionsstrong_up, up, stable, down, strong_down趋势方向
metricVolatilityLevelslow, medium, high趋势稳定性
metricChangeRateBucketshigh_growth, medium_growth, low_growth, stable, low_decline, medium_decline, high_decline变化速率
metricLastVsSelfAvgBucketsabove_baseline, around_baseline, below_baseline最新值 vs 历史均值

​
可选筛选器 — 分位数桶

字段可选值说明
unitSoldQuantileBuckets<P25, P25-P50, P50-P75, >P75销量排名
glanceViewsQuantileBuckets<P25, P25-P50, P50-P75, >P75浏览量排名
searchVolumeQuantileBuckets<P25, P25-P50, P50-P75, >P75搜索量排名
netShippedGmsQuantileBuckets<P25, P25-P50, P50-P75, >P75GMS 排名

​
响应值

返回值类型说明
codeint状态码
messagestring信息
dataobject返回数据

​
请求示例

curl --request POST \
  --url https://scrapeapi.pangolinfo.com/api/v1/amzscope/categories/filter \
  --header 'Authorization: ' \
  --header 'Content-Type: application/json' \
  --data '{
  "marketplaceId": "US",
  "timeRange": "l7d",
  "sampleScope": "all_asin",
  "categoryId": "979832011",
  "page": 1,
  "size": 10
}'

​
返回示例

{
  "code":0,
  "message":"ok",
  "data":{
    "items":{
      "data":[{"id":220839,"categoryId":"979832011","marketplaceId":"US","timeRange":"l7d","sampleScope":"all_asin","snapshotDate":"2026-02-08","unitSoldSum":322.0,"glanceViewsSum":4499.0,"searchVolumeSum":7623.0,"clickCountSum":929.0,"netShippedGmsSum":16440.0,"unitSoldPeriodCount":8,"glanceViewsPeriodCount":7,"searchVolumePeriodCount":6,"clickCountPeriodCount":6,"netShippedGmsPeriodCount":8,"buyBoxPriceAvg":null,"buyBoxPriceTier":"premium","searchToPurchaseRatio":0.0083,"returnRatio":0.055901,"searchToPurchaseRatioLevel":"average","returnRatioLevel":"average","asinCount":104.0,"offersPerAsin":1.0,"newAsinCount":0.0,"newBrandCount":0.0,"avgAdSpendPerClick":0.0,"medianAdSpendPerClick":0.0,"asinCountLevel":"<P25","offersPerAsinLevel":"<P25","newAsinCountLevel":"<P25","newBrandCountLevel":"<P25","avgAdSpendPerClickLevel":"<P25","medianAdSpendPerClickLevel":"<P25","maxKeywordSearchVolume":1376,"unitSoldQuantileBucket":"P25-P50","glanceViewsQuantileBucket":"P25-P50","searchVolumeQuantileBucket":"P25-P50","clickCountQuantileBucket":"P25-P50","netShippedGmsQuantileBucket":"P25-P50","unitSoldTrendDirection":"strong_down","unitSoldVolatilityLevel":"high","unitSoldChangeRateBucket":"medium_decline","unitSoldSelfAvg":40.25,"unitSoldLastVsSelfAvgPct":-0.3291925466,"unitSoldLastVsSelfAvgBucket":"below_baseline","glanceViewsTrendDirection":"down","glanceViewsVolatilityLevel":"medium","glanceViewsChangeRateBucket":"low_decline","glanceViewsSelfAvg":642.7142857143,"glanceViewsLastVsSelfAvgPct":-0.0913536341,"glanceViewsLastVsSelfAvgBucket":"around_baseline","searchVolumeTrendDirection":"down","searchVolumeVolatilityLevel":"high","searchVolumeChangeRateBucket":"medium_decline","searchVolumeSelfAvg":1270.5,"searchVolumeLastVsSelfAvgPct":-0.3065722157,"searchVolumeLastVsSelfAvgBucket":"below_baseline","clickCountTrendDirection":"down","clickCountVolatilityLevel":"high","clickCountChangeRateBucket":"low_decline","clickCountSelfAvg":154.8333333333,"clickCountLastVsSelfAvgPct":-0.1087190527,"clickCountLastVsSelfAvgBucket":"below_baseline","netShippedGmsTrendDirection":"strong_down","netShippedGmsVolatilityLevel":"high","netShippedGmsChangeRateBucket":"medium_decline","netShippedGmsSelfAvg":2055.0,"netShippedGmsLastVsSelfAvgPct":-0.4744525547,"netShippedGmsLastVsSelfAvgBucket":"below_baseline","buyBoxPriceTrendDirection":null,"buyBoxPriceVolatilityLevel":null,"buyBoxPriceChangeRateBucket":null,"buyBoxPriceSelfAvg":null,"buyBoxPriceLastVsSelfAvgPct":null,"buyBoxPriceLastVsSelfAvgBucket":null}],
      "total":1,
      "page":1,
      "size":10,
      "totalPages":1
    }
  }
}

​
积点消耗说明

  • 平均响应时间：10s
  • 积点消耗：5个/次