The Alibaba Product API returns a full Alibaba product detail page (PDP) as structured JSON. Pass a product URL or numeric product ID, optionally with subdomain, and receive localized title, HD images, tiered pricing, seller profile, attributes and lead times.
Product pages are rendered in a headless browser and parsed from window.detailData. Costs 2 credits per call (browser rendering). Target *.alibaba.com hosts must be whitelisted for rendering.
Pair with Alibaba Search to discover listing_url values first.
GET https://api.piloterr.com/v2/alibaba/product?query=1601175379813
GET https://api.piloterr.com/v2/alibaba/product?query=1601175379813&subdomain=portuguese
GET https://api.piloterr.com/v2/alibaba/product?query=https://www.alibaba.com/product-detail/Custom-Neon-Light-Acrylic-Neon-Sign_1601175379813.html
Via POST:
POST https://api.piloterr.com/v2/alibaba/product
Content-Type: application/json
{"query": "1601175379813", "subdomain": "portuguese", "return_page_source": false}
| Parameter |
Type |
Required |
Description |
query |
string |
yes |
Product URL or numeric product ID |
subdomain |
string |
no |
Locale (portuguese, french, www, … or french.alibaba.com) |
return_page_source |
boolean |
no |
Rendered HTML as {"result": "..."} (default: false) |
| Format |
Example |
Resolved URL |
| Numeric ID |
1601175379813 |
https://www.alibaba.com/product-detail/_1601175379813.html |
| ID + subdomain |
query=1601175379813, subdomain=portuguese |
https://portuguese.alibaba.com/product-detail/_1601175379813.html |
| Full URL |
https://www.alibaba.com/product-detail/..._1601175379813.html |
Host kept as-is |
| URL + subdomain override |
product URL on www, subdomain=french |
Host replaced with french.alibaba.com |
When query is a localized URL (https://french.alibaba.com/...), the host is preserved. Invalid subdomain returns 400.
Same hosts as Search: www, portuguese, french, spanish, german, italian, russian, japanese, korean, arabic, turkish, thai, vietnamese, indonesian, dutch, polish, hindi (each as {subdomain}.alibaba.com).
| Field |
Type |
Description |
product_id |
number |
Product ID |
title |
string |
Localized product title |
url |
string |
Canonical product URL (no query string) |
locale_host |
string |
Host used for rendering (portuguese.alibaba.com, …) |
images |
string[] |
HD image URLs |
price.min / price.max |
number | null |
Price range from productRangePrices or ladder |
price.display |
string | null |
Localized formatted price |
price.unit |
string |
Unit label (Peça, pièce, …) |
price.quantity_prices |
object[] |
Quantity tiers: { min_quantity, max_quantity?, price, price_usd?, display } |
seller.company_name |
string |
Legal company name |
seller.company_id |
number |
Company ID |
seller.country |
string |
Country code (CN, …) |
seller.years |
string |
Years on Alibaba |
seller.is_gold_supplier |
boolean |
Gold Supplier flag |
seller.profile_url |
string |
Company profile URL |
attributes |
object[] |
{ name, value } product specs (may include duplicates) |
trade.sales_volume |
string |
Sold volume label (localized) |
trade.lead_time |
object[] |
{ min_quantity, max_quantity, process_period_days } |
- Alibaba Search to discover listings
- Alibaba Product for full PDP data (this endpoint)
| Code |
Meaning |
400 |
Missing or invalid query, or invalid subdomain |
404 |
Rendered page not parseable (window.detailData missing) |
500 |
Rendering or parsing error |
- Canonical
url keeps the SEO slug (.../product-detail/Custom-Neon-Light-Acrylic-Neon-Sign_1601175379813.html), not the bare _ID.html shortcut used internally for bare IDs.
price.quantity_prices[].max_quantity is omitted on the open-ended top tier (e.g. min_quantity: 500).trade.lead_time[].max_quantity may be omitted on the last tier when Alibaba leaves it open.attributes often contains duplicate { name, value } pairs (basic + other property blocks); consumers should dedupe if needed.- Requires
*.alibaba.com hosts to be authorized for browser rendering.
- Quantity tiers come from
productLadderPrices; simple ranges from productRangePrices.
attributes may list the same spec twice (basic + other property blocks on Alibaba).- Costs 2 credits per call (browser rendering).
- Supplier due diligence: Gold Supplier status, country, years on platform
- MOQ and tier pricing: extract
quantity_prices for procurement models
- Localized catalogs: fetch French, Portuguese or German PDP copy from the same product ID
- Lead time planning: use
trade.lead_time ranges for supply-chain estimates
