# ShopData API (https://shopdataapi.com)

> Real-Time Retail, Social Commerce, Local Secondhand & Cross-Border Wholesale Commerce Intelligence REST & MCP API covering Amazon (US/UK/DE/JP/CA/15+ storefronts), Walmart, Etsy Handmade, TikTok Shop, Facebook Marketplace, Alibaba 1688 Factory Wholesale, Taobao / Tmall, and Shopee — 85%–95% cheaper than Rainforest API & Keepa.
> Base API Gateway: https://api.shopdataapi.com
> 1-Click Claude Web & ChatGPT Remote MCP (OAuth 2.1 PKCE): https://mcp.shopdataapi.com/v1/mcp
> API-Key Streamable HTTP MCP Endpoint: https://api.shopdataapi.com/mcp
> AI Agent Skill Manifest: https://shopdataapi.com/SKILL.md
> Full Machine-Readable Reference for LLMs: https://shopdataapi.com/llms-full.txt
> OpenAPI 3.1 Spec: https://shopdataapi.com/openapi.json (and https://api.shopdataapi.com/openapi.json)

## Pricing & Record-Based Credit System ($1 = 10,000 Credits)

- Unit Rule: **$1.00 = 10,000 Credits**
- Keyword Search & Verified Reviews (`/v1/amazon/search`, `/v1/amazon/reviews`, `/v1/walmart/search`, `/v1/etsy/search`, `/v1/etsy/reviews`, `/v1/1688/search`, `/v1/taobao/search`, `/v1/shopee/search`, `/v1/tiktok-shop/search`): **2 Credits / item returned** ($0.08–$0.20 per 1,000 items; 0 Credits if empty)
- TikTok Shop Full Product, SKU Variants & Top Reviews (`GET` / `POST /v1/tiktok-shop/product`): **3 Credits / call** ($0.12–$0.30 per 1,000 calls; 0 Credits on HTTP 404/error)
- Facebook Marketplace Local Search & Listing Detail (`GET` / `POST /v1/facebook-marketplace/search`, `GET /v1/facebook-marketplace/item`): **5 Credits / call** ($0.20–$0.50 per 1,000 calls; 0 Credits if empty or HTTP 404/error)
- Full Product, SKU Matrix & 1688 MOQ Ladder Detail (`/v1/amazon/product`, `/v1/walmart/product`, `/v1/1688/item`, `/v1/taobao/item`): **10 Credits / call** ($0.40–$1.00 per 1,000 calls; 0 Credits on HTTP 404/error)
- Free Trial: **$1.20 (12,000 Credits) free instantly** at 0 ms on sign-up (no credit card required, 30 RPM / 2 RPS) + **+$2.00 (+20,000 Credits)** Developer Sandbox Streak bonus ($3.20 / 32,000 total free credits)
- Indie Starter Micro-Pack (PAYG): **$9.00** -> 90,000 never-expiring Credits (60 RPM)
- Starter Plan: **$19/mo** -> 250,000 Credits/mo (+31% bonus, $0.15 / 1K items, 120 RPM / 4 RPS)
- Pro Plan: **$69/mo** -> 1,200,000 Credits/mo (+74% bonus, $0.115 / 1K items, 300 RPM / 8 RPS)
- Business Plan: **$199/mo** -> 5,000,000 Credits/mo (+151% bonus, $0.08 / 1K items, 600 RPM / 15 RPS)
- Never-Expiring PAYG Packs: $9 (90k Credits), $25 (250k Credits), $89 (1.05M Credits), $249 (3.5M Credits)
- Payment Rails: 0%-Fee Crypto (USDT, USDC, SOL, BTC, BNB — +5% bonus credits) & instant self-serve top-up
- Refunds: payments from the last 14 days, up to the unused balance (support@shopdataapi.com)

## Latency SLA & Drop-In Migration

- **Warm PostgreSQL 16 + Redis DB 4 Cache**: `15–40 ms`
- **Live Multi-Rail Upstream Marketplace Fetch**: `0.8–2.2 s`
- **Drop-In Rainforest API Compatibility**: Supports `GET /request?api_key=sd_live_...&type=product|search|reviews&amazon_domain=amazon.com&asin=...` so existing Rainforest SDKs migrate in 1 line.

## AI Agent, Free Tools & Core Pages

- Official Claude / Cursor AI Skill Manifest: [SKILL.md](https://shopdataapi.com/SKILL.md)
- Complete Single-File LLM Reference: [llms-full.txt](https://shopdataapi.com/llms-full.txt)
- OpenAPI 3.1 JSON Specification: [openapi.json](https://shopdataapi.com/openapi.json)
- Free E-Commerce API Pricing Calculator: [Cost Calculator](https://shopdataapi.com/tools/ecommerce-api-pricing-calculator)
- Free 1688-to-Amazon FBA Wholesale Margin Calculator: [Wholesale Margin Calculator](https://shopdataapi.com/tools/wholesale-margin-calculator)
- Free Bulk Amazon ASIN, Walmart ID & 1688 Offer Extractor: [ASIN Extractor](https://shopdataapi.com/tools/amazon-asin-extractor)
- Apify E-Commerce Scraper Migration Guide: [Migrate from Apify](https://shopdataapi.com/from-apify)
- Live 7-Day API Status & p50/p95 Latency Monitor: [API Status](https://shopdataapi.com/status)
- Developer Utilities Hub: [Tools Hub](https://shopdataapi.com/tools)
- Remote Streamable HTTP MCP Server (`https://mcp.shopdataapi.com/v1/mcp`): [MCP Guide](https://shopdataapi.com/mcp)
- Developer Affiliate Program (20% Recurring): [Affiliate Program](https://shopdataapi.com/affiliate)

## Engineering Guides (/guides)

- [All Engineering Guides](https://shopdataapi.com/guides)
- [Rainforest API Pricing Breakdown (2026): Per-Request Costs vs. ShopData API](https://shopdataapi.com/guides/rainforest-api-pricing): Detailed 2026 Rainforest API pricing audit: compare $59–$499/mo expiring request plans ($0.01–$0.02/req) against ShopData API ($0.08–$0.20/1K items, $9 non-expiring PAYG).
- [Best Keepa API Alternative (2026): Real-Time Live BuyBox & Multi-Marketplace JSON](https://shopdataapi.com/guides/keepa-api-alternative): Frustrated by Keepa API EUR/month token refill throttling, compressed CSV integer arrays, and stale cached prices? Switch to ShopData API for live Amazon, Walmart & 1688 JSON.
- [Keepa API Pricing Breakdown (2026): Token-Per-Minute Cost vs. Flat JSON API](https://shopdataapi.com/guides/keepa-api-pricing): 2026 Keepa API pricing breakdown: €49–€1,699/mo EUR token/min buckets & 60-min expiry vs ShopData API ($0.20/1K items, $9 non-expiring PAYG, 12K free).
- [Etsy API Alternative (2026): Extract Live Product Listings, Prices & Reviews in JSON](https://shopdataapi.com/guides/etsy-api-alternative): Skip Etsy Open API v3 Commercial Access manual review, 10 QPS / 10K QPD caps & DataDome 403 blocks. Extract Etsy listings & reviews at $0.08–$0.20/1K.
- [Amazon PA-API 5.0 Alternative (2026): Query ASINs & Reviews Without Associates Sales Quotas](https://shopdataapi.com/guides/amazon-paapi-alternative): Locked out of Amazon Product Advertising API (PA-API 5.0) due to the 3-sale/180-day quota, 1 TPS throttle, or missing customer reviews? Query live Amazon data instantly with ShopData API.
- [Walmart Product & Price API Guide (2026): Access Live Catalog & Stock Without Seller Approval](https://shopdataapi.com/guides/walmart-api-pricing): Query real-time Walmart.com keyword search, Rollback pricing, WFS fulfillment badges, UPC/GTINs, and seller stock without Walmart Impact Affiliate or Seller Center approval.
- [1688 & Taobao / Tmall Product API Guide (2026): Extract MOQ Price Ladders & SKU Matrices](https://shopdataapi.com/guides/1688-taobao-api-guide): Query live 1688.com factory wholesale MOQ price tiers and Taobao/Tmall SKU matrices via REST JSON—no Chinese business license, Alipay account, or `mtop` cookie signing needed.

## Competitor Comparisons (/compare)

- [All Provider Comparisons](https://shopdataapi.com/compare)
- [ShopData API vs Rainforest API](https://shopdataapi.com/compare/rainforest-api-alternative): Compare ShopData API against Rainforest API: save up to 92% ($0.08–$0.20/1K items vs $10–$23/1K calls), keep non-expiring $9 PAYG credits, and add Walmart, Etsy, 1688 & Taobao.
- [ShopData API vs Keepa API](https://shopdataapi.com/compare/keepa-api-alternative): Compare ShopData API vs Keepa API: get clean UTF-8 BuyBox & SKU JSON without KeepaTime integer array decoding, €49/mo token refill stalls, or Amazon-only lock-in.
- [ShopData API vs Amazon PA-API 5.0](https://shopdataapi.com/compare/amazon-paapi-alternative): Replace Amazon Product Advertising API (PA-API 5.0) without qualifying Associates sales quotas, 1 TPS rate limits, or AWS SigV4 signing. Includes full customer reviews.
- [ShopData API vs Oxylabs E-Commerce Scraper API](https://shopdataapi.com/compare/oxylabs-ecommerce-scraper-alternative): Compare ShopData API vs Oxylabs & Bright Data E-Commerce Scraper APIs: get pre-normalized Amazon, Walmart, Etsy, 1688 & Taobao JSON from $9 PAYG with zero HTML parsing.

## Endpoints

### Amazon

- [Search Amazon Products & BuyBox Prices](https://shopdataapi.com/docs/amazon-search): `GET /v1/amazon/search` (2 Credits / Item)
- [Get Amazon Product Details & SKU Matrix by ASIN](https://shopdataapi.com/docs/amazon-product): `GET /v1/amazon/product` (2 Credits / Item)
- [Get Verified Amazon Customer Reviews by ASIN](https://shopdataapi.com/docs/amazon-reviews): `GET /v1/amazon/reviews` (2 Credits / Item)

### Walmart

- [Search Walmart Products & Rollback Prices](https://shopdataapi.com/docs/walmart-search): `GET /v1/walmart/search` (2 Credits / Item)
- [Get Full Walmart Product & SKU Details](https://shopdataapi.com/docs/walmart-product): `GET /v1/walmart/product` (2 Credits / Item)

### Etsy

- [Search Etsy Handmade & Vintage Listings](https://shopdataapi.com/docs/etsy-search): `GET /v1/etsy/search` (2 Credits / Item)
- [Get Etsy Listing Buyer Reviews](https://shopdataapi.com/docs/etsy-reviews): `GET /v1/etsy/reviews` (2 Credits / Item)

### 1688 Wholesale

- [Search 1688 Factory Wholesale Listings & MOQ Price Ladders](https://shopdataapi.com/docs/1688-search): `GET /v1/1688/search` (2 Credits / Item)
- [Get 1688 Factory Item MOQ Ladder & SKU Inventory Matrix](https://shopdataapi.com/docs/1688-item): `GET /v1/1688/item` (2 Credits / Item)

### Taobao & Tmall

- [Search Taobao & Tmall Retail Products](https://shopdataapi.com/docs/taobao-search): `GET /v1/taobao/search` (2 Credits / Item)
- [Get Taobao / Tmall Item Details & SKU Matrix](https://shopdataapi.com/docs/taobao-item): `GET /v1/taobao/item` (2 Credits / Item)

### Global Social & SEA

- [Search Shopee Southeast Asia Marketplace Products](https://shopdataapi.com/docs/shopee-search): `GET /v1/shopee/search` (2 Credits / Item)
- [Search TikTok Shop Viral Products & GMV Sales](https://shopdataapi.com/docs/tiktok-shop-search): `GET /v1/tiktok-shop/search` (2 Credits / item)
- [Get TikTok Shop Product, SKU Variants & Top Reviews](https://shopdataapi.com/docs/tiktok-shop-product): `GET /v1/tiktok-shop/product` (3 Credits / call)

### Facebook Marketplace

- [Search Facebook Marketplace Local & Shipping Listings](https://shopdataapi.com/docs/facebook-marketplace-search): `GET /v1/facebook-marketplace/search` (5 Credits / call)
- [Get Facebook Marketplace Listing Condition, Description & Seller](https://shopdataapi.com/docs/facebook-marketplace-item): `GET /v1/facebook-marketplace/item` (5 Credits / call)

## FAQ

### How does the $1 = 10,000 Credits pricing model work across all 13 endpoints?

ShopData API uses one transparent ledger where $1.00 = 10,000 Credits. Marketplace search and buyer review endpoints (/v1/amazon/search, /v1/walmart/search, /v1/etsy/search, /v1/1688/search, /v1/taobao/search, /v1/shopee/search, /v1/tiktok-shop/search, /v1/amazon/reviews, /v1/etsy/reviews) cost 2 Credits per returned item ($0.20 per 1,000 items nominal, or $0.08 per 1,000 items on the $199/mo Business plan). Deep ASIN, SKU matrix, and 1688 MOQ ladder detail calls (/v1/amazon/product, /v1/walmart/product, /v1/1688/item, /v1/taobao/item) cost 10 Credits per product ($0.40–$1.00 per 1,000 products). Empty searches and HTTP errors always cost 0 Credits.

### How does ShopData API compare to Rainforest API ($0.01–$0.02/req), Keepa, and Amazon PA-API 5.0?

Rainforest API charges $0.01 to $0.02 per single Amazon request ($10–$20 per 1,000 calls) and only covers Amazon. Keepa locks commercial API access behind €49–€1,299/mo token subscriptions without Walmart, Etsy, or 1688 sourcing data. Official Amazon PA-API 5.0 revokes access unless your Associates account continuously generates qualifying referral sales and throttles new keys to 1 TPS. ShopData API requires zero affiliate approvals, delivers Amazon + Walmart + Etsy + TikTok Shop + Shopee + 1688 + Taobao in one normalized JSON schema, and cuts unit costs by 90%+ ($0.08–$0.20 per 1,000 search items, $0.40–$1.00 per 1,000 ASIN details).

### Do 1688 and Taobao endpoints require Chinese business licenses, cookies, or domestic proxies?

No. Calling GET /v1/1688/search, /v1/1688/item, /v1/taobao/search, and /v1/taobao/item requires only your standard sd_live_ API key from any cloud server (AWS, GCP, Vercel, Hetzner, Cloudflare Workers). Every response returns structured factory MOQ price breaks (both original CNY and auto-converted USD), SKU color/size combinations, 30-day repurchase rates, and Verified Super Factory badges so you can compute real retail-vs-wholesale gross margins programmatically.

### What is the response latency for cached vs. live real-time marketplace requests?

Requests hitting our warm PostgreSQL 16 + Redis DB 4 catalog cache respond in 15–45 ms. Live upstream multi-rail queries (or paid requests passing ?fresh=1) automatically route across our redundant RapidAPI & SERP upstream pools in 1.2–2.6 seconds and write-through to the cache.

### Can I migrate from Rainforest API or connect AI agents via Remote MCP without custom glue code?

Yes. For teams migrating existing Rainforest API scripts, our gateway includes a /request compatibility alias (type=search, product, reviews) alongside our clean /v1/* REST endpoints. For AI shopping & sourcing agents (Claude Desktop, Cursor, Windsurf, LangChain, CrewAI), connect directly to https://mcp.shopdataapi.com/v1/mcp via OAuth 2.1 or Bearer sd_live_... to unlock all 13 marketplace tools immediately.

### Am I charged when a search returns 0 products, an ASIN is 404, or an upstream call fails?

Never. ShopData API enforces a strict Charge-Before-Return & Zero-Charge-on-Error policy: 0-result searches, 404 unknown ASIN/item lookups, HTTP 400 validation errors, HTTP 429 rate-limit responses, and HTTP 5xx upstream errors all deduct 0 Credits.

### Should I start with the $9 Indie Starter Pack, a Monthly Plan, or a PAYG Credit Pack?

Every new account receives 12,000 free credits ($1.20) instantly plus up to +$2.00 (+20,000 credits) via the Developer Sandbox Streak. When ready to ship, solo builders love the $9 Indie Starter Micro-Pack (90,000 non-expiring credits, 60 RPM). High-volume teams choose Monthly Subscriptions ($19 Starter / 250k, $69 Pro / 1.2M, $199 Business / 5M credits) for +31% to +151% bonus credits, or larger PAYG Packs ($25 / 250k, $89 / 1.05M, $249 / 3.5M) that never expire.

### What are the RPM rate limits and concurrency tiers?

Free Trial accounts include 12,000 Credits at 30 RPM (2 RPS). Paid accounts unlock smooth production concurrency: 60 RPM / 3 RPS ($9 Indie Pack), 120 RPM / 4 RPS (Starter $19/mo or $25 PAYG), 300 RPM / 8 RPS (Pro $69/mo or $89 PAYG), and 600 RPM / 15 RPS (Business $199/mo or $249 PAYG). Need 1,000+ RPM? Contact us for a Dedicated Enterprise Key Pool.

### What payment methods and corporate invoices are supported?

We support both instant Stripe Checkout (Credit/Debit Cards, Apple Pay, Google Pay, Link — with downloadable PDF receipts and corporate EU VAT / Tax ID billing profiles) and 0%-fee Cryptocurrency via NOWPayments (USDT, USDC, SOL, BTC, BNB across Solana, Arbitrum, Polygon, BSC, Tron, and Ethereum) which automatically grants +5% Bonus Credits.

### What is your refund policy?

Payments made within the last 14 days are eligible for a pro-rated refund of unused purchased credits. Promotional signup and streak credits have no cash value.