Документация API Wildberries
Полное руководство по использованию API для работы с товарами, отзывами и продавцами на Wildberries
Важно: Для использования API необходимо иметь активную подписку.
Базовый URL
https://www.wbdown.ru/api/send
Аутентификация
Все запросы к API требуют передачи API ключа в заголовке X-API-Key:
X-API-Key: ваш_api_ключ
Также можно передать ключ в параметре запроса api_key:
?api_key=ваш_api_ключ
Поиск товаров продавца
Получение списка артикулов товаров по 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=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"
# Поиск товаров продавца
response = requests.get(
f"{base_url}?action=supplier_articles&supplier_id=123456",
headers={"X-API-Key": api_key}
)
data = response.json()
print(data)
# Поиск по ключевым словам
response = requests.get(
f"{base_url}?action=keyword_search&query=ноутбук",
headers={"X-API-Key": api_key}
)
data = response.json()
print(data)
# Получение отзывов
response = requests.get(
f"{base_url}?action=reviews&art_id=12345678",
headers={"X-API-Key": api_key}
)
data = response.json()
print(data)
JavaScript (fetch)
const apiKey = "ваш_api_ключ";
const baseUrl = "https://www.wbdown.ru/api/send";
// Поиск товаров продавца
fetch(`${baseUrl}?action=supplier_articles&supplier_id=123456`, {
headers: {
"X-API-Key": apiKey
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Ошибка:", error));
// Поиск по ключевым словам
fetch(`${baseUrl}?action=keyword_search&query=ноутбук`, {
headers: {
"X-API-Key": apiKey
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Ошибка:", error));
// Получение отзывов
fetch(`${baseUrl}?action=reviews&art_id=12345678`, {
headers: {
"X-API-Key": apiKey
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Ошибка:", error));
PHP
<?php
$apiKey = "ваш_api_ключ";
$baseUrl = "https://www.wbdown.ru/api/send";
// Поиск товаров продавца
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . "?action=supplier_articles&supplier_id=123456");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: " . $apiKey]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
// Поиск по ключевым словам
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . "?action=keyword_search&query=ноутбук");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: " . $apiKey]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
// Получение отзывов
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $baseUrl . "?action=reviews&art_id=12345678");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: " . $apiKey]);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>