marketplace | string | required | Target marketplace code. Options: us, uk, de, in, ca, fr, it, es, mx, jp Example: us |
includeKeywords | string | optional | Keywords to include in title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case |
excludeKeywords | string | optional | Keywords to exclude from title/ASIN, comma-separated, up to 100 items, max 50 chars each Example: phone case |
categories | string | optional | Primary category names, comma-separated, must match the standard category names for the corresponding site. US site examples: Appliances, Arts Crafts & Sewing, Automotive, Baby, Beauty & Personal Care, Books, CDs & Vinyl, Cell Phones & Accessories, Clothing Shoes & Jewelry, Collectibles & Fine Art, Computers, Digital Music, Electronics, Garden & Outdoor, Grocery & Gourmet Food, Handmade, Health Household & Baby Care, Home & Kitchen, Industrial & Scientific, Kindle Store, Kitchen & Dining, Movies & TV, Musical Instruments, Office Products, Pet Supplies, Sports & Outdoors, Tools & Home Improvement, Toys & Games, Video Games, etc. Other sites (uk, de, fr, it, es, mx, jp, ca, in) have their own localized category names Example: {} |
minPrice | number | optional | |
maxPrice | number | optional | |
minSales | integer | optional | Minimum monthly sales Example: 1 |
maxSales | integer | optional | Maximum monthly sales Example: 1 |
minRevenue | number | optional | Minimum monthly revenue Example: 1 |
maxRevenue | number | optional | Maximum monthly revenue Example: 1 |
minReviews | integer | optional | Minimum number of reviews Example: 1 |
maxReviews | integer | optional | Maximum number of reviews Example: 1 |
minRating | number | optional | Minimum rating (1.0-5.0) Example: 1 |
maxRating | number | optional | Maximum rating (1.0-5.0) Example: 1 |
minWeight | number | optional | Minimum weight (lbs) Example: 1 |
maxWeight | number | optional | Maximum weight (lbs) Example: 1 |
minRank | integer | optional | Minimum BSR ranking Example: 1 |
maxRank | integer | optional | Maximum BSR ranking Example: 1 |
minLqs | integer | optional | Minimum LQS score (1-10) Example: 1 |
maxLqs | integer | optional | Maximum LQS score (1-10) Example: 1 |
minSellers | integer | optional | Minimum number of sellers Example: 1 |
maxSellers | integer | optional | Maximum number of sellers Example: 1 |
minNet | number | optional | Minimum net profit Example: 1 |
maxNet | number | optional | Maximum net profit Example: 1 |
sellerTypes | string | optional | Seller types, comma-separated. Options: amz (Amazon self-operated), fba, fbm Example: {} |
productTiers | string | optional | Product size tiers, comma-separated. Options: oversize, standard Example: {} |
excludeTopBrands | boolean | optional | Whether to exclude top brands Example: false |
excludeUnavailableProducts | boolean | optional | Whether to exclude unavailable products Example: false |
minUpdatedAt | string | optional | Data update start date (YYYY-MM-DD) Example: 2026-01-01 |
maxUpdatedAt | string | optional | Data update end date (YYYY-MM-DD) Example: 2026-01-01 |
needCount | integer | optional | Total number of results to return, API auto-paginates internally Example: 1 |
sort | string | optional | Sort field. Options: name, -name, category, -category, revenue, -revenue, sales, -sales, price, -price, rank, -rank, reviews, -reviews, lqs, -lqs, sellers, -sellers. Prefix - indicates descending. Default: name Example: {} |