Yandex APImarket.yandex.uz ↗
Search products and get autocomplete suggestions from Yandex Market Uzbekistan. Returns prices in UZS, discount details, delivery info, and vendor data.
What is the Yandex API?
The Yandex Market Uzbekistan API provides 2 endpoints for querying product listings and search suggestions on market.yandex.uz. The search_products endpoint returns paginated offers with pricing in UZS, discount breakdowns, delivery details, and vendor information — each item identified by a unique ware_id and product_id. A second endpoint, get_search_suggestions, delivers up to 10 autocomplete terms for partial query input.
curl -X GET 'https://api.parse.bot/scraper/bf0d8525-2102-46d1-84e3-0fd50aed24c3/search_products?page=1&sort=dpop&query=sneakers' \ -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 market-yandex-uz-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: Yandex Market Uzbekistan — search products, get suggestions."""
from parse_apis.market_yandex_uz_api import YandexMarket, Sort, NotFoundError
client = YandexMarket()
# Search for sneakers sorted by popularity, capped at 5 results
for product in client.products.search(query="sneakers", sort=Sort.POPULARITY, limit=5):
print(product.title, product.price, product.currency, f"discount={product.discount_percent}%")
# Get the cheapest product using price-ascending sort
cheapest = client.products.search(query="sneakers", sort=Sort.PRICE_ASC, limit=1).first()
if cheapest:
print(f"Cheapest: {cheapest.title} at {cheapest.price} {cheapest.currency}")
print(f" Crossborder: {cheapest.is_crossborder}, Delivery: {cheapest.delivery_text}")
# Autocomplete suggestions for a partial query
for suggestion in client.suggestions.list(query="sneak", limit=5):
print(f" Suggest: {suggestion.text} (type={suggestion.type})")
# Typed error handling for a search that may fail upstream
try:
result = client.products.search(query="xyznonexistent12345", sort=Sort.RATING, limit=1).first()
if result:
print(result.title)
except NotFoundError as exc:
print(f"Not found: {exc}")
print("exercised: products.search / suggestions.list / Sort enum / NotFoundError catch")
Search for products on Yandex Market Uzbekistan. Returns paginated product listings with price, discount, delivery, and vendor information. Results are auto-iterated across pages. Each item includes a ware_id (unique offer identifier), product_id, pricing in UZS, discount details, and estimated delivery dates.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| sort | string | Sort order for results. |
| queryrequired | string | Search query text (product name, brand, category, etc.). |
{
"type": "object",
"fields": {
"page": "integer",
"sort": "string",
"items": "array of product offer objects",
"query": "string",
"total": "integer",
"page_count": "integer"
},
"sample": {
"page": 1,
"sort": "dpop",
"items": [
{
"slug": "puma-rebound-v6-mid-393832",
"price": 439771,
"title": "Кеды Rebound V6 Mid",
"sku_id": "103237519770",
"ware_id": "ApdYxQjvgSduUO-861lVlw",
"currency": "UZS",
"old_price": 549791,
"vendor_id": 7342300,
"product_id": 1072688483,
"business_id": 924574,
"supplier_id": 216417845,
"delivery_text": "4 – 7 июл",
"is_crossborder": true,
"discount_percent": 20
}
],
"query": "sneakers",
"total": 595,
"page_count": 30
}
}About the Yandex API
Product Search
The search_products endpoint accepts a required query parameter — a product name, brand, or category term — and returns paginated offer listings from Yandex Market Uzbekistan. The response includes total match count, page_count, and an items array of product offer objects. Each item carries a ware_id (unique offer identifier), a product_id, pricing in UZS, discount details, and delivery information alongside vendor data. The optional page parameter (1-based) controls pagination, and the optional sort parameter controls result ordering.
Search Suggestions
The get_search_suggestions endpoint accepts a partial query string and returns up to 10 suggestion objects, each containing a type and text field. This is suitable for building search-as-you-type interfaces or validating query terms before running a full product search.
Coverage and Currency
All pricing data is denominated in Uzbekistani Som (UZS), reflecting the localized catalog of market.yandex.uz. Listings include discount fields, so price comparisons can account for promotional pricing. The two endpoints together cover query entry (suggestions) and results retrieval (product listings), but do not extend to individual product detail pages, seller profiles, or review data.
The Yandex API is a managed, monitored endpoint for market.yandex.uz — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when market.yandex.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 market.yandex.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?+
- Aggregate UZS-denominated product prices across categories for market research in Uzbekistan.
- Build a price comparison tool that tracks discount fields over time for specific ware_ids.
- Implement a search-as-you-type product finder using get_search_suggestions with partial query strings.
- Monitor vendor availability and pricing changes for specific product queries on the Uzbek market.
- Populate a product catalog by iterating paginated search results using the page parameter.
- Identify promotional items by filtering offers where discount details are populated in search results.
- Validate and expand keyword lists for Uzbekistan e-commerce campaigns using autocomplete suggestions.
| 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 Yandex Market have an official developer API?+
What does the search_products endpoint return for each product offer?+
items array includes a ware_id (unique offer identifier), a product_id, pricing in UZS, discount details, delivery information, and vendor data. The top-level response also provides total result count, page_count, the active sort value, and the original query.Does pagination work automatically, or do I need to loop through pages manually?+
page parameter (1-based integer) so you control which page is fetched. The response includes page_count and total fields so you can determine how many pages exist and iterate accordingly.