1688 APIglobal.1688.com ↗
Search and browse 1688.com wholesale listings. Get product titles, tiered prices, SKU variants, seller scores, and images via 3 structured endpoints.
What is the 1688 API?
The 1688.com API exposes 3 endpoints for accessing Alibaba's Chinese wholesale marketplace, covering keyword search, category browsing, and full product detail retrieval. The search_products endpoint returns up to 2,000 matching listings per query, each with pricing, seller name, sales volume, and location. The get_product_details endpoint goes deeper, returning quantity-tiered wholesale prices, per-SKU stock levels, variant dimensions with photos, seller scores, and shipping metadata.
curl -X GET 'https://api.parse.bot/scraper/87cc17b9-a363-4c5e-9ddf-61e6e9787e8a/search_products?page=1&query=bluetooth+speaker&category=122708008' \ -H 'X-API-Key: $PARSE_API_KEY'
Full-text keyword search across 1688.com wholesale listings. Supports optional category filtering. Results are auto-iterated across pages; each page returns up to 20 products with title, price, seller name, image, and sales volume.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination, 1-based. |
| queryrequired | string | Search keywords (e.g. 'bluetooth speaker', 'phone case'). Chinese or English. |
| category | string | Optional 1688 category ID to filter results (e.g. '122708008' for computer peripherals). Obtainable from get_category_products or the site's category navigation. |
{
"type": "object",
"fields": {
"total": "integer total number of matching products (capped at 2000 by the platform)",
"products": "array of product listings with offer_id, title, price, image_url, seller_name, product_url, sold_count, province, city"
},
"sample": {
"data": {
"total": 2000,
"products": [
{
"city": "深圳市",
"price": "26",
"title": "跨境TG117音响蓝牙音箱便携式插卡音响低音炮户外家用蓝牙小音箱",
"offer_id": "787239771343",
"province": "广东",
"image_url": "https://cbu01.alicdn.com/img/ibank/O1CN01yhGKae1IPNYbaSbcE_!!3703270885-0-cib.jpg",
"sold_count": "已售3.1万+件",
"product_url": "https://detail.1688.com/offer/787239771343.html",
"seller_name": "深圳市安科达锐电子有限公司"
}
]
},
"status": "success"
}
}About the 1688 API
Search and Category Browsing
The search_products endpoint accepts a required query string (Chinese or English keywords) and an optional category parameter for scoping results to a specific 1688 category ID. Each page returns up to 20 products from a pool capped at 2,000 results by the platform. Each listing includes offer_id, title, price, image_url, seller_name, product_url, sold_count, province, and city. The get_category_products endpoint mirrors this shape but navigates by a numeric category_id rather than a search query — useful when you know the exact category and want to enumerate its inventory without keyword bias.
Product Detail
The get_product_details endpoint takes an offer_id (available from either listing endpoint) and returns the complete offer record. The skus array gives concrete variant entries with sku_id, spec, price, available_quantity, and sold_count. The sku_props array maps variant dimensions (e.g. colour, size) to their labels and per-value images. The images field covers all gallery photos including SKU variant photos, while main_images is the primary carousel subset. The attributes array contains the seller's product spec table rows, and shipping carries origin, unit weight in kg, and a delivery promise string.
Seller and Rating Data
The seller object returned by get_product_details includes company_name, service_score, repeat_buyer_rate, and an is_verified_factory boolean — useful for filtering suppliers by credibility. The rating object provides score, positive_rate, and review_count, though these fields can be null when a listing has insufficient review history. The unit field reflects the Chinese sales unit (e.g. 台 for machines, 件 for pieces), which matters for interpreting tiered price thresholds correctly.
The 1688 API is a managed, monitored endpoint for global.1688.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when global.1688.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official global.1688.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a supplier comparison tool using seller scores, repeat_buyer_rate, and is_verified_factory across multiple listings
- Track wholesale price changes over time for specific offer_ids using tiered price data from get_product_details
- Enumerate all products in a given 1688 category using category_id pagination to build a product database
- Extract SKU variant availability and stock levels to monitor inventory depth for specific products
- Cross-reference sold_count and price across search results to identify high-volume low-cost listings for sourcing decisions
- Pull product attribute tables from the attributes array to automate spec comparison across competing suppliers
- Geo-filter wholesale suppliers by province and city fields to find regional manufacturers
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.