# DNS (dns-shop.ru) API scraper — Russia's largest electronics retailer: search the catalogue and read any product with its current price in RUB, the struck was-price and discount, the monthly credit instalment, the shop count and delivery date in the city, the specs, the brand, the exact rating and review count and the weekly price history. No account.

> 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.
> ReefAPI engine `dns-shop` · 2 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/dns-shop/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free except verified SHEIN NOT_FOUND on product/detail and price (4 credits).
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Send the key as `Authorization: Bearer <key>`, or put it in the URL (`?key=<key>`) when the client has no header field, as ChatGPT does.

## Endpoints

### POST https://api.reefapi.com/dns-shop/v1/search — 3 credits
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.

**Parameters:**
- `query` (string, required) — What a shopper would type into DNS: 'iphone 15', 'телевизор', 'rtx 4070', 'ноутбук'. Russian or Latin. DNS often answers inside its best-matching category (the response says which in `category`).
- `page` (integer, optional, default 1) — Result page, 1-based; DNS shows 24 products per page. `has_more` says whether another page exists.

**Returns:** results[]{product_id, guid, code, name, url, price, price_old, discount_pct, credit_monthly, credit_months, orderable, prepay_only, short_specs, specs{}, image, rating, reviews_label, review_count, avail_status, is_markdown}, total, category, category_id, page, last_page, has_more, query

**Example request body:**
```json
{
  "query": "iphone 15"
}
```

### POST https://api.reefapi.com/dns-shop/v1/product — 3 credits
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.

**Parameters:**
- `product_id` (string, required) — A product's `product_id` from `search` (16 hex characters, e.g. '00eb38374882ed20') or its full dns-shop.ru product URL.

**Returns:** product{product_id, guid, code, name, url, brand, price, price_old, discount_pct, credit_monthly, credit_months, orderable, prepay_only, in_stock, store_count, availability[], delivery, rating, review_count, breadcrumbs[], category_id, description, images[], spec_groups[]{group, specs[]{name,value}}, price_history[]{month, week, price}, ld_price, ld_availability, price_mismatch, city}

**Example request body:**
```json
{
  "product_id": "00eb38374882ed20"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=dns-shop
- Human docs page: https://reefapi.com/docs/dns-shop
- Overview page: https://reefapi.com/dns-shop-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt