​
API Description

Filter categories in depth by marketplace, date range, and multi-dimensional metrics.
Pass a single categoryId to obtain full-dimensional detailed metrics for that category. There is no separate “details” endpoint — filtering and details share the same API.

​
Request URL

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

​
Request Headers

ParametersParameter valueTypeDescription
Content-Typeapplication/jsonstringData format
AuthorizationBearer xxxstringAuthorization Token

​
Request Parameters

ParametersRequiredTypeDescription
marketplaceIdYesstringAmazon marketplace ID
timeRangeYesstringData aggregation time range
sampleScopeYesstringData sample scope
categoryIdNostringSpecify category ID to retrieve details (single record returned)
pageNointPage Number
sizeNointItems Per Page (Max 10 items per page)
sortFieldNostringSort field (supports any response field name)
sortOrderNostringSort order

​
Optional Filter — Numeric Range

Use *Min for the lower bound and *Max for the upper bound; omit to skip this filter.
Example: buyBoxPriceAvgMin: 5000

Filter PrefixTypeDescription
unitSoldSumintTotal Units Sold
glanceViewsSumintTotal Detail Page Views
searchVolumeSumintTotal Search Volume
netShippedGmsSumintTotal Gross Merchandise Sales (GMS)
buyBoxPriceAvgintAverage Buy Box Price
searchToPurchaseRatiointSearch-to-Purchase Conversion Rate
returnRatiointReturn Rate
asinCountintNumber of ASINs in Category
offersPerAsinintAverage Offers per ASIN
newAsinCountintNewly Entered ASIN Count
newBrandCountintNewly Entered Brand Count
avgAdSpendPerClickintAverage Ad Spend per Click

​
Optional Filter — Tier/Level

FieldAvailable ValuesDescription
buyBoxPriceTiersbudget, mainstream, premium, luxuryPrice Tier
searchToPurchaseRatioLevelsto_improve, average, excellentConversion Rate Quality
returnRatioLevelsexcellent, average, riskReturn Rate Quality
asinCountLevels<P25, P25-P50, P50-P75, >P75Competition Level (Quantile)
offersPerAsinLevels<P25, P25-P50, P50-P75, >P75Offer Density
newAsinCountLevels<P25, P25-P50, P50-P75, >P75New ASIN Entry
newBrandCountLevels<P25, P25-P50, P50-P75, >P75New Brand Entry
avgAdSpendPerClickLevels<P25, P25-P50, P50-P75, >P75Ad Cost Level

​
Optional Filter — Trend

Applicable metric prefixes: unitSold, glanceViews, searchVolume, netShippedGms.
Replace metric with the metric prefix.

Field PatternAvailable ValuesDescription
metricTrendDirectionsstrong_up, up, stable, down, strong_downTrend Direction
metricVolatilityLevelslow, medium, highTrend Stability
metricChangeRateBucketshigh_growth, medium_growth, low_growth, stable, low_decline, medium_decline, high_declineChange Rate
metricLastVsSelfAvgBucketsabove_baseline, around_baseline, below_baselineLatest Value vs Historical Average

​
Optional Filter — Quantile Bucket

FieldAvailable ValuesDescription
unitSoldQuantileBuckets<P25, P25-P50, P50-P75, >P75Sales Rank
glanceViewsQuantileBuckets<P25, P25-P50, P50-P75, >P75Views Rank
searchVolumeQuantileBuckets<P25, P25-P50, P50-P75, >P75Search Volume Rank
netShippedGmsQuantileBuckets<P25, P25-P50, P50-P75, >P75GMS Rank

​
Response value

Return valueTypeDescription
codeintStatus Code
messagestringMessage
dataobjectReturned data

​
Request example

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
}'

​
Return example

{
  "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
    }
  }
}

​
Credit Consumption

  • Average response time: 10s
  • Credit Consumption: 5.0 Credits/Per Request