Alibaba APIalibaba.com ↗
Search Alibaba.com Ready to Ship listings via API. Get product titles, pricing, supplier info, and service badges with full pagination support.
What is the Alibaba API?
The Alibaba.com API exposes 1 endpoint — search_products — that queries the Ready to Ship catalog and returns up to 48 product listings per page, including title, price range, supplier details, and service badges. Each response includes total_count and total_pages fields so you can paginate through the full result set programmatically. All results are pre-filtered to in-stock inventory, removing listings that require custom manufacturing lead times.
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_com_api import Alibaba, Sort, ParseError
client = Alibaba()
# Search for Ready to Ship products with pagination auto-iterated.
for product in client.products.search(query="7 inch 1024x600 ips rgb", limit=3):
print(product.title, product.price, product.company_name)
# Drill-down: take one item and inspect its details.
item = client.products.search(query="raspberry pi display", sort=Sort.ORDERS, limit=1).first()
if item:
print(item.product_id, item.title, item.price, item.min_order)
for sp in item.selling_points[:3]:
print(f" - {sp.text}")
# Typed error handling.
try:
for p in client.products.search(query="hdmi lcd module", limit=2):
print(p.title, p.review_score, p.supplier_years)
except ParseError as e:
print(f"error: {e}")
print("exercised: products.search")
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
What the API Returns
The search_products endpoint accepts a query string and returns an array of products, each carrying a product title, price (typically expressed as a per-unit or per-lot range), supplier name, and selling-point highlights such as verified supplier badges or trade assurance indicators. The response envelope also includes total_count (total matching SKUs), total_pages, and current_page so your application can walk through result sets without guessing offsets.
Filtering and Sorting
Two optional parameters control how results are ordered and which page is returned. The page parameter is 1-based and selects the result window (48 products per page). The sort parameter accepts sort-order tokens; omitting it returns results ranked by relevance. There is no additional client-side category or price filter parameter at the endpoint level — narrowing by product attribute must be done through the query string itself (e.g. "7 inch 1024x600 ips rgb").
Ready to Ship Scope
Every result returned by this API is pre-scoped to Alibaba's Ready to Ship inventory on the US site. This means listings without confirmed stock availability are excluded automatically. This scope is fixed and cannot be toggled off — if you need to search the full catalog including made-to-order listings, that falls outside this API's coverage.
Supplier and Pricing Fields
The products array entries include supplier-level metadata alongside product data. Expect fields covering the seller's store name, country of origin where available, and any service or quality badges (such as Trade Assurance or Gold Supplier status) that Alibaba surfaces on the listing card. Pricing is returned as shown on the listing — typically a minimum order quantity paired with a unit price range rather than a single fixed price.
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?+
- Build a price comparison tool for sourcing teams by querying specific component keywords and extracting per-unit price ranges across suppliers.
- Monitor supplier badge status (Trade Assurance, Gold Supplier) for a tracked set of product keywords to qualify vendors.
- Aggregate
total_countover time for a query to track how Ready to Ship inventory for a product category expands or contracts. - Feed product titles and prices into a procurement dashboard that alerts buyers when new listings appear for a target SKU.
- Paginate through all result pages for a niche industrial component query to build a complete supplier shortlist.
- Cross-reference supplier names returned in the API with internal vendor databases to surface new potential partners.
- Populate a product catalog prototype with real wholesale pricing data for market research or investor demos.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. 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 the `products` array actually contain per listing?+
products includes a product title, price (unit price range tied to minimum order quantity), supplier name and country, and any service badges the listing carries (such as Trade Assurance or verified supplier indicators). It does not include full product descriptions, specification sheets, or image URLs. You can fork this API on Parse and revise it to capture additional listing fields.Can I filter results by price range or product category through the API?+
search_products endpoint accepts a query string and an optional sort parameter, but there are no dedicated price-range or category filter parameters. Attribute narrowing must be handled through more specific query strings. You can fork the API on Parse and revise it to add filter parameters mapped to category or price inputs.Does the API return individual product detail pages or reviews?+
How fresh are the results, and does pagination cover the full catalog?+
total_pages field tells you exactly how many pages exist for a given query, and incrementing the page parameter (1-based) retrieves each subsequent window of 48 products. Inventory availability can change between paginated requests, so very large crawls may encounter minor inconsistencies between pages.