Alibaba APIin19067452907ubjs.trustpass.alibaba.com ↗
Access product categories, listings with pricing and images, and detailed specs from an Alibaba supplier store via 3 structured JSON endpoints.
What is the Alibaba API?
This API provides structured access to an Alibaba supplier store specializing in color diamonds, covering 3 endpoints that return the full category tree, paginated product listings with pricing and images, and detailed per-product data including SKU attributes, seller information, and review summaries. The get_product_details endpoint alone returns over 10 distinct fields, including sku_prices, sku_attributes, and reviews.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/2f9e0e66-a3c8-46ca-b955-d558622fde99/list_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the full product category tree for the store. Each category has an ID, name, and optional children subcategories. Category IDs can be used with list_products to filter by category.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects with id, name, url, and optional children"
},
"sample": {
"data": {
"categories": [
{
"id": 911804179,
"url": "/productgrouplist-911804179/LAB_GROWN_CERTIFIED_DIAMONDS.html",
"name": "LAB GROWN CERTIFIED DIAMONDS",
"children": [
{
"id": 912102119,
"url": "/productgrouplist-912102119/ROUND_BRILLIANT_CUT.html",
"name": "ROUND BRILLIANT CUT"
},
{
"id": 911592865,
"url": "/productgrouplist-911592865/OVAL_CUT_DIAMOND.html",
"name": "OVAL CUT DIAMOND"
}
]
},
{
"id": 911832919,
"url": "/productgrouplist-911832919/COLOR_DIAMOND.html",
"name": "COLOR DIAMOND"
}
]
},
"status": "success"
}
}About the Alibaba API
Category and Product Navigation
The list_categories endpoint returns the complete category tree for the store, with each entry carrying an id, name, url, and optional nested children. These category IDs feed directly into list_products via the category_id parameter, letting you scope results to a specific subcategory such as a particular diamond cut or clarity grade.
Product Listings
The list_products endpoint returns up to 16 products per page. You control pagination with the page integer parameter and optionally narrow results with category_id. The response envelope includes total, current_page, page_size, category_name, and an array of product objects, each containing id, title, price, and image. When no category_id is supplied, the endpoint returns all products sorted by last modified date.
Detailed Product Data
The get_product_details endpoint accepts a product_id (numeric string obtained from list_products) and returns the full product record. Key fields include sku_attributes (variant dimensions such as color, cut, and clarity), sku_prices (a map from SKU combination keys to price info), images (array of image URLs), seller (name, country, membership years), reviews (average_rating and total_count), and both a formatted price string and a numeric price_value. The unit field indicates the pricing unit, such as carat or piece.
The Alibaba API is a managed, monitored endpoint for in19067452907ubjs.trustpass.alibaba.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when in19067452907ubjs.trustpass.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 in19067452907ubjs.trustpass.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 per-carat pricing across SKU variants using
sku_pricesandsku_attributesfromget_product_details - Build a category-browsing interface by consuming the nested tree from
list_categories - Monitor price changes over time by polling
list_productssorted by last modified date - Aggregate seller trust signals by extracting
seller.membership_yearsandreviews.average_ratingacross multiple products - Paginate through the full product catalog using the
pageparameter and thetotalfield fromlist_products - Filter diamond listings by a specific grade category using
category_idvalues fromlist_categories - Enrich product records with full image galleries by combining
list_productsIDs withget_product_detailsimagesarrays
| 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 offer an official developer API for supplier store data?+
What does `get_product_details` return beyond basic price and title?+
price and title, the endpoint returns sku_attributes (variant dimensions like color, cut, and clarity), sku_prices (a keyed map of SKU combinations to price info), an images array, a seller object with country and membership years, a reviews object with average_rating and total_count, a numeric price_value, and a unit field indicating how the price is measured (e.g. carat or piece).Does `list_products` support sorting or filtering beyond category?+
list_products supports filtering by category_id and pagination via page. Without a category filter, results are sorted by last modified date. Sorting by price, rating, or sales volume is not covered. You can fork this API on Parse and revise it to add additional sort or filter parameters.Are buyer contact details or order history available through this API?+
How many products does `list_products` return per request, and is there a way to get more?+
page_size field. To retrieve more, increment the page parameter and use the total field in the response to determine how many pages exist for a given category or the full catalog.