APIClaw — Commerce Data Infrastructure for AI Agents#

Real-time access to 200M+ Amazon products. 6 endpoints, one API key.

Language rule: Respond in the user's language.

Quick Start#

1. Get API key: apiclaw.io/api-keys
2. Set env: export APICLAW_API_KEY='hms_live_xxx'
3. Base URL: https://api.apiclaw.io/openapi/v2
4. Auth: Authorization: Bearer YOUR_API_KEY
5. All endpoints: POST with JSON body

New keys need 3-5 seconds to activate. If 403, wait and retry.

API Endpoints#

#EndpointWhat It DoesKey Output1categoriesBrowse Amazon category treecategoryName, categoryPath, productCount, hasChildren2markets/searchMarket-level aggregate metricssampleAvgMonthlySales, sampleAvgPrice, sampleBrandCount, topSalesRate, sampleFbaRate3products/searchProduct search with 14 preset strategiesasin, title, price, bsrRank, atLeastMonthlySales, rating, ratingCount4products/competitor-lookupCompetitor analysis by keyword/ASINcompetitive products with sales, revenue, seller info5realtime/productLive single-ASIN detailtitle, rating, features, variants, bestsellersRank, buyboxWinner6reviews/analyzeAI-powered review insightssentimentDistribution, consumerInsights (painPoints, buyingFactors, etc.)

Endpoint Details#

1. Categories#

Browse or search Amazon's category hierarchy.

text

POST /openapi/v2/categories
{"categoryKeyword": "pet supplies"}                    # search by keyword
{"parentCategoryPath": ["Pet Supplies"]}               # browse children

⚠️ Use categoryKeyword (not keyword) and parentCategoryPath (not parentCategoryName).

2. Markets#

Category-level market metrics — answer "Is this market worth entering?"

text

POST /openapi/v2/markets/search
{"categoryPath": ["Pet Supplies", "Dogs", "Toys"], "topN": "10"}

⚠️ topN must be a string ( "3", "5", "10", "20"), NOT an integer.

Returns: sampleAvgMonthlySales, sampleAvgPrice, sampleBrandCount, sampleSellerCount, topSalesRate (concentration), sampleNewSkuRate, sampleFbaRate.

3. Products#

Product search with filters or 14 built-in selection modes.

text

POST /openapi/v2/products/search
{"keyword": "yoga mat", "mode": "beginner"}

14 modes: beginner, fast-movers, emerging, long-tail, underserved, new-release, fbm-friendly, low-price, single-variant, high-demand-low-barrier, broad-catalog, selective-catalog, speculative, top-bsr.

Key fields: atLeastMonthlySales (lower-bound estimate), bsrRank (integer), ratingCount (not reviewCount), price, profitMargin, fbaFee.

4. Competitors#

Competitor discovery by keyword, brand, or specific ASIN.

text

POST /openapi/v2/products/competitor-lookup
{"keyword": "wireless earbuds"}
{"asin": "B09V3KXJPB"}

Returns same product fields as products/search.

5. Realtime Product#

Live data for a single ASIN — current listing content and pricing.

text

POST /openapi/v2/realtime/product
{"asin": "B09V3KXJPB"}

Key response fields:

FieldTypeNotetitle, brandStringBasic inforating, ratingCountFloat/IntRating dataratingBreakdownObject{five_star: {percentage, count}, ...}``featuresListBullet pointsbestsellersRankArray[{category, rank}, ...] — NOT a single integerbuyboxWinnerObject{price, fulfillment, seller} — price is nested heretopReviewsListTop reviews with title, body, ratingvariantsListAll variants with dimensions

⚠️ Does NOT return: atLeastMonthlySales, profitMargin, fbaFee, sellerCount. Use products/competitor-lookup for those. ⚠️ Price is nested: buyboxWinner.price, NOT top-level price.

6. Review Analysis#

AI-powered consumer insights from customer reviews.

text

POST /openapi/v2/reviews/analyze

# Single or multiple ASINs (mode + asins required)
{"mode": "asin", "asins": ["B09V3KXJPB"]}
{"mode": "asin", "asins": ["B09V3KXJPB", "B08YYYYY"]}

# Category-level insights
{"mode": "category", "categoryPath": "Pet Supplies,Dogs,Toys", "period": "90d"}

# Filter to specific dimensions
{"mode": "asin", "asins": ["B09V3KXJPB"], "labelType": "painPoints"}

⚠️ mode is required ( "asin" or "category"). ⚠️ Use asins (plural, array), NOT asin (singular string).

11 insight dimensions (labelType): painPoints, improvements, buyingFactors, issues, positives, scenarios, keywords, userProfiles, usageTimes, usageLocations, behaviors.

Returns: totalReviews, avgRating, sentimentDistribution, ratingDistribution, consumerInsights, topKeywords, verifiedRatio.

⚠️ Field Differences Across Endpoints#

The 4 endpoint types return different fields. Do NOT assume they share the same structure.

Datamarkets``products/ competitors``realtime/product``reviews/analyzeMonthly SalessampleAvgMonthlySales✅ atLeastMonthlySales❌❌PricesampleAvgPricepricebuyboxWinner.price❌BSRsampleAvgBsrbsrRank (integer)bestsellersRank (array)❌RatingsampleAvgRatingratingratingavgRatingReview CountsampleAvgReviewCountratingCountratingCounttotalReviewsSentiment❌❌❌✅ sentimentDistributionConsumer Insights❌❌❌✅ consumerInsightsPain Points❌❌❌ (manual from topReviews)✅ AI-analyzedProfit Margin❌profitMargin❌❌FBA Fee❌fbaFee❌❌Features/Bullets❌❌✅ features❌Variants❌variantCount (integer)variants (full list)❌

What Each Endpoint Is Best For#

NeedUse ThisSales, pricing, competition dataproducts/search or products/competitor-lookupLive pricing, reviews, listing contentrealtime/productCategory-level market sizingmarkets/searchConsumer pain points, sentiment, buying factorsreviews/analyzeCategory browsing / validationcategoriesFull product pictureCombine products (quantitative) + realtime (qualitative) + reviews (insights)

Known Quirks#

1. topN and newProductPeriod are strings — use "10" not 10
2. listingAge is a string — use "180" not 180
3. All response .data is an array — use .data[0] not .data.fieldName
4. ratingCount not reviewCount — the field is called ratingCount everywhere
5. bsrRank (integer) in products/competitors vs bestsellersRank (array) in realtime
6. Rate limit: 100 req/min, 10 req/sec burst

Credits#

• Each API call consumes credits
• Response includes meta.creditsConsumed and meta.creditsRemaining
• Minimum 50 reviews required for reviews/analyze (returns INSUFFICIENT_REVIEWS error otherwise)
• Plans & rates: apiclaw.io/pricing

Data Notes#

• Monthly sales ( atLeastMonthlySales) is a lower-bound estimate — actual may be higher
• Realtime vs database: realtime/product is live; products/ competitors have ~T+1 delay
• Currently Amazon US only (amazon.com) — more marketplaces planned
• Sales estimation fallback: When atLeastMonthlySales is null → Monthly sales ≈ 300,000 / BSR^0.65

Go Deeper#

For advanced Amazon product research — 14 selection strategies, risk assessment, pricing analysis, listing optimization, and operational monitoring — install the dedicated skill:

bash

clawhub install Amazon-analysis-skill

Links#

• Website: apiclaw.io
• API Docs: api.apiclaw.io/api-docs
• GitHub: github.com/SerendipityOneInc
• Support: support@apiclaw.io