SellerSprite Product Research
Fetch Amazon market data via SellerSprite API. Each command calls exactly one API endpoint — compose them as needed.
Quick Start
# Set API key
export SELLERSPRITE_SECRET_KEY="your-secret-key"
# Browse top categories
bunx @teamclaw/sellersprite-cli market
# Research products by keyword
bunx @teamclaw/sellersprite-cli product --keyword "wireless earbuds"
# Get ASIN details
bunx @teamclaw/sellersprite-cli asin --asin B08N5WRWNW
# Check remaining quota
bunx @teamclaw/sellersprite-cli quota
Commands
| Command | API Endpoint | Description |
|---|---|---|
market |
/v1/market/research |
Market/category research |
product |
/v1/product/research |
Product research by keyword |
competitor |
/v1/product/competitor-lookup |
Competitor lookup by ASIN |
asin |
/v1/asin/{market}/{asin}/with-coupon-trend |
ASIN details + coupon trend |
keyword |
/v1/keyword-research |
Keyword research |
quota |
/v1/visits |
Check API quota |
config |
— | Local config management |
Options
| Option | Applies to | Description | Default |
|---|---|---|---|
--keyword <kw> |
product, keyword | Search keyword | (required) |
--asin <asin> |
competitor, asin | Target ASIN | (required) |
--marketplace <code> |
all data commands | Marketplace code | US |
--month <yyyyMM> |
product, competitor, keyword | Query month | latest |
--page <n> |
market | Page number | 1 |
--size <n> |
market, product, competitor, keyword | Results per page (max 100) | 20/50 |
--format <format> |
all commands | text or json |
text |
References
Detailed specs in references/ directory:
references/api-endpoints.md— API parameters, response fields, computed stats, rate limitsreferences/marketplace-codes.md— Supported marketplaces with currenciesreferences/error-handling.md— Error types, unauthorized quota tips, module mapping