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, productCount, hasChildren2markets/searchMarket-level aggregate metricsavg sales, avg price, brand count, concentration, FBA rate3products/searchProduct search with 14 preset strategiesASIN, title, price, BSR, monthly sales, rating, reviews4products/competitor-lookupCompetitor analysis by keyword/ASINcompetitive products with sales, revenue, seller info5realtime/productLive single-ASIN detailprice, BSR, reviews, features, variants, buy box6reviews/analyzeAI-powered review insightssentiment, pain points, buying factors, user profiles

Endpoint Details#

1. Categories#

Browse or search Amazon's category hierarchy.

text

POST /openapi/v2/categories
{"keyword": "pet supplies"}         # search by keyword
{"parentCategoryName": "Pet Supplies"}  # browse children

2. Market#

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

text

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

Returns: avg monthly sales, avg price, brand count, seller count, concentration ratios, new SKU rate, FBA rate.

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.

Monthly sales field: atLeastMonthlySales (lower-bound estimate).

4. Competitors#

Competitor discovery by keyword, brand, or specific ASIN.

text

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

5. Realtime Product#

Live data for a single ASIN — current price, BSR, reviews, features, variants.

text

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

⚠️ Does NOT return monthly sales or profit margin. Use products/competitors for those.

6. Review Analysis#

AI-powered consumer insights from customer reviews.

text

POST /openapi/v2/reviews/analyze
{"asin": "B09V3KXJPB"}
{"asins": ["B09V3KXJPB", "B08YYYYY"]}          # compare products
{"category": "Pet Supplies,Dogs,Toys", "period": "90d"}  # category-level

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

What Each Endpoint Is Best For#

NeedUse ThisSales & competition dataproducts / competitorsLive pricing, reviews, listing contentrealtime/productCategory-level market sizingmarkets/searchConsumer pain points & insightsreviews/analyzeCategory browsing / validationcategories

Credits#

• Each API call consumes credits
• Response includes _credits.consumed and _credits.remaining
• Plans & rates: apiclaw.io/pricing

Data Notes#

• Monthly sales ( atLeastMonthlySales) is a lower-bound estimate — variance across tools is normal
• Realtime vs database: realtime/product is live; products/ competitors have ~T+1 delay
• Currently Amazon US only (amazon.com) — more marketplaces planned

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