Alibaba APIalibaba.com ↗
Search Alibaba.com Ready to Ship products and fetch full product details including price tiers, MOQ, specs, images, and supplier data via two endpoints.
What is the Alibaba API?
The Alibaba.com API provides two endpoints — search_products and get_product — covering ready-to-ship inventory across the US Alibaba marketplace. A single search query returns up to 48 product listings per page with pricing, supplier info, and total result counts, while get_product resolves a product ID into tiered pricing, minimum order quantities, shipping dimensions, review scores, and multiple image URLs.
curl -X GET 'https://api.parse.bot/scraper/ba2822dd-f985-4faa-8d3b-81d795bda2a7/search_products?page=1&sort=best_match&query=7+inch+1024x600+ips+rgb' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace alibaba-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Alibaba SDK — bounded, re-runnable; every call capped."""
from parse_apis.Alibaba_Product_Search_API import Alibaba, Sort, ProductNotFound
client = Alibaba()
# Search for Ready to Ship products with pagination auto-iterated.
for item in client.product_summaries.search(query="7 inch 1024x600 ips rgb", sort=Sort.BEST_MATCH, limit=3):
print(item.title, item.price, item.company_name)
# Drill-down: take one item and navigate to full product details.
hit = client.product_summaries.search(query="raspberry pi display", limit=1).first()
if hit:
detail = hit.details()
print(detail.title, detail.price_display, detail.moq)
for tier in detail.price_tiers[:3]:
print(f" {tier.min_quantity}-{tier.max_quantity}: {tier.unit_price}")
for spec in detail.specifications[:3]:
print(f" {spec.name}: {spec.value}")
# Typed error handling for a product lookup.
try:
product = client.products.get(product_id="9999999999999")
print(product.title)
except ProductNotFound as e:
print(f"not found: {e.product_id}")
print("exercised: product_summaries.search / ProductSummary.details / products.get")
Search Alibaba.com for Ready to Ship products. All results are pre-filtered to Ready to Ship inventory. Returns product listings with pricing, supplier info, and service badges. Results are auto-iterated across pages (48 products per page).
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for results. Omitted returns relevance-sorted results. |
| queryrequired | string | Search keywords describing the product (e.g. '7 inch 1024x600 ips rgb'). |
{
"type": "object",
"fields": {
"products": "array of product listings with title, price, supplier info, and selling points",
"total_count": "integer total number of matching products",
"total_pages": "integer total number of pages available",
"current_page": "integer current page number"
},
"sample": {
"data": {
"products": [
{
"is_ad": false,
"price": "$9.80",
"title": "7 Inch Tft Display RGB IPS 40PIN 1024X600 LCD DISPLAY SCREEN MODULE",
"image_url": "https://s.alicdn.com/@sc04/kf/H1b5efa7da8b34e1a91b465d876d637c2U.png_300x300.png",
"min_order": "Min. order: 2 pieces",
"company_id": "241332330",
"product_id": "62497841129",
"product_url": "//www.alibaba.com/product-detail/7-Inch-Tft-Display-RGB-IPS_62497841129.html",
"sold_orders": "2 sold",
"company_name": "Shenzhen Chuanglixin Electronics Co., Ltd.",
"country_code": "CN",
"review_count": "5",
"review_score": "4.8",
"selling_points": [
{
"text": "FREE shipping",
"type": "free_shipping"
},
{
"text": "5-day dispatch",
"type": "x_day_dispatch"
}
],
"supplier_years": "9 yrs",
"supplier_service_score": "5.0"
}
],
"total_count": 1254,
"total_pages": 27,
"current_page": 1
},
"status": "success"
}
}About the Alibaba API
Search Ready-to-Ship Products
The search_products endpoint accepts a query string (e.g. '7 inch 1024x600 ips rgb') and returns an array of product listings filtered exclusively to ready-to-ship inventory — no custom manufacturing lead times. Each page returns up to 48 results. The response includes total_count, total_pages, and current_page fields so you can paginate systematically using the page parameter. An optional sort parameter controls result ordering; omitting it defaults to relevance.
Full Product Detail
Pass a product_id (a numeric string obtained from search_products results) to get_product to retrieve a complete product record. The response includes price_tiers — an array of objects each specifying a quantity range and unit price — alongside moq (minimum order quantity), price_display (a formatted range string), and shipping_info with unit_weight, unit_size, and lead_time. Product images are returned as image_urls, an array of full-size URLs. Review data comes back as review_count and review_score.
Data Coverage and Scope
All results reflect the Alibaba.com US site and are pre-filtered to ready-to-ship listings, so out-of-stock or made-to-order items do not appear. Product IDs are stable identifiers that can be stored and re-queried to track price tier or MOQ changes over time. Supplier information is included at the listing level in search_products, allowing quick supplier filtering before fetching full product details.
The Alibaba API is a managed, monitored endpoint for alibaba.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when alibaba.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 alibaba.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?+
- Compare price tiers across multiple suppliers for a specific component using
price_tiersfromget_product - Build a sourcing dashboard that tracks MOQ and unit price changes for a saved list of product IDs
- Identify the lowest-MOQ ready-to-ship option for a product category by paginating
search_productsand filtering onmoq - Aggregate
review_scoreandreview_countdata across competing product listings to surface highest-rated suppliers - Extract
shipping_infofields to estimate landed cost by combining unit weight, size, and lead time with freight rates - Monitor
total_countfor a given query over time to gauge ready-to-ship inventory availability trends - Pull
image_urlsarrays for product catalog enrichment or visual similarity comparisons
| 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.
Does Alibaba.com have an official developer API?+
What does `get_product` return that `search_products` does not?+
search_products returns summary-level data: title, a price display string, and high-level supplier info. get_product adds structured price_tiers with per-quantity unit prices, moq, shipping_info (unit weight, unit size, lead time), full-resolution image_urls, and review_score with review_count. For sourcing decisions that depend on volume pricing or logistics, you need the get_product call.Are results limited to ready-to-ship products only?+
search_products is pre-filtered to ready-to-ship inventory, so made-to-order and custom-manufacturing listings are excluded. If you need to search the broader Alibaba catalog including custom-order suppliers, that scope is not currently covered. You can fork this API on Parse and revise it to add a general catalog search endpoint without the ready-to-ship filter.Can I retrieve seller profile pages or storefront-level data?+
How does pagination work and what is the page size?+
search_products call returns up to 48 products. The response includes total_pages so you can determine how many calls are needed to walk the full result set. Pass the page parameter (1-based integer) to retrieve subsequent pages. There is no cursor or token — page numbers are stateless.