filter_niches
Filter Amazon niches by 50+ commercial metrics to find blue oceans, high-search low-competition, or low-return segments. Use for niche scouting and deep reports.
Instructions
[Amazon niche filter] Filter Amazon Niches (a finer-grained "demand cluster" than categories) by 50+ commercial metrics, or use as a "niche detail" endpoint for one niche. Use when: user says "find blue ocean" / "high search volume + low competition niches" / "fast-growing small markets" / "niche scouting" / "give me the deep report on this niche" / "low return-rate niches" / "niches with return rate under 10%"; the core filter step of GTM scouting SOPs; getting fee structure / brand age / new-launch trends for one niche. Don't use: for full categories (use filter_categories); for actual products in a niche (the niche record only carries 1 referenceAsin; combine with categoryId + list_category_products); for plain keyword search (use search_amazon). Returns: data.items.data[{ nicheId, nicheTitle, referenceAsinImageUrl, currency, searchVolumeT90, searchVolumeT360, searchVolumeGrowthT90, minimumPrice, maximumPrice, avgPrice, productCount, sponsoredProductsPercentage, primeProductsPercentage, top5ProductsClickShare, top20BrandsClickShare, brandCount, sellingPartnerCount, avgBrandAge, avgBestSellerRank, avgProductPrice, avgReviewCount, avgReviewRating, avgDetailPageQuality, newProductsLaunchedT180/T360, successfulLaunchesT90/T180/T360, returnRateT360, fee fields T365 … 100+ fields }] + data.items.pagination.{ total, page, size, hasNext }. Pagination: use the 'page' param (default 1, 1-based, size capped at 10 (default 3)); 'pagination.hasNext=true' means more pages exist, 'hasNext=false' means last page. Pair with: ↑ marketplaceId required (defaults US); nicheTitle for keyword filter, nicheId for single-niche detail; ↓ feed referenceAsin into get_amazon_product to see the representative product; niche doesn't carry a categoryId directly — derive separately if needed. Cost: ~1 point/call, ~5s. Tips: size capped at 10 (default 3); pass long-tail filters (50+ fields) via extraFilters; classic blue-ocean combo = high searchVolumeT90Min + low top5ProductsClickShareT360Max + moderate productCountMax + positive searchVolumeGrowthT90Min + returnRateT360Max ≤ 0.10 (low-return). For return-rate filtering use returnRateT360Max (upper bound, 0-1 decimal); the response includes returnRateT360 with the actual return rate.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| marketplaceId | No | Amazon marketplace id (required). Common: US, UK, DE, JP, FR, IT, ES, CA. Defaults to US. | US |
| nicheId | No | When set, returns the full deep report for that single niche (this endpoint doubles as the niche-detail endpoint). Omit to list multiple niches matching the filters. Example: '8140a265-768d-4679-8bc2-994cb1c96f0b' (UUID). | |
| nicheTitle | No | Keyword match against niche titles. Examples: 'iphone 16 wallet case' / 'wireless earbuds for sports'. | |
| page | No | Page number, 1-based. | |
| size | No | Page size, max 10 (backend hard limit), default 3 (small default to keep responses under AI context limits — pass size=10 explicitly when you need a wider sweep). | |
| sortField | No | Sort field; any response field name is accepted (e.g. 'searchVolumeT90', 'avgProductPrice'). | |
| sortOrder | No | Sort order: 'asc' or 'desc'. | |
| searchVolumeT90Min | No | Min search volume over last 90 days. | |
| searchVolumeT90Max | No | Max search volume over last 90 days. | |
| searchVolumeT360Min | No | Min search volume over last 360 days. | |
| searchVolumeT360Max | No | Max search volume over last 360 days. | |
| searchVolumeGrowthT90Min | No | Min 90-day search-volume growth rate (decimal, 0.1 = +10%). | |
| searchVolumeGrowthT90Max | No | Max 90-day search-volume growth rate. | |
| minimumPriceMin | No | Lower bound on the niche's minimum product price. | |
| maximumPriceMax | No | Upper bound on the niche's maximum product price. | |
| productCountMin | No | Min product count in the niche. | |
| productCountMax | No | Max product count in the niche. | |
| avgReviewCountMin | No | Min average review count. | |
| avgReviewCountMax | No | Max average review count — lower means less competition. | |
| avgReviewRatingMin | No | Min average review rating (0-5). | |
| top5ProductsClickShareT360Max | No | Max top-5-products click share over 360 days (0-1). Lower = more fragmented niche, more opportunity. | |
| returnRateT360Max | No | Max return rate over 360 days (0-1). | |
| extraFilters | No | Pass-through for any other upstream filter (e.g. sponsoredProductsPercentageT360Min, successfulLaunchesT360Max, avgBestSellerRankMax). Keys must match the upstream doc verbatim. |