Документация API WBDown
Полное руководство по использованию API для работы с товарами, отзывами и продавцами на Wildberries
Важно: Для использования API необходимо иметь активную подписку.
Базовый URL
https://www.wbdown.ru/api/send
Аутентификация
Все запросы к API требуют передачи API ключа в заголовке X-API-Key:
X-API-Key: ваш_api_ключ
Также можно передать ключ в параметре запроса api_key:
?api_key=ваш_api_ключ
Получение категорий товаров
Получение дерева категорий каталога Wildberries (то же меню, что на сайте).
Эндпоинт
GET
https://www.wbdown.ru/api/send?action=categories
Параметры запроса
Дополнительные параметры не требуются.
Пример запроса
curl -X GET "https://www.wbdown.ru/api/send?action=categories" \
-H "X-API-Key: ваш_api_ключ"
Пример ответа
{
"success": true,
"categories": [
{
"id": 123,
"name": "Электроника",
"url": "/catalog/elektronika",
"childs": [
{
"id": 456,
"name": "Телевизоры",
"url": "/catalog/elektronika/televizory-i-cifrovoe-tv",
"childs": []
}
]
}
],
"count": 15
}
Список товаров по категории
Получение списка товаров по пути категории из каталога (path из дерева категорий).
Эндпоинт
GET
https://www.wbdown.ru/api/send?action=category_products
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
path |
string | Да | Путь категории из каталога (например: elektronika/televizory-i-cifrovoe-tv). Берётся из поля url в ответе action=categories (без /catalog/). |
page |
integer | Нет | Номер страницы (по умолчанию: 1) |
sort |
string | Нет | Сортировка: popular, priceup, pricedown, rate, date (по умолчанию: popular) |
limit |
integer | Нет | Максимум товаров в ответе (0 = без ограничения, по умолчанию: 0) |
Пример запроса
curl -X GET "https://www.wbdown.ru/api/send?action=category_products&path=elektronika/televizory-i-cifrovoe-tv&page=1" \
-H "X-API-Key: ваш_api_ключ"
Пример ответа
{
"success": true,
"path": "elektronika/televizory-i-cifrovoe-tv",
"category_name": "Телевизоры и цифровое ТВ",
"products": [ { "id": 12345678, "name": "...", "salePriceU": 1999000, ... } ],
"articles": [ "12345678", "87654321" ],
"count": 30,
"page": 1,
"total": 1500,
"has_more": true
}
Поиск товаров продавца
Получение списка артикулов товаров по ID продавца.
Эндпоинт
GET
https://www.wbdown.ru/api/send?action=supplier_articles
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
supplier_id |
string | Да | ID продавца на Wildberries |
page |
integer | Нет | Номер страницы (по умолчанию: 1) |
sort |
string | Нет | Сортировка: popular, priceup, pricedown, rate, date (по умолчанию: popular) |
limit |
integer | Нет | Лимит количества артикулов (0 = без лимита, по умолчанию: 0) |
Пример запроса
curl -X GET "https://www.wbdown.ru/api/send?action=supplier_articles&supplier_id=123456" \
-H "X-API-Key: ваш_api_ключ"
Пример ответа
{
"success": true,
"articles": [
"12345678",
"87654321",
"11223344"
],
"count": 30,
"page": 1,
"has_more": true,
"supplier_id": "123456"
}
Поиск товаров по ключевым словам
Поиск товаров по ключевым словам в каталоге Wildberries.
Эндпоинт
GET
https://www.wbdown.ru/api/send?action=keyword_search
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
query |
string | Да | Поисковый запрос (ключевые слова) |
page |
integer | Нет | Номер страницы (по умолчанию: 1) |
sort |
string | Нет | Сортировка: popular, priceup, pricedown, rate, date (по умолчанию: popular) |
limit |
integer | Нет | Лимит количества артикулов (по умолчанию: 10, максимум: 10000) |
Пример запроса
curl -X GET "https://www.wbdown.ru/api/send?action=keyword_search&query=ноутбук" \
-H "X-API-Key: ваш_api_ключ"
Пример ответа
{
"success": true,
"articles": [
"12345678",
"87654321",
"11223344"
],
"count": 30,
"page": 1,
"has_more": true,
"total": 1500,
"query": "ноутбук"
}
Вывод отзывов по артикулу
Получение отзывов с фотографиями по артикулу товара.
Эндпоинт
GET
https://www.wbdown.ru/api/send?action=reviews
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
art_id |
string | Да | Артикул товара на Wildberries |
Пример запроса
curl -X GET "https://www.wbdown.ru/api/send?action=reviews&art_id=12345678" \
-H "X-API-Key: ваш_api_ключ"
Пример ответа
{
"success": true,
"art_id": "12345678",
"reviews": {
"review_id_1": [
{
"photo_id": "photo123",
"url": "https://example.com/photo1.jpg"
},
{
"photo_id": "photo124",
"url": "https://example.com/photo2.jpg"
}
],
"review_id_2": [
{
"photo_id": "photo125",
"url": "https://example.com/photo3.jpg"
}
]
},
"count": 25
}
Коды ошибок
| Код | Описание |
|---|---|
400 |
Неверный запрос (отсутствуют обязательные параметры) |
401 |
Не авторизован (неверный или отсутствующий API ключ, подписка неактивна) |
405 |
Метод не поддерживается |
500 |
Внутренняя ошибка сервера |
Примеры использования
cURL
# Категории товаров
curl -X GET "https://www.wbdown.ru/api/send?action=categories" \
-H "X-API-Key: ваш_api_ключ"
# Товары по категории
curl -X GET "https://www.wbdown.ru/api/send?action=category_products&path=elektronika/televizory-i-cifrovoe-tv" \
-H "X-API-Key: ваш_api_ключ"
# Поиск товаров продавца
curl -X GET "https://www.wbdown.ru/api/send?action=supplier_articles&supplier_id=123456" \
-H "X-API-Key: ваш_api_ключ"
# Поиск по ключевым словам
curl -X GET "https://www.wbdown.ru/api/send?action=keyword_search&query=ноутбук" \
-H "X-API-Key: ваш_api_ключ"
# Получение отзывов
curl -X GET "https://www.wbdown.ru/api/send?action=reviews&art_id=12345678" \
-H "X-API-Key: ваш_api_ключ"
Python
import requests
api_key = "ваш_api_ключ"
base_url = "https://www.wbdown.ru/api/send"
headers = {"X-API-Key": api_key}
# Категории товаров
r = requests.get(f"{base_url}?action=categories", headers=headers)
print(r.json())
# Товары по категории
r = requests.get(f"{base_url}?action=category_products&path=elektronika/televizory-i-cifrovoe-tv", headers=headers)
print(r.json())
# Поиск товаров продавца
r = requests.get(f"{base_url}?action=supplier_articles&supplier_id=123456", headers=headers)
print(r.json())
# Поиск по ключевым словам
r = requests.get(f"{base_url}?action=keyword_search&query=ноутбук", headers=headers)
print(r.json())
# Получение отзывов
r = requests.get(f"{base_url}?action=reviews&art_id=12345678", headers=headers)
print(r.json())
JavaScript (fetch)
const apiKey = "ваш_api_ключ";
const baseUrl = "https://www.wbdown.ru/api/send";
const headers = { "X-API-Key": apiKey };
// Категории товаров
fetch(`${baseUrl}?action=categories`, { headers })
.then(r => r.json()).then(console.log).catch(console.error);
// Товары по категории
fetch(`${baseUrl}?action=category_products&path=elektronika/televizory-i-cifrovoe-tv`, { headers })
.then(r => r.json()).then(console.log).catch(console.error);
// Поиск товаров продавца
fetch(`${baseUrl}?action=supplier_articles&supplier_id=123456`, { headers })
.then(r => r.json()).then(console.log).catch(console.error);
// Поиск по ключевым словам
fetch(`${baseUrl}?action=keyword_search&query=ноутбук`, { headers })
.then(r => r.json()).then(console.log).catch(console.error);
// Получение отзывов
fetch(`${baseUrl}?action=reviews&art_id=12345678`, { headers })
.then(r => r.json()).then(console.log).catch(console.error);
PHP
<?php
$apiKey = "ваш_api_ключ";
$baseUrl = "https://www.wbdown.ru/api/send";
$headers = ["X-API-Key: " . $apiKey];
// Категории товаров
$ch = curl_init($baseUrl . "?action=categories");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $headers]);
$data = json_decode(curl_exec($ch), true); curl_close($ch);
print_r($data);
// Товары по категории
$ch = curl_init($baseUrl . "?action=category_products&path=elektronika/televizory-i-cifrovoe-tv");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $headers]);
$data = json_decode(curl_exec($ch), true); curl_close($ch);
print_r($data);
// Поиск по ключевым словам
$ch = curl_init($baseUrl . "?action=keyword_search&query=ноутбук");
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => $headers]);
$data = json_decode(curl_exec($ch), true); curl_close($ch);
print_r($data);
?>
Готовые классы для интеграции
Скачайте готовый PHP, Python или JavaScript класс, либо коллекцию Postman для тестирования API. Все методы документированы и соответствуют текущей документации.