--- name: shopdataapi description: Official Model Context Protocol (MCP) server and AI Agent Skill for ShopData API (https://shopdataapi.com). Real-time retail, social commerce, local secondhand, and cross-border wholesale API covering Amazon, Walmart, Etsy, TikTok Shop (Search + Full Product/SKU/Reviews at $0.12–$0.30/1K), Facebook Marketplace (Search + Listing Detail at $0.20–$0.50/1K), Shopee, 1688, and Taobao — starting at $0.20 / 1,000 requests ($0.0002/call, down to $0.08 / 1,000 requests on Business), up to 85%–95% cheaper than Rainforest API, Keepa & legacy scrapers. Includes $1.20 (12,000 Free Credits) instant signup + $2.00 Sandbox Streak bonus and $9 Indie Starter Pack. version: 1.1.0 homepage: https://shopdataapi.com mcp_url: https://api.shopdataapi.com/mcp mcp_page: https://shopdataapi.com/mcp documentation: https://shopdataapi.com/docs openapi: https://shopdataapi.com/openapi.json llms_txt: https://shopdataapi.com/llms.txt llms_full_txt: https://shopdataapi.com/llms-full.txt status_page: https://shopdataapi.com/status license: MIT author: ShopData API (https://shopdataapi.com) tags: - mcp - claude-skill - amazon-api - tiktok-shop-api - facebook-marketplace-api - rainforest-api-alternative - keepa-alternative - walmart-api - etsy-api - 1688-wholesale-api - taobao-api --- # ShopData API — Official Remote MCP Server & AI Agent Skill (`shopdataapi`) Connect **Claude Code**, **Claude Desktop**, **Cursor**, **Windsurf**, **ChatGPT Connectors**, **LangChain**, and **n8n** directly to **[ShopData API (`https://shopdataapi.com`)](https://shopdataapi.com)** — the real-time REST & Streamable HTTP MCP gateway for **Amazon, Walmart, Etsy, TikTok Shop (Search + Full Product/Variants/Top Reviews), Facebook Marketplace (Local Search + Listing Detail), Shopee, 1688 Factory Wholesale, and Taobao / Tmall**. - **Claim `$1.20` Free Credits (`12,000` Instant Free Credits at `0 ms` + `+$2.00` Sandbox Streak = `32,000` Free Credits, No Card Required)**: **[https://shopdataapi.com/signup](https://shopdataapi.com/signup)** - **Website & Live Multi-Marketplace Playground**: [https://shopdataapi.com](https://shopdataapi.com) - **Remote Streamable HTTP MCP Endpoint (OAuth 2.1 PKCE)**: `https://mcp.shopdataapi.com/mcp` (alternate OAuth URL: `https://mcp.shopdataapi.com/v1/mcp` · API-key endpoint: `https://api.shopdataapi.com/mcp`) - **Interactive API Reference (16 Endpoints)**: [https://shopdataapi.com/docs](https://shopdataapi.com/docs) - **Transparent Ultra-Low Pricing (`$0.20 / 1,000 requests` PAYG [`$0.0002/call`, down to `$0.08 / 1,000 requests` Business] · `$0.12–$0.30` / 1K TikTok Shop Product · `$0.20–$0.50` / 1K FB Marketplace · `$9` Indie Starter Pack)**: [https://shopdataapi.com/pricing](https://shopdataapi.com/pricing) - **OpenAPI 3.1 Specification**: [https://shopdataapi.com/openapi.json](https://shopdataapi.com/openapi.json) - **LLM Context Manifests**: [https://shopdataapi.com/llms.txt](https://shopdataapi.com/llms.txt) · [https://shopdataapi.com/llms-full.txt](https://shopdataapi.com/llms-full.txt) --- ## 1-Click Install: Connect via Remote Streamable HTTP MCP 1. Grab your instant API key (`sd_live_...`) with **`$1.20` (`12,000` Free Credits)** in 10 seconds at **[https://shopdataapi.com/signup](https://shopdataapi.com/signup)**. ### A. Claude Code CLI (1 Command) ```bash claude mcp add --transport http shopdataapi https://api.shopdataapi.com/mcp \ --header "x-api-key: sd_live_your_api_key_here" ``` ### B. Cursor (`.cursor/mcp.json`) / Windsurf / Claude Desktop ```json { "mcpServers": { "shopdataapi": { "url": "https://api.shopdataapi.com/mcp", "headers": { "x-api-key": "sd_live_your_api_key_here" } } } } ``` --- ## Direct REST `cURL` Quickstarts (Sub-300ms Warm Cache · Zero Charge on 404/Empty) ### 1. TikTok Shop Product Detail, SKU Variants & Top Reviews (`$0.30/1K` PAYG · `$0.12/1K` Business — 70%–88% Cheaper) Supports `GET` or `POST` on `/v1/tiktok-shop/product` (aliases: `/v1/tiktok-shop/item`, `/v1/tiktok/product`) and accepts `product_id`, `id`, or any full TikTok Shop product URL. Returns all 10 core intelligence fields (`price`, `list_price`, `stock`, `sold_count`, `shop`, `variants`, `images`, `rating`, `rating_count`, `top_reviews`): ```bash curl -sS "https://api.shopdataapi.com/v1/tiktok-shop/product?product_id=1730073687428142070®ion=US" \ -H "x-api-key: sd_live_your_api_key_here" ``` ```bash curl -sS -X POST "https://api.shopdataapi.com/v1/tiktok-shop/product" \ -H "x-api-key: sd_live_your_api_key_here" \ -H "Content-Type: application/json" \ -d '{"product_id":"1730073687428142070","region":"US"}' ``` ### 2. Facebook Marketplace City/Keyword Search & Listing Detail (`$0.50/1K` PAYG · `$0.20/1K` Business — 50%–86% Cheaper) Supports `GET` or `POST` on `/v1/facebook-marketplace/search` (alias: `/v1/facebook/marketplace/search`) and `/v1/facebook-marketplace/item` (aliases: `/v1/facebook/marketplace/item`, `/v1/facebook/marketplace/listing`). Returns `price`, `list_price`, `image`, `images`, `date_listed`, `status`, `location`, `delivery`, `condition`, `description`, and `seller`: ```bash # Search local & shipping Facebook Marketplace listings by keyword + city curl -sS "https://api.shopdataapi.com/v1/facebook-marketplace/search?query=couch&location=austin&limit=20" \ -H "x-api-key: sd_live_your_api_key_here" # Fetch single Facebook Marketplace listing condition, description, seller & photos curl -sS "https://api.shopdataapi.com/v1/facebook-marketplace/item?id=1500578701963217" \ -H "x-api-key: sd_live_your_api_key_here" ``` ### 3. Amazon US Search & 1688 Wholesale Sourcing (`$0.08–$0.20/1K` Items) ```bash curl -sS "https://api.shopdataapi.com/v1/amazon/search?query=ceramic+mug&country=US&page=1" \ -H "x-api-key: sd_live_your_api_key_here" ``` --- ## All 16 Endpoints & Unit Credit Pricing (`$1.00 = 10,000 Credits`) | MCP Tool Name | REST Endpoint | Credit Cost | Effective USD Rate | Key Returned Fields | | :--- | :--- | :--- | :--- | :--- | | `tiktok_shop_product` | `GET` / `POST /v1/tiktok-shop/product` | **3 Credits / call** (`0` on 404) | **`$0.12–$0.30 / 1K calls`** | `price`, `list_price`, `stock`, `sold_count`, `shop` (`id`, `name`, `rating`, `url`), `variants` (SKUs), `images`, `rating`, `rating_count`, `top_reviews`. | | `facebook_marketplace_search` | `GET` / `POST /v1/facebook-marketplace/search` | **5 Credits / call** (`0` if empty) | **`$0.20–$0.50 / 1K calls`** | `price`, `list_price`, `image`, `date_listed`, `status`, `location`, `delivery`, `condition`, `seller`. | | `facebook_marketplace_item` | `GET` / `POST /v1/facebook-marketplace/item` | **5 Credits / call** (`0` on 404) | **`$0.20–$0.50 / 1K calls`** | `price`, `description`, `condition`, `location`, `delivery`, `seller`, `images`, `list_price`, `date_listed`, `status`. | | `tiktok_shop_search` | `GET /v1/tiktok-shop/search` | **2 Credits / item** (`0` if empty) | `$0.08–$0.20 / 1K items` | Search viral TikTok Shop products across US, UK (`GB`), and SEA regions with sales velocity. | | `amazon_search` | `GET /v1/amazon/search` | **2 Credits / item** (`0` if empty) | `$0.08–$0.20 / 1K items` | Search live Amazon listings (`query`, `country`, `page`). Returns ASIN, BuyBox price, Prime status, rating, review count, and 30d sales volume. | | `amazon_product` | `GET /v1/amazon/product` | **10 Credits / ASIN** (`0` on 404) | `$0.40–$1.00 / 1K ASINs` | Full Amazon ASIN details including BuyBox seller, list price, category BSR, bullets, and child SKU matrix. | | `amazon_reviews` | `GET /v1/amazon/reviews` | **2 Credits / review** (`0` if empty) | `$0.08–$0.20 / 1K reviews` | Verified-purchase Amazon customer reviews, star ratings, variants purchased, and buyer media. | | `walmart_search` | `GET /v1/walmart/search` | **2 Credits / item** (`0` if empty) | `$0.08–$0.20 / 1K items` | Search Walmart.com shelves by keyword with Rollback & BuyBox prices, WFS badge, and stock state. | | `walmart_product` | `GET /v1/walmart/product` | **10 Credits / item** (`0` on 404) | `$0.40–$1.00 / 1K items` | Full Walmart item details by `id` or `url` including UPC/GTIN, seller, stock, and variants. | | `etsy_search` | `GET /v1/etsy/search` | **2 Credits / listing** (`0` if empty) | `$0.08–$0.20 / 1K listings` | Search handmade, vintage, and POD Etsy listings with Star Seller badges and pricing. | | `etsy_reviews` | `GET /v1/etsy/reviews` | **2 Credits / review** (`0` if empty) | `$0.08–$0.20 / 1K reviews` | Authentic Etsy buyer reviews and customer photos by `listing_id`. | | `alibaba_1688_search` | `GET /v1/1688/search` | **2 Credits / offer** (`0` if empty) | `$0.08–$0.20 / 1K offers` | Search Alibaba 1688 factory wholesale offers with CNY & USD prices, MOQ, and repurchase rates. | | `alibaba_1688_item` | `GET /v1/1688/item` | **10 Credits / offer** (`0` on 404) | `$0.40–$1.00 / 1K offers` | Full 1688 factory offer details with exact MOQ price ladders (CNY & USD), SKU matrix, and weight. | | `taobao_search` | `GET /v1/taobao/search` | **2 Credits / item** (`0` if empty) | `$0.08–$0.20 / 1K items` | Search Taobao & Tmall consumer products with CNY & USD pricing and monthly sales. | | `taobao_item` | `GET /v1/taobao/item` | **10 Credits / item** (`0` on 404) | `$0.40–$1.00 / 1K items` | Full Taobao / Tmall SKU specification tree, prices, stock, and media. | | `shopee_search` | `GET /v1/shopee/search` | **2 Credits / item** (`0` if empty) | `$0.08–$0.20 / 1K items` | Search SEA & LATAM Shopee storefronts (`SG`, `MY`, `TH`, `PH`, `VN`, `ID`, `TW`, `BR`). | --- ## Engineering Guides & Free Browser Utilities - **Engineering Guides**: - [Rainforest API Pricing Breakdown (2026)](https://shopdataapi.com/guides/rainforest-api-pricing) - [Keepa API Pricing Breakdown (2026): Token Cost vs Flat API](https://shopdataapi.com/guides/keepa-api-pricing) - [Keepa API Alternative: Escape EUR/Month Token Quotas](https://shopdataapi.com/guides/keepa-api-alternative) - [Etsy API Alternative (2026): Product & Price JSON Scraper](https://shopdataapi.com/guides/etsy-api-alternative) - [Amazon PA-API 5.0 Alternative (No Associates Quota)](https://shopdataapi.com/guides/amazon-paapi-alternative) - [Walmart Product & Pricing API Guide](https://shopdataapi.com/guides/walmart-api-pricing) - [1688 & Taobao Wholesale API Guide](https://shopdataapi.com/guides/1688-taobao-api-guide) - **Free Developer Tools**: - [E-Commerce API Cost Calculator](https://shopdataapi.com/tools/ecommerce-api-pricing-calculator) - [1688-to-Amazon Wholesale Margin Calculator](https://shopdataapi.com/tools/wholesale-margin-calculator) - [Bulk Amazon ASIN, Walmart ID & 1688 Offer Extractor](https://shopdataapi.com/tools/amazon-asin-extractor) ## Support & Contact - **Instant Free API Key (`$1.20` Free Credits)**: [https://shopdataapi.com/signup](https://shopdataapi.com/signup) - **Documentation**: [https://shopdataapi.com/docs](https://shopdataapi.com/docs) - **Engineering Support**: `support@shopdataapi.com`