APIClaw Amazon API

APIClaw API platform overview — AI-powered commerce data infrastructure. Provides programmatic access to 200M+ Amazon products with real-time data across 6 e...

Security Scan

The skill's requirements and runtime instructions are consistent with an API client for the APIClaw service — it only asks for an API key and describes how to call the documented endpoints.

Purpose & Capability

Name/description advertise an Amazon product-data API and the skill only requires an APICLAW_API_KEY and documents API endpoints and request formats — these are directly aligned with the stated purpose.

Instruction Scope

SKILL.md contains only API usage guidance (base URL, auth header, POST JSON payloads, parameter names). It does not instruct reading unrelated files, other environment variables, or sending data to unexpected endpoints.

Install Mechanism

No install spec or code files — instruction-only skill. Nothing is written to disk or fetched during install, so install risk is minimal.

Credentials

Only a single credential is required (APICLAW_API_KEY) and it is clearly the API key used for Bearer auth to the documented apiclaw.io endpoints. No unrelated secrets or config paths are requested.

Persistence & Privilege

always is false and the skill is user-invocable; it does not request elevated persistent presence or any system-wide configuration changes.

Assessment

This skill appears coherent and only needs your APICLAW_API_KEY to call apiclaw.io endpoints. Before installing: verify apiclaw.io is the legitimate service you intend to use (check official docs and pricing), avoid pasting your key in public places, treat the API key as a secret (rotate keys if compromised), and be aware that the agent may call the service when asked (default autonomous invocation). If you need stricter control, limit the key's permissions or request a scoped/test key from APIClaw and review the provider's privacy/billing terms.

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

#	Endpoint	What It Does	Key Output
1	categories	Browse Amazon category tree	categoryName, categoryPath, productCount, hasChildren
2	markets/search	Market-level aggregate metrics	sampleAvgMonthlySales, sampleAvgPrice, sampleBrandCount, topSalesRate, sampleFbaRate
3	products/search	Product search with 14 preset strategies	asin, title, price, bsrRank, atLeastMonthlySales, rating, ratingCount
4	products/competitor-lookup	Competitor analysis by keyword/ASIN	competitive products with sales, revenue, seller info
5	realtime/product	Live single-ASIN detail	title, rating, features, variants, bestsellersRank, buyboxWinner
6	reviews/analyze	AI-powered review insights	sentimentDistribution, consumerInsights (painPoints, buyingFactors, etc.)

Endpoint Details

1. Categories

Browse or search Amazon's category hierarchy.

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?"

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.

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.

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.

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

Key response fields:

Field	Type	Note
title, brand	String	Basic info
rating, ratingCount	Float/Int	Rating data
ratingBreakdown	Object	{five_star: {percentage, count}, ...}
features	List	Bullet points
bestsellersRank	Array	[{category, rank}, ...] — NOT a single integer
buyboxWinner	Object	{price, fulfillment, seller} — price is nested here
topReviews	List	Top reviews with title, body, rating
variants	List	All 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.

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.

Data	markets	products/competitors	realtime/product	reviews/analyze
Monthly Sales	sampleAvgMonthlySales	✅ atLeastMonthlySales	❌	❌
Price	sampleAvgPrice	price	buyboxWinner.price	❌
BSR	sampleAvgBsr	bsrRank (integer)	bestsellersRank (array)	❌
Rating	sampleAvgRating	rating	rating	avgRating
Review Count	sampleAvgReviewCount	ratingCount	ratingCount	totalReviews
Sentiment	❌	❌	❌	✅ sentimentDistribution
Consumer Insights	❌	❌	❌	✅ consumerInsights
Pain Points	❌	❌	❌ (manual from topReviews)	✅ AI-analyzed
Profit Margin	❌	profitMargin	❌	❌
FBA Fee	❌	fbaFee	❌	❌
Features/Bullets	❌	❌	✅ features	❌
Variants	❌	variantCount (integer)	variants (full list)	❌

What Each Endpoint Is Best For

Need	Use This
Sales, pricing, competition data	products/search or products/competitor-lookup
Live pricing, reviews, listing content	realtime/product
Category-level market sizing	markets/search
Consumer pain points, sentiment, buying factors	reviews/analyze
Category browsing / validation	categories
Full product picture	Combine 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:

clawhub install Amazon-analysis-skill

Links

• Website: apiclaw.io
• API Docs: api.apiclaw.io/api-docs
• GitHub: github.com/SerendipityOneInc
• Support: [e-mail]