Документация парсера WB (Wildberries)

curl -X GET \
  "https://bhapi.ru/wb/api/v1/item/by-url?url=https://www.wildberries.ru/catalog/12345/detail.aspx" \
  -H "X-API-Token: ВАШ_API_TOKEN"

{
  "status": "ok",
  "data": {
    "code": 200,
    "msg": "success",
    "data": {
      "item_id": 267995621,
      "product_url": "https://www.wildberries.ru/catalog/267995621/detail.aspx",
      "title": "Брюки домашние в клетку хлопок пижамные",
      "currency": "RUB",
      "price_info": {
        "sale_price": null,
        "pre_sale_price": 1311.0,
        "origin_price": 3100.0,
        "debug": {
          "saleConditions": 134217728
        }
      },
      "delivery_info": {
        "cost": 0.0,
        "currency": "RUB",
        "time1_hours": 3,
        "time2_hours": 20,
        "estimated_hours": 23,
        "estimated_days": 1
      },
      "main_imgs": [],
      "additional_imgs": [],
      "complectation": "",
      "category_name": "",
      "category_path": "",
      "product_props": {},
      "shop_info": {
        "shop_name": "",
        "shop_id": "",
        "seller_id": ""
      },
      "review_info": {
        "rating_star": 0.0,
        "review_count": 0
      },
      "desc": "",
      "source": "wildberries",
      "availability": 3,
      "availability_status": "in_stock",
      "price_size_option_id": 415163657,
      "sizes": [
        {
          "name": "46_182",
          "orig_name": "46_182",
          "option_id": 415163656,
          "availability": 0,
          "availability_status": "out_of_stock",
          "price_info": {
            "sale_price": null,
            "pre_sale_price": null,
            "origin_price": null
          },
          "delivery_info": {
            "cost": null,
            "currency": "RUB",
            "time1_hours": null,
            "time2_hours": null,
            "estimated_hours": null,
            "estimated_days": null
          },
          "stocks": []
        },
        {
          "name": "48_182",
          "orig_name": "48_182",
          "option_id": 415163657,
          "availability": 3,
          "availability_status": "in_stock",
          "price_info": {
            "sale_price": null,
            "pre_sale_price": 1311.0,
            "origin_price": 3100.0,
            "debug": {
              "saleConditions": 134217728
            }
          },
          "delivery_info": {
            "cost": 0.0,
            "currency": "RUB",
            "time1_hours": 3,
            "time2_hours": 20,
            "estimated_hours": 23,
            "estimated_days": 1
          },
          "stocks": [
            {
              "warehouse_id": 6310768265,
              "quantity": 3,
              "delivery_info": {
                "cost": null,
                "currency": "RUB",
                "time1_hours": 3,
                "time2_hours": 20,
                "estimated_hours": 23,
                "estimated_days": 1
              }
            }
          ]
        }
      ],
      "sizes_table": {
        "details_props": [
          "RU",
          "Длина внутреннего шва, в см",
          "Длина внешнего шва, в см",
          "Обхват бедер, в см"
        ],
        "values": [
          {
            "tech_size": "46_182",
            "chrt_id": 415163656,
            "details": [
              "46_182",
              "74",
              "106",
              "104"
            ]
          },
          {
            "tech_size": "48_182",
            "chrt_id": 415163657,
            "details": [
              "48_182",
              "74",
              "106",
              "108"
            ]
          }
        ]
      },
      "data_quality": {
        "is_partial": false,
        "missing_fields": []
      },
      "data_freshness": {
        "assembled_at": "2026-10-22T07:59:44.491696+00:00",
        "cache_hit": false,
        "cache_age_seconds": 0,
        "cache_ttl_seconds": 300,
        "dest": -5818883
      }
    }
  },
  "saved_path": null
}

curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"query":"кроссовки","page":1,"max_links":10,"sort":"rate"}'

{
  "status": "ok",
  "data": {
    "query": "аэрогриль объём 8 литров",
    "page": 1,
    "sort": "rate",
    "total": 11628,
    "links": [
      "https://www.wildberries.ru/catalog/537724276/detail.aspx",
      "https://www.wildberries.ru/catalog/523148127/detail.aspx",
      "... другие ссылки ..."
    ],
    "count": 10,
    "products": [
      {
        "id": 537724276,
        "link": "https://www.wildberries.ru/catalog/537724276/detail.aspx",
        "price": 6381.0,
        "rating": 4.9,
        "feedbacks": 2780,
        "description": "Аэрогриль электрический Air Fryer, Объём 8л,12 программ"
      },
      {
        "id": 523148127,
        "link": "https://www.wildberries.ru/catalog/523148127/detail.aspx",
        "price": 7744.0,
        "rating": 4.9,
        "feedbacks": 394,
        "description": "Аэрогриль электрический для дома 8 литров с Wi-fi и окошком"
      }
      // ... остальные товары ...
    ]
  },
  "saved_path": null
}

curl -X POST "https://bhapi.ru/wb/api/v1/search/image" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -F "image=@product.png;type=image/png" \
  -F "max_results=10"

{
  "status": "ok",
  "data": {
    "count": 2,
    "label": null,
    "engine": "siglip2_mrl_crop",
    "search_engine": "qdrant",
    "nm_ids": [123456789, 987654321],
    "links": [
      "https://www.wildberries.ru/catalog/123456789/detail.aspx",
      "https://www.wildberries.ru/catalog/987654321/detail.aspx"
    ]
  }
}

curl -X GET "https://bhapi.ru/wb/api/v1/search/presets" \
  -H "X-API-Token: ВАШ_API_TOKEN"

curl -X POST "https://bhapi.ru/wb/api/v1/search/filters" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"query":"лыжи классические"}'

import requests

response = requests.post(
    "https://bhapi.ru/wb/api/v1/search/filters",
    json={"query": "лыжи классические"},
    headers={"X-API-Token": "ВАШ_API_TOKEN"},
    timeout=210,
)
response.raise_for_status()
for group in response.json()["data"]["filters"]:
    print(group["key"], group["name"], group["values"])

curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{
    "query":"лоферы мужские",
    "page":1,
    "preset":"footwear",
    "preset_filters":{
      "color":["коричневый"],
      "size":["45"],
      "gender":["мужской"]
    }
  }'

curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{
    "query":"футболка женская",
    "preset":"clothing",
    "preset_filters":{
      "size":["46"],
      "fit":["оверсайз"],
      "gender":["женский"]
    }
  }'

import requests

payload = {
    "query": "шапка женская",
    "preset": "headwear",
    "preset_filters": {"size": ["56"], "gender": ["женский"]},
}
response = requests.post(
    "https://bhapi.ru/wb/api/v1/search",
    json=payload,
    headers={"X-API-Token": "ВАШ_API_TOKEN"},
    timeout=210,
)
response.raise_for_status()

curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{
    "query":"лыжи классические",
    "characteristic_filters":{
      "f1000000896":[-1000041358],
      "f13649":[143021],
      "f121981":[121983]
    }
  }'

curl -X POST "https://bhapi.ru/wb/api/v1/seller/catalog" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"url":"https://www.wildberries.ru/seller/4190071","page":1}'

{
  "status": "ok",
  "data": {
    "code": 200,
    "msg": "success",
    "data": {
      "supplier_id": 4190071,
      "page": 3,
      "products_count": 100,
      "per_page": 100,
      "max_pages": 5,
      "total": 490,
      "wb": {
        "products": [
          {
            "id": 277304775,
            "name": "Мотор насос омывателя 2101-2107 2121"
          }
        ]
      }
    }
  }
}

curl -X POST "https://bhapi.ru/wb/api/v1/item/review_scope" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"imt_id":733309467,"lang":"ru"}'

{
  "status": "ok",
  "data": {
    "code": 200,
    "msg": "success",
    "data": {
      "imt_id": 733309467,
      "lang": "ru",
      "summary": [
        { "tag_id": 8, "name": "Качество", "plus_count": 47, "minus_count": 0 }
      ],
      "items": [
        { "nm_id": 537724276, "summary": [] }
      ],
      "valuation": 4.8,
      "valuationSum": 55350,
      "valuationDistribution": { "1": 193, "2": 71, "3": 137, "4": 461, "5": 10552 },
      "nmValuationDistribution": [],
      "feedbackCount": 1036,
      "photo_links": [
        "https://feedback-01.wbbasket.ru/example/ms.webp"
      ],
      "wb": {
        "summary": [ ],
        "items": [ ]
      }
    }
  },
  "saved_path": null
}

curl --get "https://bhapi.ru/wb/api/v1/pickup-points" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  --data-urlencode "query=Москва" \
  --data-urlencode "limit=10" \
  --data-urlencode "offset=0"

{
  "status": "ok",
  "data": {
    "total": 1,
    "count": 1,
    "items": [
      {
        "id": 123,
        "dest": -1234,
        "address": "Москва, пример адреса"
      }
    ]
  }
}

curl "https://bhapi.ru/wb/api/v1/pickup-points/123" \
  -H "X-API-Token: ВАШ_API_TOKEN"

{
  "status": "ok",
  "data": {
    "id": 123,
    "dest": -1234,
    "address": "Москва, пример адреса"
  }
}

curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"query":"кроссовки","pickup_point_id":123}'

import requests

API_URL = "https://bhapi.ru/wb/api/v1/item/by-url"
TOKEN = "ВАШ_API_TOKEN"

params = {
    "url": "https://www.wildberries.ru/catalog/770596537/detail.aspx",
}

response = requests.get(API_URL, params=params, headers={"X-API-Token": TOKEN}, timeout=30)
payload = response.json()

if payload["status"] == "ok" and payload["data"]["code"] == 200:
    item = payload["data"]["data"]
    print("ID товара:", item["item_id"])
    print("Название:", item["title"])
    print("Категория:", item["category_name"])
    print("Картинок:", len(item["main_imgs"]))
else:
    print("Ошибка:", payload)

import requests

SEARCH_URL = "https://bhapi.ru/wb/api/v1/search"
TOKEN = "ВАШ_API_TOKEN"

payload = {
    "query": "аэрогриль объем 8 литров",
    "page": 1,
    "max_links": 10,
    "sort": "rate",
}

response = requests.post(
    SEARCH_URL,
    json=payload,
    headers={"X-API-Token": TOKEN},
    timeout=210,
)
payload = response.json()

data = payload["data"]
print(f"Всего найдено товаров: {data['total']}")
print(f"Показано на странице: {data['count']}")

for product in data["products"]:
    print(
        f"{product['id']}: {product['price']} ₽, "
        f"рейтинг {product['rating']}, отзывов {product['feedbacks']}"
    )

curl -X GET \
  "https://bhapi.ru/wb/api/v1/item/by-url?url=https://www.wildberries.ru/catalog/770596537/detail.aspx" \
  -H "X-API-Token: ВАШ_API_TOKEN"

# Базовый поиск
curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"query":"кроссовки"}'

# Страница 2, ограничение по количеству ссылок
curl -X POST "https://bhapi.ru/wb/api/v1/search" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  -d '{"query":"зимние ботинки","page":2,"max_links":50}'

const TOKEN = "ВАШ_API_TOKEN";
const BASE_URL = "https://bhapi.ru";

async function getWbItem(productUrl) {
  const params = new URLSearchParams({ url: productUrl });

  const response = await fetch(`${BASE_URL}/wb/api/v1/item/by-url?${params}`, {
    method: "GET",
    headers: { "X-API-Token": TOKEN },
  });

  const payload = await response.json();

  if (payload.status === "ok" && payload.data.code === 200) {
    return payload.data.data;
  }

  console.error("Ошибка WB:", payload);
  return null;
}

getWbItem("https://www.wildberries.ru/catalog/770596537/detail.aspx")
  .then((item) => {
    if (!item) return;
    console.log("Название:", item.title);
    console.log("Категория:", item.category_name);
    console.log("Первая картинка:", item.main_imgs[0]);
  });

<?php

$apiUrl = "https://bhapi.ru/wb/api/v1/item/by-url";
$token  = "ВАШ_API_TOKEN";

$productUrl = "https://www.wildberries.ru/catalog/770596537/detail.aspx";

$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL            => $apiUrl . "?" . http_build_query(["url" => $productUrl]),
    CURLOPT_HTTPHEADER     => ["X-API-Token: " . $token],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 30,
]);

$response = curl_exec($ch);
curl_close($ch);

$payload = json_decode($response, true);

if ($payload["status"] === "ok" && $payload["data"]["code"] === 200) {
    $item = $payload["data"]["data"];
    echo "Товар: " . $item["title"] . PHP_EOL;
    echo "Категория: " . $item["category_name"] . PHP_EOL;
} else {
    var_dump($payload);
}

import time
import requests

BASE_URL = "https://bhapi.ru"
TOKEN = "ВАШ_API_TOKEN"

def search(query: str, page: int = 1, limit: int = 10):
    resp = requests.post(
        f"{BASE_URL}/wb/api/v1/search",
        json={"query": query, "page": page, "max_links": limit},
        headers={"X-API-Token": TOKEN},
        timeout=210,
    )
    return resp.json()["data"]

def get_item(url: str):
    resp = requests.get(
        f"{BASE_URL}/wb/api/v1/item/by-url",
        params={"url": url},
        headers={"X-API-Token": TOKEN},
        timeout=30,
    )
    payload = resp.json()
    if payload["status"] == "ok" and payload["data"]["code"] == 200:
        return payload["data"]["data"]
    return None

data = search("аэрогриль объем 8 литров", page=1, limit=5)

items = []
for link in data["links"]:
    print("Парсим:", link)
    item = get_item(link)
    if item:
        items.append(item)
        print("  ✓", item["title"][:60])
    else:
        print("  ✗ не удалось получить данные")
    time.sleep(1.5)  # пауза, чтобы не превышать rate limit

print(f"Всего подробно получено товаров: {len(items)}")