Discover/Yandex API
live

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.

Endpoint health
verified 1h ago
search_products
get_search_suggestions
2/2 passing latest checkself-healing
Endpoints
2
Updated
2h ago

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.

Try it
Page number for pagination (1-based).
Sort order for results.
Search query text (product name, brand, category, etc.).
api.parse.bot/scraper/bf0d8525-2102-46d1-84e3-0fd50aed24c3/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
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'
Python SDK · recommended

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")
All endpoints · 2 totalmissing one? ·

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.

Input
ParamTypeDescription
pageintegerPage number for pagination (1-based).
sortstringSort order for results.
queryrequiredstringSearch query text (product name, brand, category, etc.).
Response
{
  "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.

Reliability & maintenanceVerified

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.

Last verified
1h ago
Latest check
2/2 endpoints passing
Maintenance
Monitored & self-healing
Will this API break when the source site changes?+
It's built not to. Every endpoint is health-checked on a schedule with automated test probes. When the source site changes and a check fails, the API is automatically queued for repair and re-verified — that's the self-healing layer. Each API page shows when its endpoints were last verified. And because marketplace APIs are shared, any fix reaches everyone using it.
Is this an official API from the source site?+
No — Parse APIs are independent, managed REST wrappers over publicly available data. That is the point: where a site has no official API (or only a limited one), Parse gives you a maintained, monitored endpoint for that data and keeps it working as the site changes — so you get a stable contract over a source that never promised one.
Can I fix or extend this API myself if I need a new endpoint or field?+
Yes — and you don't have to wait on us. This API was generated by the Parse agent, which stays attached. Describe the change in plain English ("add an endpoint that returns reviews", "fix the price field") in the revise box on the API page or via the revise_api MCP tool, and the agent rebuilds it against the live site in minutes. Contributing the change back to the public API is free.
What happens if I call an endpoint that has an issue?+
Errors are machine-readable: a bad call returns a clean status with the list of available endpoints and a repair hint, so an agent (or you) can recover or trigger a fix instead of failing silently. Confirmed failures feed the automatic repair queue.
Common use cases
  • 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.
Pricing & limitsSee full pricing →
TierPriceCredits/monthRate limit
Free$0/mo1005 req/min
Hobby$30/mo1,00020 req/min
Developer$100/mo5,000100 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.

Frequently asked questions
Does Yandex Market have an official developer API?+
Yandex does offer a Yandex Market Partner API (https://yandex.ru/dev/market/partner-api/) intended for sellers and partners. It is not a public product-search API and requires seller credentials. This Parse API covers consumer-facing product search and suggestions on the Uzbekistan storefront without requiring partner credentials.
What does the search_products endpoint return for each product offer?+
Each item in the 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?+
The endpoint accepts an optional 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.
Does the API return individual product detail pages, reviews, or seller ratings?+
Not currently. The API covers product listing search results (prices, discounts, delivery, vendor info) and search autocomplete suggestions. It does not expose individual product detail pages, user reviews, or seller rating data. You can fork this API on Parse and revise it to add an endpoint targeting those resources.
Is the data limited to Uzbekistan, or does it also cover other Yandex Market regions?+
The API is scoped specifically to market.yandex.uz and returns results from the Uzbekistan storefront, with all pricing in UZS. It does not cover market.yandex.ru or other regional Yandex Market domains. You can fork this API on Parse and point it at a different regional domain to cover other markets.
Page content last updated . Spec covers 2 endpoints from market.yandex.uz.
Related APIs in EcommerceSee all →
walmart.com API
Retrieve product data from Walmart.com including pricing, descriptions, availability, reviews, and category listings. Access real-time product information to search by keyword, look up items by ID or URL, and browse department categories.
homedepot.com API
Search and browse Home Depot's product catalog to compare pricing, check real-time availability, and review detailed product specifications. Find products across all categories, look up store locations and hours, and check fulfillment options including in-store pickup and delivery.
amazon.co.uk API
Access data from amazon.co.uk.
ikea.com API
Search and browse IKEA's full product catalog to find items by category, compare measurements, read customer reviews, and check real-time store availability and current deals. Discover new arrivals and best-selling products to help you shop smarter and find exactly what you need.
newegg.com API
Search Newegg's product catalog and retrieve listings, specifications, customer reviews, Q&A, category trees, and daily deals.
amazon.fr API
Scrape product data from Amazon.fr, including search results, product details, specifications, seller offers, customer reviews, and current deals.
idealo.de API
Search for products on Idealo.de and retrieve detailed information including current seller offers, price history, technical specifications, and user and expert reviews. Compare prices across sellers and access comprehensive product data to evaluate deals.
zara.com API
Shop Zara's entire catalog by browsing categories, searching for specific items, and viewing detailed product information including measurements and related products. Find nearby store locations, check real-time inventory availability, and get shipping details all in one place.