1688 Developer ecosystem
Welcome to the official WarehousePlus 1688 API documentation. Our infrastructure provides a high-availability proxy layer to the 1688 marketplace, optimized for low-latency product data retrieval, global caching, and automated multi-language translation.
Secure Proxy
Enterprise-grade security with JWT and API Token rotation.
Global CDN
Product data cached at the edge for <50ms response times.
Authentication
WholesalePlus uses API Tokens to authenticate requests. You can generate and manage your keys in the developer dashboard.
To authorize your requests, include the apiToken as a query parameter in every request. Requests without a valid token will return a 401 Unauthorized response.
curl "http://api.wholesaleplus.com/v1/resource?apiToken=YOUR_KEY"Auth Sandbox Unavailable
Tokens are validated at the gateway layer before reaching individual resource sandboxes.
Item Detail by ID
The core endpoint for 1688 integration. Fetch real-time product data including specifications, pricing tiers, and inventory.
- High-Fidelity: Returns original 1688 fields without data loss.
- Localization: Supports 12+ languages with dynamic translation.
curl "http://localhost:3000/api/1688/item_detail?apiToken=KEY&item_id=652702302959&language=en"Item Detail by URL
Resolve raw 1688 product URLs into structured data. Useful for scraping-free browser data extraction.
Ideal for extension-based workflows or internal product curators. Provide a POST body with the target URL.
{
"url": "https://detail.1688.com/offer/652702302959.html",
"language": "en"
}Description Images
Extract the visual context of a product. Returns raw HTML segments or a structured array of high-res image URLs.
Requests for description data are cached longer (24h) as content rarely changes. Use this to hydrate your "Product Details" tabs.
Rating & Reviews
Integrate social proof directly into your storefront with customer feedback data and verified purchase images.
Paginated review data. Use the page parameter to fetch deep review history.
Shipping Calculation
Real-time shipping fee calculation based on source-to-province metrics from the 1688 supply chain.
Requires province name in Chinese (native) or pinyin. Estimates are subject to vendor confirmation.
Global Sales Stats
Market intelligence data. Analyze transaction volumes and buyer demographics for specific 1688 resources.
Historical sales trends over 30 days. Perfect for high-volume retail trend analysis.