DNS API & Scraper
The DNS API turns dns-shop.ru, Russia's largest consumer-electronics retailer, into JSON in two actions.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
search takes what a shopper would type (Russian or Latin) and returns 24 products per page: product_id, the product code, the name, the current price in rubles, the struck was-price and discount when DNS shows one, the monthly credit instalment, whether the product can be ordered, the key specs DNS prints on the tile, the rating and review label, the image and the URL. The response also names the category DNS answered in, the source's own product total and the last page. product takes a product_id from search (or a product URL) and returns the full record: price, was-price, credit, whether it is in stock and in how many shops, the pickup line and the next home-delivery date, the brand, description and images, the exact rating and review count, the category path, the specification groups printed on the product card and DNS's own weekly price history. Prices are for Moscow, in rubles. One ReefAPI key, the standard { ok, data, meta, error } envelope, no DNS account.
What one DNS product returns
Real results read on 2026-10-15. The id from a search row was passed as it is to product in both runs and came back as the same product with the same price.
| product | what the page shows | price / price_old | other fields |
|---|---|---|---|
| Apple iPhone 15 128 GB, product | 57 999 ₽, in stock in 269 shops | 57999 / null | credit_monthly 5654 for 12 months, rating 4.83 from 4706 reviews, 24 weekly price points |
| Xiaomi Robot Vacuum X20+, search row | 39 999 ₽, struck 46 299 ₽ | 39999 / 46299 | discount_pct 13.6, rating 4.82, reviews_label 1.4k |
| MSI GeForce RTX 4070 VENTUS, search row | out of stock | null / null | orderable false, avail_status out_of_stock |
price is what DNS shows an anonymous visitor today; price_old is the struck price and is null when nothing is discounted. When the product page's structured data carries a different number, both are returned with a price_mismatch flag instead of one being hidden.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/dns-shop/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"query": "iphone 15"
}
}{
"ok": true,
"meta": {
"api": "dns-shop",
"endpoint": "search",
"mode": "live",
"latency_ms": 11923.5,
"record_count": 24,
"bytes": 231596,
"cache_hit": false,
"country": "ru",
"currency": "RUB",
"upstream_requests": 2,
"charged_credits": 3,
"version": "0.1.0",
"request_id": "16e19471f9ba402c",
"queue_ms": 1,
"fetched_at": "2026-10-18T11:42:11.249Z"
},
"data": {
"results": [
{
"product_id": "00eb38374882ed20",
"guid": "00eb3837-4882-11ee-912e-00155d8ed20a",
"code": "5430575",
"name": "6.1\" Смартфон Apple iPhone 15 128 ГБ черный",
"url": "https://www.dns-shop.ru/product/00eb38374882ed20/61-smartfon-apple-iphone-15-128-gb-cernyj/",
"short_specs": "ядер - 6x(3.46 ГГц), 6 ГБ, 1 SIM, Super Retina XDR, 2556x1179, камера 48+12 Мп, NFC, 5G, 4G, GPS, 3349 мА*ч",
"specs": {
"Дисплей": "6.1\", 2556x1179, Super Retina XDR, 60 Гц",
"Связь": "3G, 4G, 5G, eSIM, Nano-SIM",
"Процессор": "Apple A16 Bionic, 6 x 3.46 ГГц",
"Память (ОЗУ/ПЗУ)": "6 ГБ / 128 ГБ",
"Камера": "48+12 Мп"
},
"image": "https://c.dns-shop.ru/thumb/st1/fit/200/200/6927cfdabb0c53c2e85ab5444ca3509d/2258685cc32bbd96de406852bd9b2d94916029658cd6fa120a9f97a4bc0af297.jpg",
"rating": 4.83,
"reviews_label": "4.7k отзывов",
"review_count": null,
"avail_status": "now",
"is_markdown": false,
"price": 57999,
"price_old": null,
"discount_pct": null,
"credit_monthly": 5654,
"credit_months": 12,
"orderable": true,
"prepay_only": false
},
{
"product_id": "07fa1b3f4882ed20",
"guid": "07fa1b3f-4882-11ee-912e-00155d8ed20a",
"code": "5430577",
"name": "6.1\" Смартфон Apple iPhone 15 128 ГБ голубой",
"url": "https://www.dns-shop.ru/product/07fa1b3f4882ed20/61-smartfon-apple-iphone-15-128-gb-goluboj/",
"short_specs": "ядер - 6x(3.46 ГГц), 6 ГБ, 1 SIM, Super Retina XDR, 2556x1179, камера 48+12 Мп, NFC, 5G, 4G, GPS, 3349 мА*ч",
"specs": {
"Дисплей": "6.1\", 2556x1179, Super Retina XDR, 60 Гц",
"Связь": "3G, 4G, 5G, eSIM, Nano-SIM",
"Процессор": "Apple A16 Bionic, 6 x 3.46 ГГц",
"Память (ОЗУ/ПЗУ)": "6 ГБ / 128 ГБ",
"Камера": "48+12 Мп"
},
"image": "https://c.dns-shop.ru/thumb/st1/fit/200/200/f080881503ef139bfe94d1abacfc22cc/df069fba111b4406c32acd081a1a30e375a7f60bb101cdd95c6db8c432edc933.jpg",
"rating": 4.83,
"reviews_label": "4.7k отзывов",
"review_count": null,
"avail_status": "now",
"is_markdown": false,
"price": 57999,
"price_old": null,
"discount_pct": null,
"credit_monthly": 5654,
"credit_months": 12,
"orderable": true,
"prepay_only": false
},
{
"product_id": "fae89ecd4881ed20",
"guid": "fae89ecd-4881-11ee-912e-00155d8ed20a",
"code": "5430565",
"name": "6.1\" Смартфон Apple iPhone 15 256 ГБ черный",
"url": "https://www.dns-shop.ru/product/fae89ecd4881ed20/61-smartfon-apple-iphone-15-256-gb-cernyj/",
"short_specs": "ядер - 6x(3.46 ГГц), 6 ГБ, 1 SIM, Super Retina XDR, 2556x1179, камера 48+12 Мп, NFC, 5G, 4G, GPS, 3349 мА*ч",
"specs": {
"Дисплей": "6.1\", 2556x1179, Super Retina XDR, 60 Гц",
"Связь": "3G, 4G, 5G, eSIM, Nano-SIM",
"Процессор": "Apple A16 Bionic, 6 x 3.46 ГГц",
"Память (ОЗУ/ПЗУ)": "6 ГБ / 256 ГБ",
"Камера": "48+12 Мп"
},
"image": "https://c.dns-shop.ru/thumb/st1/fit/200/200/6927cfdabb0c53c2e85ab5444ca3509d/2258685cc32bbd96de406852bd9b2d94916029658cd6fa120a9f97a4bc0af297.jpg",
"rating": 4.83,
"reviews_label": "4.7k отзывов",
"review_count": null,
"avail_status": "now",
"is_markdown": false,
"price": 68999,
"price_old": null,
"discount_pct": null,
"credit_monthly": 6726,
"credit_months": 12,
"orderable": true,
"prepay_only": false
}
],
"total": 389,
"query": "iphone 15",
"page": 1,
"last_page": 17,
"has_more": true,
"category": "Смартфоны",
"category_id": "17a8a01d16404e77"
}
}What the DNS API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| search | Search DNS by keyword. 24 products per page, each with its current price in RUB, the was-price and discount when DNS shows one, the monthly credit instalment, the key specs DNS prints on the tile, the rating, the review label, the image and the `product_id` that `product` takes. The response names the category DNS answered in and the source's own total. | Pricing teams call search to search DNS by keyword. | query, page |
| product | The full DNS record of one product: price now (RUB), was-price and discount, monthly credit, whether it can be ordered, the shop count and pickup line in the city, the next delivery date, the full specification groups, brand, description, images, the exact rating and review count, the category path and DNS's weekly price history. | Marketplace operators call product to get the full DNS record of one product. | product_id |
Call search from your stack
curl -X POST https://api.reefapi.com/dns-shop/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"iphone 15"}'import requests
r = requests.post(
"https://api.reefapi.com/dns-shop/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "iphone 15"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/dns-shop/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"query": "iphone 15"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.dns-shop.search with {"query":"iphone 15"}.Who uses this API and why
- Track electronics prices in Russia: product for your SKUs, with price, was-price, credit and the weekly price history.
- Watch discounts: search a category and keep the rows where price_old is set.
- Check availability in Moscow: product returns the shop count, pickup line and next delivery date.
- Compare with marketplaces: the same keyword on DNS, Wildberries and Yandex Market gives a retailer price next to marketplace prices.
- Build a catalogue: search pages give product_id, code, name, key specs and image for every product of a category.
Questions developers ask before integrating
Which city are the prices for?
Moscow. Every product record carries a city block with the name and id the page itself reported, so a different city can never pass unnoticed. Choosing another city is not offered yet.
Which prices does it return?
The current price in rubles (price), the struck was-price (price_old) with the computed discount_pct, and the monthly credit instalment with its number of months. On the product record, ld_price is the price in the page's own structured data; on one product in our sample it differed from the shown price, and both were returned with price_mismatch.
Why do some rows have no price?
In our 2026-10-15 runs every row without a price was a product DNS marks out of stock (orderable false), and DNS itself shows no price for those. Discounted ex-display units (markdown) appear in some searches too; they are kept with is_markdown true and no price.
Why is review_count empty on some search rows?
Search tiles print a rounded label such as '4.7k отзывов'. reviews_label returns it exactly as printed and review_count is filled only when the label is an exact number. product always returns the exact count (4 706 for the iPhone 15 above).
What does the price history contain?
The weekly price points DNS draws on the product page, roughly the last six months: month, week range and price for each point (24 points for the iPhone 15 on 2026-10-15).
How many products does one page return?
24 per page. DNS often answers a keyword inside its best-matching category: 'iphone 15' returned 392 smartphones, 'кофемашина' 292 automatic coffee machines over 13 pages. category, category_id, total and last_page are in every response.
How fast is it?
Over two identical runs every positive call succeeded. Median time was about 3 seconds for search and 6.7 seconds for a full product record; the first call after a quiet period can take around 14 seconds.
What is the DNS API?
DNS API is a ReefAPI endpoint group for russia's largest electronics retailer as json: keyword search with the current ruble price, the was-price and discount, the monthly credit instalment and rating on every product, and full product records with shop count, delivery date, specifications and weekly price history. It returns live JSON through POST requests under /dns-shop/v1.
Is the DNS API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. DNS calls use the same shared credit balance as every other ReefAPI engine.
Do I need a DNS login or account?
No login to DNS is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the DNS data?
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the DNS API use?
DNS actions currently cost 3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call DNS from an AI assistant or MCP client?
Yes. Connect ReefAPI once through MCP and your assistant can call dns-shop actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the DNS API a DNS scraper?
It is the managed alternative to a DIY DNS scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same russia's largest electronics retailer as json: keyword search with the current ruble price, the was-price and discount, the monthly credit instalment and rating on every product, and full product records with shop count, delivery date, specifications and weekly price history back as clean JSON.