​
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.

🤖 Pulling this data to power an AI Agent? Instead of writing custom parsing code, leverage our MCP Server to grant your AI workspace native, real-time access with zero integration friction.

​
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. Available value: US (United States; default)
timeRangeYesstringData aggregation time range. Available values: l7d (last 7 days; default), l30d (last 30 days), l90d (last 90 days), l12m (last 12 months)
sampleScopeYesstringData sample scope. Available values: all_asin (all ASINs; default), new_successful (successful new products), top_grossing (top-grossing products)
categoryIdNostringSpecify category ID to retrieve details (single record returned)
pageNointPage number, starting at 1; default: 1
sizeNointItems per page. Available values: integers from 1 to 10; default: 10
sortFieldNostringSort field (supports any response field name)
sortOrderNostringSort order. Available values: asc (ascending), desc (descending)

​
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