dns-shop.ru APIdns-shop.ru ↗
Access DNS Shop's product catalog, technical specs, customer reviews, category tree, and 1000+ Russian store locations via a structured JSON API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/1bf6ff65-49f0-48c3-bd2a-a78f2dec40aa/get_catalog_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all top-level and subcategories from the catalog. Note: Behind Qrator antibot, may be intermittently blocked.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array"
},
"sample": {
"status": "blocked",
"message": "Qrator JS challenge - site requires browser-based JavaScript challenge solving",
"block_type": "ip_ban"
}
}About the dns-shop.ru API
The DNS Shop API covers 7 endpoints that expose the full product catalog of dns-shop.ru, one of Russia's largest electronics retailers. Use search_products to run keyword queries across the catalog and get back paginated results with prices and product IDs, use get_product_specs to retrieve structured technical specification objects, and use get_stores to pull location data — addresses, GPS coordinates, phone numbers, and working hours — for every physical DNS branch.
Product Catalog and Search
search_products accepts a required query string and an optional page integer, returning products (array), total_results (integer), and the echoed query and page values. get_products_by_category takes a category_id — either a short ID or a full URL — and returns paginated product arrays for that category node. To discover valid category IDs, call get_catalog_categories, which returns the full categories array covering both top-level departments and subcategories with no required parameters.
Product Details and Specifications
get_product_details accepts a product_id (short ID or full URL) and returns id, url, title, price (integer, in rubles), article (the SKU), images (array), and a specs object containing key–value technical attributes. If you only need the specifications, get_product_specs accepts the same product_id param and returns just the specs object — useful for minimizing payload size when price and images are not required.
Reviews and Store Locations
get_product_reviews accepts a product_id UUID plus optional limit and offset integers for pagination, returning a total count and an opinions array of individual reviews. get_stores requires no parameters and returns an array of store objects — each with id, name, address, city, phone, time (working hours string), mark (landmark description), lat, lon, and metroInfo — plus a total_stores count.
Availability Note
All seven endpoints are available on the API, but the six product-catalog endpoints (search, category browsing, product details, specs, and reviews) sit behind Qrator antibot protection on dns-shop.ru and may return intermittent errors. The store-location endpoint (get_stores) is served from an unprotected subdomain and is consistently reliable.
- Build a price-tracking tool that polls
get_product_detailsfor thepricefield on specific product IDs over time. - Aggregate technical specifications from
get_product_specsacross a category to build comparison tables for electronics buyers. - Map all DNS store branches in a given city using
lat,lon,address, andphonefields fromget_stores. - Create a review sentiment pipeline by ingesting
opinionsarrays fromget_product_reviewswith offset-based pagination. - Populate a product catalog index by crawling
get_catalog_categoriesfor IDs and then callingget_products_by_categoryfor each node. - Monitor SKU availability and pricing changes by combining
articleandpricefields fromget_product_detailsacross keyword searches.
| 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 | 250 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 DNS Shop have an official developer API?+
What does get_stores return and how current is the location data?+
get_stores returns an array of every physical DNS retail branch in Russia. Each store object includes id, name, address, city, phone, time (working hours), mark (a human-readable landmark note), lat, lon, and metroInfo. The total number of stores is returned in total_stores. This endpoint is not behind bot protection and is the most reliably available endpoint in the API.Can I filter search results or product listings by price range, brand, or other attributes?+
search_products supports only a keyword query and a page number — no server-side filtering by price, brand, or rating is currently available. get_products_by_category similarly supports only category_id and page. You can fork the API on Parse and revise it to add filtered browsing endpoints.Are product availability or stock status fields exposed?+
get_product_details returns id, url, title, price, article, images, and specs, but does not include an in-stock flag or warehouse quantity. You can fork the API on Parse and revise it to add stock-status data if that field becomes accessible.How reliable are the product-catalog endpoints given the antibot note?+
search_products, get_products_by_category, get_catalog_categories, get_product_details, get_product_specs, get_product_reviews) all sit behind Qrator antibot on dns-shop.ru and may return errors intermittently. Retry logic is advisable for production workloads. get_stores is served from a different subdomain and is not affected by this restriction.