Uzum APIuzum.uz ↗
Access Uzum Market product listings, categories, seller profiles, reviews, and stock data via 9 structured API endpoints returning prices in UZS tiyin.
What is the Uzum API?
The Uzum Market API provides 9 endpoints covering product search, category browsing, seller discovery, customer reviews, and stock aggregation across uzum.uz, Uzbekistan's largest online marketplace. The get_product_details endpoint returns over 10 fields per product including SKU-level pricing, availability, seller rating, and an HTML description. Whether you need to monitor category inventory with get_all_products_stock or pull seller profiles via get_seller_info, all data comes back as structured JSON.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/854c74bc-8ffb-43f1-9412-d5c355c8c866/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full category tree from the Uzum catalog. Returns all top-level categories with nested children arrays containing subcategories and product counts. Categories are hierarchical - each top-level category has children which may have their own children.
No input parameters required.
{
"type": "object",
"fields": {
"payload": "array of top-level category objects each containing id, title, iconLink, iconSvg, and nested children arrays with subcategories"
},
"sample": {
"data": {
"payload": [
{
"id": 2894,
"title": "Mebel",
"iconSvg": "<svg.../>",
"children": [
{
"id": 17616,
"eco": false,
"adult": false,
"title": "Karavot va matraslar",
"children": [
{
"id": 14557,
"title": "Matraslar",
"children": [],
"productAmount": 74
}
],
"productAmount": 1
}
],
"iconLink": "https://static.uzum.uz/banners/mebel902.png"
}
],
"timestamp": "2026-06-10T09:43:30.497593188"
},
"status": "success"
}
}About the Uzum API
Product and Category Data
The get_categories endpoint returns the full hierarchical catalog tree — each top-level category includes id, title, iconLink, iconSvg, and a nested children array that may itself contain further subcategories. Pass any category id (for example '10020' for Elektronika) to get_category_products to receive paginated product cards with productId, title, minSellPrice, minFullPrice, rating, and feedbackQuantity. Both get_category_products and search_products use offset-based pagination controlled by limit and offset parameters, and both return a total integer so you can calculate page depth.
Product Detail and Reviews
get_product_details accepts a product_id string and returns the full product record: title, HTML description, photos array with high- and low-resolution links, a skuList with per-SKU availableAmount, fullPrice, and sellPrice, plus a nested shop object containing the seller's id, title, and rating. All prices are expressed in UZS tiyin (1 UZS = 100 tiyin). get_product_reviews fetches paginated customer feedback for the same product ID, returning each review's rating, customerName, content, pros, cons, dateCreated, and datePublished as Unix timestamps in milliseconds. Pagination for reviews translates offset to an internal page number using page = offset / limit.
Seller Discovery and Inventory
get_sellers searches shops by name and returns up to 20 results per query, each with id, title, link (slug), avatar, rating, reviewCount, orderCount, and an official boolean flag. Use the returned slug with get_seller_info to retrieve the full seller profile including registrationDate, banner, description, and sellerAccountId. The numeric id from that response feeds directly into get_seller_products to paginate all products listed by that seller.
Bulk Stock Aggregation
get_all_products_stock accepts a category_id and an optional max_products cap (1–5000). It iterates through category product listings in batches and sums availableAmount across all SKUs for each product, returning a stock map of { product_id: quantity } alongside fetched_count and total_products. This makes it practical for category-level inventory snapshots without calling get_product_details per item.
The Uzum API is a managed, monitored endpoint for uzum.uz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when uzum.uz 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 uzum.uz 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?+
- Track price changes in UZS for specific product SKUs using minSellPrice and minFullPrice from get_product_details
- Build a category-level stock monitor by polling get_all_products_stock with a target category_id
- Aggregate seller reputation metrics (rating, reviewCount, orderCount, official status) from get_sellers and get_seller_info
- Index product listings for a vertical search engine using search_products with keyword queries and offset-based pagination
- Analyze customer sentiment by extracting pros, cons, and rating fields from get_product_reviews across a product catalog
- Map the full Uzum category hierarchy for taxonomy or feed-mapping using the nested children arrays from get_categories
- Compare seller product assortments by iterating get_seller_products for multiple seller IDs obtained via get_sellers
| 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 Uzum Market have an official public developer API?+
What does get_all_products_stock return and how does the max_products parameter work?+
stock object mapping each product ID to an integer representing the sum of availableAmount across all of its SKUs. max_products (1–5000) caps how many products are fetched before the endpoint stops paginating, so you can limit scope for large categories. The response also includes fetched_count (products actually retrieved) and total_products (full category size upstream), so you can tell whether the cap was reached.Are seller search results limited in any way?+
get_sellers returns a maximum of 20 sellers per query regardless of the limit parameter. If you need more than 20 matching sellers, you will need to run additional queries with different search terms or refine the query string. You can fork this API on Parse and revise it to support broader seller enumeration.