Мониторинг Яндекс.Маркет
в реальном времени по API


Документация

  1. Ко всем запросам необходимо добавить GET-параметр api_key.
    В его значении указать API-ключ из личного кабинета. http://market.apisystem.name/models/10887816/offers?&api_key=<ключ>
  2. Частота запросов: не чаще 1-го запроса в секунду.
  3. После регистрации на аккаунте доступно 100 тестовых запроса.
  4. Советы для избежания ошибок и быстрого ответа на запросы:
    - Дожидаться ответа сервера перед отправкой нового запроса.
    - Добавить задержку в 1-2 секунды между запросами.
    - Добавить задержку в 30 секунд при получении ошибки.
  1. 403 "Access no paid" - доступ не оплачен.
  2. 403 "Rate limit exceeded" - исчерпан лимит запросов в сутки.
  3. 403 "Access denied" - неверный API-ключ.
  4. 403 "Thread limit" - превышение частоты запросов.
  5. 403 "Forbidden" - постоянные нарушения частоты запросов.
    Разблокировка происходит автоматически, спустя ~30 секунд.
  6. 200 "Error occurred, please try again later" - ошибка с нашей стороны.
    Повторите запрос, спустя ~30 секунд.
  7. 200 "Error. No such product." - такого товара, нет.

Характеристики модели

Описание

GET /models/{id}/specification

Возвращает список характеристик, соотнесенных с указанной моделью.

URL ресурса:

http://market.apisystem.name/models/{id}/specification


Пример запроса:

http://market.apisystem.name/models/10887816/specification?&format=json&api_key=


Пример запроса с skuid:

http://market.apisystem.name/models/670614000/specification?&format=json&skuid=100957284730&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
skuid QUERY Int64 Нет

Идентификатор модификации модели.
geo_id QUERY Int32 Нет

Код региона.

Значение по умолчанию: 213 (Москва).
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
model_id model_id

Int64

Идентификатор модели.
url url

String

Адрес страницы модели на Яндекс.Маркете.
product_name product_name

String

Наименование модели.
category category

String

Наименование категории.
subcategory subcategory

String

Наименование подкатегории.
prev_image prev_image

String

URL для предпросмотра фотографии товара.
description description

String

Описание товара.
full_description    full_description

String

Полное описание товара.
vendor vendor

String

Производитель.
photos photos

Object list

Список фотографий товара.
video video

String

URL видео товара.
specifications    specifications

Object list

Список характеристик товара.
Параметры, вложенные в photos
url url

String

URL фотографии товара.
Параметры, вложенные в specifications
category category

String

Категория характеристики.
name name

String

Название характеристики.
value value

String

Значение характеристики.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Список предложений на модель

Описание

GET /models/{id}/offers

Возвращает список товарных предложений, соотнесенных с указанной моделью.

URL ресурса:

http://market.apisystem.name/models/{id}/offers


Пример запроса:

http://market.apisystem.name/models/10887816/offers?&sort=aprice&format=json&api_key=


Пример запроса с skuid:

http://market.apisystem.name/models/670614000/offers?&sort=aprice&format=json&skuid=100957284730&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
skuid QUERY Int64 Нет

Идентификатор модификации модели.
geo_id QUERY Int32 Нет

Код региона.

Значение по умолчанию: 213 (Москва).
gps QUERY List Нет

Географические координаты в формате широта,долгота

По умолчанию: 55.752490,37.623205 (Москва, Красная площадь, 7)
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json.
Параметры страницы
count QUERY Int32 Нет

Размер страницы (количество элементов на странице).

Ограничения:

  • Минимальное значение: 1, максимальное значение: 30

Значение по умолчанию: 10.
page QUERY Int32 Нет

Номер страницы.

Ограничения:

  • Минимальное значение: 1, максимальное значение: 50

Значение по умолчанию: 1.
Параметры сортировки
sort QUERY Enum Нет

Тип сортировки товарных предложений

Возможные значения:
  • aprice — сортировка по возрастанию цены.
  • dprice — сортировка по убыванию цены.
  • discount_p — сортировка по убыванию размера скидки.
  • dpop — сортировка по убыванию популярности.
  • quality — сортировка по убыванию рейтинга.
Значение по умолчанию: dpop.
Фильтры
discount QUERY Int32 Нет

Фильтр "Скидки".

Возможные значения:
  • 0 — Выбрать предложения без скидки.
  • 1 — Выбрать предложения со скидкой.
Значение по умолчанию: 0.
yandex_warehouse   QUERY Int32 Нет

Фильтр "Со склада Яндекса".

Возможные значения:
  • 0 — Выбрать предложения со всех складов.
  • 1 — Выбрать предложения со склада Яндекса.
Значение по умолчанию: 0.
yandex_delivery QUERY Int32 Нет

Фильтр "С доставкой Яндекса".

Возможные значения:
  • 0 — Выбрать предложения со всеми видами доставки.
  • 1 — Выбрать предложения с доставкой Яндекса.
Значение по умолчанию: 0.
delivery_interval QUERY Int32 Нет

Фильтр "Время доставки".

Возможные значения:
  • 12 — Express 1-2 часа.
  • 0 — Сегодня.
  • 1 — Сегодня или завтра.
  • 5 — До 5 дней.
Значение по умолчанию: 5.
express QUERY Int32 Нет

Фильтр "Только экспресс-офферы".

Возможные значения:
  • 0 — Все офферы.
  • 1 — Только экспресс-офферы.
Значение по умолчанию: 0.
price_min QUERY Int32 Нет

Фильтр "Минимальная цена".

Ограничения:

  • Минимальное значение: 0, максимальное значение: 2147483647

Значение по умолчанию: нет, если не задан.
price_max QUERY Int32 Нет

Фильтр "Максимальная цена".

Ограничения:

  • Минимальное значение: 0, максимальное значение: 2147483647

Значение по умолчанию: нет, если не задан.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
total_offers total_offers

Int32

Количество найденных предложений.
page page

Int32

Номер страницы.
count count

Int32

Размер страницы (количество элементов на странице).
price_avg price_avg

String

Средняя цена.
price_max price_max

String

Максимальная цена.
price_min price_min

String

Минимальная цена.
region_id region_id

Int32

Код региона.
region_name region_name

String

Наименование региона.
product_id product_id

Int64

Идентификатор модели.
product_name product_name

String

Наименование модели на Яндекс.Маркете.
product_url product_url

String

Адрес страницы модели на Яндекс.Маркете.
offers offers

Object list

Список товарных предложений модели

Предложение

filters filters

Object list

Список фильтров, доступных для фильтрации товарных предложений модели

Типы:
  • Фильтр.
  • Фильтр со значениями.
  • Числовой фильтр
sorts sorts

Object list

Список доступных сортировок товарных предложений модели
Параметры, вложенные в offers
market_sku market_sku

Int64

Идентификатор модификации модели.
model_id model_id

Int64

Идентификатор модели.
offer_id offer_id

String

Уникальный идентификатор предложения.
offer_name offer_name

String

Наименование товара.
on_stock on_stock

Int32

Доступное количество товара для заказа.
rating rating

Float

Уровень популярности.
shop_id shop_id

Int32

Идентификатор магазина.
shop_name shop_name

String

Наименование магазина.
origin_shop_name    origin_shop_name

String

Наименование магазина - партнера.
delivery_partner delivery_partner

String

Партнер, осуществляющий доставку.
delivery_region delivery_region

String

Регион, откуда осуществляется доставка.
delivery_time delivery_time

Int32

Сроки курьерской доставки в днях.
delivery_cost delivery_cost

Int32

Стоимость курьерской доставки.
pickup_time pickup_time

String

Сроки самовывоза в днях (мин - макс).
discount_percent discount_percent

Int32

Процент скидки.
price price

Int32

Цена товара.
price_without_discount    price_without_discount

Int32

Цена товара без учёта скидки.
price_with_delivery    price_with_delivery

Int32

Цена товара с учетом стоимости доставки.
warranty warranty

Boolean

Наличие гарантии.
weight weight

Int32

Вес в граммах.
url url

String

Ссылка на Яндекс.Маркет.
Параметры, вложенные в filters Типы: Фильтр., Фильтр со значениями., Числовой фильтр
id id

String

Идентификатор фильтра.
name name

String

Наименование фильтра.
type type

String

Тип фильтра.

Возможные значения:
  • boolean — логический тип.
  • number — числовой тип, задает диапазон допустимых значений.
  • enum — тип перечисление, задает список допустимых значений, множественный выбор.
  • color — фильтр по цвету, аналогичен enum, значения фильтра дополнительно содержат HEX-код соответствующего цвета.
  • size — фильтр по размеру, аналогичен ENUM, значения фильтра дополнительно содержат код единиц измерения.
  • radio — аналогичен enum, но допускает выбор только одного значения.
  • text — тип фильтра для фильтрации по поисковой фразе.
valueIds valueIds

Object list

Список значений фильтра

Типы:
  • Значение фильтра
  • Значение color фильтра
  • Значение size фильтра
  • Значение Filters.FilterType#photo_picker фильтра
Параметры, вложенные в filters/valueIds Типы: Значение фильтра, Значение color фильтра, Значение size фильтра, Значение Filters.FilterType#photo_picker фильтра
id id

String

Идентификатор значения фильтра, используется для установки значения фильтра.
skuId skuId

String

Код модификации модели, соответствующий значению фильтра.
value value

String

Значение фильтра.
Параметры, вложенные в sorts
id id

String

Идентификатор варианта сортировки.
text text

String

Наименование варианта сортировки.
type type

String

Направление сортировки.

Возможные значения:

  • asc — по возрастанию;

  • desc — по убыванию.

  • none — отсуствует.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Отзывы о модели

Описание

GET /models/{id}/opinions

Возвращает отзывы пользователей о модели.

URL ресурса:

http://market.apisystem.name/models/{id}/opinions


Пример запроса:

http://market.apisystem.name/models/10887816/opinions?&format=json&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
geo_id QUERY Int32 Нет

Код региона.

Значение по умолчанию: 213 (Москва).
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json .
Параметры страницы
count QUERY Int32 Нет

Размер страницы (количество элементов на странице).

Ограничения:

  • Минимальное значение: 1, максимальное значение: 30

Значение по умолчанию: 10.
page QUERY Int32 Нет

Номер страницы.

Ограничения:

  • Минимальное значение: 1

Значение по умолчанию: 1.
Параметры сортировки
sort QUERY Enum Нет

Тип сортировки отзывов о модели

Возможные значения:
  • date — сортировка по дате.
  • grade — сортировка по рейтингу.
Значение по умолчанию: date.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
page page

Int32

Номер страницы.
count count

Int32

Размер страницы (количество элементов на странице).
model_id model_id

Int64

Идентификатор модели.
url url

String

Адрес страницы модели на Яндекс.Маркете.
total_reviews total_reviews

Int32

Количество найденных отзывов.
total_pages total_pages

Int32

Количество страниц.
reviews reviews

Object list

Отзывы

Отзыв о модели

Параметры, вложенные в reviews
id id

Int64

Уникальный идентификатор пользователя.
user_name user_name

String

Имя пользователя.
user_avatar_small user_avatar_small

String

Ссылка на малый аватар пользователя.
user_avatar_big user_avatar_big

String

Ссылка на большой аватар пользователя.
user_link user_link

String

Ссылка на профиль пользователя.
created created

Date

Дата создания отзыва.
region region

Int32

Идентификатор региона.
recommend recommend

Boolean

Признак рекомендованного товара.
comment comment

String

Комментарий пользователя.
dignities dignities

String

Что понравилось пользователю в товаре.
disadvantages disadvantages

String

Что не понравилось пользователю в товаре.
average_grade average_grade

Int32

Средняя оценка.
usage usage

Boolean

Признак использования товара.
votes_yes votes_yes

Int32

Количество голосов "за".
votes_no votes_no

Int32

Количество голосов "против".
photos photos

Object list

Список фотографий товара.
Параметры, вложенные в photos
url url

String

URL фотографии товара.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Текстовый список всех регионов

11339 - Абаза
1095 - Абакан
11194 - Агаповка
11233 - Агинское
11005 - Адыгейск
11120 - Азнакаево
11030 - Азов
11031 - Аксай
11432 - Алдан
11234 - Алейск
11142 - Александров Гай
10656 - Александров
11347 - Александровское
11444 - Александровск-Сахалинский
10948 - Алексеевская
10825 - Алексин
11471 - Алушта
11121 - Альметьевск
10903 - Амдерма
11451 - Амурск
11458 - Анадырь
1107 - Анапа
11256 - Ангарск
11276 - Анжеро-Судженск
10686 - Анна
10894 - Апатиты
10715 - Апрелевка
10986 - Апшеронск
11195 - Аргаяш
11025 - Аргун
11080 - Арзамас
10987 - Армавир
11405 - Арсеньев
11406 - Артём
20 - Архангельск
11373 - Архара
11160 - Асбест
37 - Астрахань
11302 - Ачинск
11196 - Аша
11032 - Багаевская
11257 - Байкальск
11331 - Бай-Хаак
10657 - Балакирево
11143 - Балаково
10716 - Балашиха
11144 - Балашов
10858 - Балтийск
197 - Барнаул
11154 - Барыш
11033 - Батайск
10905 - Батецкий
10927 - Бежаницы
10804 - Бежецк
11034 - Белая Калитва
4 - Белгород
11096 - Белинский
11277 - Белово
11374 - Белогорск
11236 - Белокуриха
10938 - Беломорск
10988 - Белореченск
11258 - Белореченский
11179 - Белоярский
11314 - Бердск
11278 - Берёзовский
11023 - Беслан
11097 - Бессоновка
975 - Бийск
11459 - Билибино
11393 - Биробиджан
11259 - Бирюсинск
11238 - Благовещенка
77 - Благовещенск
11054 - Благодарный
10673 - Бобров
10674 - Богучар
11260 - Бодайбо
10861 - Бокситогорск
10805 - Бологое
10768 - Болхов
11407 - Большой Камень
11355 - Борзя
10675 - Борисоглебск
10906 - Боровичи
10698 - Боровск
976 - Братск
11197 - Бреды
10717 - Бронницы
191 - Брянск
11122 - Бугульма
11085 - Бугуруслан
11055 - Будённовск
11086 - Бузулук
10700 - Буй
11006 - Буйнакск
11376 - Бурея
10676 - Бутурлиновка
10907 - Валдай
11452 - Ванино
11198 - Варна
10781 - Велиж
10928 - Великие Луки
24 - Великий Новгород
10854 - Великий Устюг
10843 - Вельск
10826 - Венёв
10862 - Верево
11402 - Верхнее Пенжино
11199 - Верхнеуральск
11200 - Верхний Уфалей
11161 - Верхняя Салда
11433 - Верхоянск
11279 - Верх-Чебула
10806 - Весьегонск
11035 - Вёшенская
10719 - Видное
11434 - Вилюйск
11395 - Вилючинск
10989 - Витязево
11262 - Вихоревка
10688 - Вичуга
75 - Владивосток
33 - Владикавказ
192 - Владимир
11408 - Владимиро-Александровское
10720 - Внуково
38 - Волгоград
11036 - Волгодонск
10701 - Волгореченск
10951 - Волжский
21 - Вологда
10721 - Волоколамск
10863 - Волосово
10908 - Волот
10864 - Волхов
11410 - Вольно-Надеждинское
11145 - Вольск
10940 - Воркута
193 - Воронеж
10722 - Воскресенск
11149 - Воткинск
10865 - Всеволожск
969 - Выборг
10807 - Вышний Волочёк
10659 - Вязники
10782 - Вязьма
10783 - Гагарин
11087 - Гай
10703 - Галич
10867 - Гатчина
10990 - Геленджик
11056 - Георгиевск
11150 - Глазов
11319 - Горно-Алтайск
11239 - Горняк
10952 - Городище
10660 - Гороховец
10991 - Горячий Ключ
1106 - Грозный
10646 - Губкин
11228 - Губкинский
11026 - Гудермес
11037 - Гуково
11280 - Гурьевск
11326 - Гусиноозерск
10661 - Гусь-Хрустальный
10992 - Дагомыс
11411 - Дальнегорск
11412 - Дальнереченск
10835 - Данилов
10953 - Даниловка
10784 - Демидов
10913 - Демянск
11007 - Дербент
10785 - Десногорск
972 - Дзержинск
11303 - Дивногорск
11345 - Диксон
11155 - Димитровград
10706 - Дмитриев
10723 - Дмитров
10929 - Дно
11201 - Долгодеревенское
214 - Долгопрудный
11016 - Домбай
10725 - Домодедово
10827 - Донской
10786 - Дорогобуж
215 - Дубна
10954 - Дубовка
11344 - Дудинка
10787 - Духовщина
10651 - Дятьково
11463 - Евпатория
11039 - Егорлыкская
10727 - Егорьевск
10993 - Ейск
54 - Екатеринбург
11377 - Екатеринославка
11123 - Елабуга
10955 - Елань
10713 - Елец
11396 - Елизово
10788 - Ельня
11304 - Енисейск
11263 - Ербогачён
11057 - Ессентуки
10828 - Ефремов
11058 - Железноводск
10710 - Железногорск
11264 - Железногорск-Илимский
11132 - Жигулёвск
10956 - Жирновск
10652 - Жуковка
11356 - Забайкальск
11378 - Завитинск
11124 - Заинск
10808 - Западная Двина
10728 - Зарайск
11098 - Заречный
11240 - Заринск
10729 - Звенигород
216 - Зеленоград
11125 - Зеленодольск
11059 - Зеленокумск
11040 - Зерноград
11379 - Зея
11265 - Зима
11041 - Зимовники
11202 - Златоуст
11241 - Змеиногорск
10947 - Знаменск
10868 - Ивангород
11380 - Ивановка
5 - Иваново
11305 - Игарка
44 - Ижевск
11281 - Ижморский
11060 - Изобильный
10957 - Иловля
10941 - Инта
11061 - Ипатово
11163 - Ирбит
63 - Иркутск
10731 - Истра
11173 - Ишим
41 - Йошкар-Ола
11413 - Кавалерово
43 - Казань
10677 - Калач
10958 - Калач-на-Дону
22 - Калининград
6 - Калуга
10809 - Калязин
11099 - Каменка
10869 - Каменногорск
11042 - Каменоломни
11164 - Каменск-Уральский
11043 - Каменск-Шахтинский
11242 - Камень-на-Оби
11414 - Камень-Рыболов
10662 - Камешково
10959 - Камышин
10895 - Кандалакша
11307 - Канск
10685 - Кантемировка
11017 - Карачаевск
10655 - Карачев
10844 - Каргополь
11203 - Карталы
11357 - Карымское
10773 - Касимов
11204 - Касли
11008 - Каспийск
11205 - Катав-Ивановск
11044 - Кашары
10810 - Кашин
10732 - Кашира
11348 - Кедровый
64 - Кемерово
11464 - Керчь
11157 - Кетово
11206 - Кизильское
11009 - Кизляр
10829 - Кимовск
10811 - Кимры
10870 - Кингисепп
11133 - Кинель
10689 - Кинешма
11267 - Киренск
10663 - Киржач
10871 - Кириши
46 - Киров
11071 - Кирово-Чепецк
10872 - Кировск
11415 - Кировский
11283 - Киселёвск
11062 - Кисловодск
10960 - Клетская
10733 - Клин
10653 - Клинцы
10664 - Ковров
11180 - Когалым
10695 - Козельск
10734 - Коломна
11349 - Колпашево
11100 - Колышлей
10665 - Кольчугино
11453 - Комсомольск-на-Амуре
10812 - Конаково
10934 - Кондопога
10696 - Кондрово
11381 - Константиновка
11046 - Константиновск
11207 - Копейск
11208 - Коркино
11445 - Корсаков
10845 - Коряжма
10935 - Костомукша
7 - Кострома
10961 - Котельниково
10846 - Котлас
10962 - Котово
10690 - Кохма
11320 - Кош-Агач
11284 - Крапивинский
10666 - Красная Горбатка
10994 - Красная Поляна
10735 - Красногорск
35 - Краснодар
11358 - Краснокаменск
11109 - Краснокамск
11315 - Краснообск
11165 - Краснотурьинск
62 - Красноярск
11045 - Красный Сулин
10813 - Красный Холм
10789 - Красный
10914 - Крестцы
10996 - Кропоткин
10997 - Крымск
11088 - Кувандык
118515 - Кудрово
11076 - Кудымкар
11101 - Кузнецк
10873 - Кузнечное
11243 - Кулунда
11113 - Кумертау
10963 - Кумылженская
53 - Курган
11446 - Курильск
8 - Курск
11209 - Куса
11166 - Кушва
11333 - Кызыл
11332 - Кызыл-Мажалык
11210 - Кыштым
10998 - Лазаревское
11181 - Лангепас
11126 - Лениногорск
10964 - Ленинск
11285 - Ленинск-Кузнецкий
11435 - Ленск
11167 - Лесной
11416 - Лесозаводск
10769 - Ливны
9 - Липецк
10678 - Лиски
10814 - Лихославль
10874 - Лодейное Поле
10875 - Ломоносов
10736 - Лотошино
10876 - Луга
11102 - Лунино
10737 - Луховицы
11417 - Лучегорск
10738 - Люберцы
10915 - Любытино
79 - Магадан
20181 - Магас
11382 - Магдагачи
235 - Магнитогорск
1093 - Майкоп
11321 - Майма
10815 - Максатиха
10909 - Малая Вишера
10697 - Малоярославец
11244 - Мамонтово
10910 - Марёво
11286 - Мариинск
28 - Махачкала
11182 - Мегион
11287 - Междуреченск
11183 - Междуреченский
10667 - Меленки
11212 - Миасс
11213 - Миасское
11047 - Миллерово
11063 - Минеральные Воды
11310 - Минусинск
11436 - Мирный
11245 - Михайловское
10803 - Мичуринск
11360 - Могоча
10739 - Можайск
11151 - Можга
11022 - Моздок
11103 - Мокшан
10790 - Монастырщина
10896 - Мончегорск
11048 - Морозовск
213 - Москва
10911 - Мошенское
11174 - Муравленко
23 - Мурманск
10668 - Муром
10770 - Мценск
11288 - Мыски
10740 - Мытищи
10836 - Мышкин
236 - Набережные Челны
11229 - Надым
1092 - Назрань
30 - Нальчик
10741 - Наро-Фоминск
11350 - Нарым
10902 - Нарьян-Мар
974 - Находка
11064 - Невинномысск
10816 - Нелидово
10702 - Нерехта
11361 - Нерчинск
11437 - Нерюнгри
11134 - Нефтегорск
11114 - Нефтекамск
11184 - Нефтеюганск
10966 - Нехаевская
1091 - Нижневартовск
11127 - Нижнекамск
11268 - Нижнеудинск
11104 - Нижний Ломов
47 - Нижний Новгород
11168 - Нижний Тагил
11169 - Нижняя Тура
10967 - Николаевск
11454 - Николаевск-на-Амуре
11105 - Никольск
11065 - Новоалександровск
11246 - Новоалтайск
10968 - Новоаннинский
10654 - Новозыбков
11383 - Новокиевский Увал
237 - Новокузнецк
11135 - Новокуйбышевск
10830 - Новомосковск
10969 - Новониколаевский
11066 - Новопавловск
11420 - Новопокровка
970 - Новороссийск
11089 - Новосергиевка
65 - Новосибирск
10771 - Новосиль
11081 - Новосмолинский
10930 - Новосокольники
11090 - Новотроицк
11170 - Новоуральск
238 - Новочеркасск
11049 - Новошахтинск
10647 - Новый Оскол
11230 - Новый Уренгой
10742 - Ногинск
11311 - Норильск
11231 - Ноябрьск
11128 - Нурлат
11186 - Нягань
11394 - Облучье
967 - Обнинск
10709 - Обоянь
11317 - Обь
10743 - Одинцово
11214 - Озёрск
10744 - Озёры
11438 - Оймякон
11136 - Октябрьск
10970 - Октябрьский
11215 - Октябрьское
10912 - Окуловка
11439 - Оленёк
10817 - Оленино
11363 - Оловянная
10971 - Ольховка
66 - Омск
10847 - Онега
10 - Орёл
48 - Оренбург
10745 - Орехово-Зуево
11091 - Орск
11290 - Осинники
11401 - Оссора
10818 - Осташков
10679 - Острогожск
10878 - Отрадное
11137 - Отрадный
11447 - Оха
11455 - Охотск
11082 - Павлово
10746 - Павловский Посад
11400 - Палана
10972 - Палласовка
10919 - Панковка
11421 - Партизанск
10916 - Парфино
11460 - Певек
49 - Пенза
11092 - Первомайский
11171 - Первоуральск
10837 - Переславль-Залесский
50 - Пермь
10920 - Пестово
10973 - Петров Вал
11364 - Петровск-Забайкальский
18 - Петрозаводск
78 - Петропавловск-Камчатский
10669 - Петушки
10900 - Печенга
10942 - Печора
10931 - Печоры
10879 - Пикалево
10848 - Пинега
11216 - Пласт
11422 - Пограничный
10921 - Поддорье
10747 - Подольск
10881 - Подпорожье
11187 - Покачи
11423 - Покровка
11050 - Покровское
11292 - Полысаево
11248 - Поспелиха
11138 - Похвистнево
10791 - Починок
11384 - Поярково
10974 - Преображенская
11365 - Приаргунск
10882 - Приморск
11000 - Приморско-Ахтарск
10883 - Приозерск
11291 - Прокопьевск
11293 - Промышленная
10648 - Прохоровка
25 - Псков
10884 - Пушкин
10748 - Пушкино
217 - Пущино
11188 - Пыть-Ях
11067 - Пятигорск
11189 - Радужный
11385 - Райчихинск
10750 - Раменское
11249 - Ребриха
10820 - Ржев
11250 - Родино
11386 - Ромны
10792 - Рославль
10681 - Россошь
10838 - Ростов
39 - Ростов-на-Дону
10885 - Рощино
11251 - Рубцовск
10751 - Руза
10839 - Рыбинск
10774 - Рыбное
10707 - Рыльск
10775 - Ряжск
11 - Рязань
11115 - Салават
11294 - Салаир
58 - Салехард
11051 - Сальск
51 - Самара
2 - Санкт-Петербург
11093 - Саракташ
42 - Саранск
11152 - Сарапул
194 - Саратов
11083 - Саров
11334 - Сарыг-Сеп
10777 - Сасово
11217 - Сатка
10794 - Сафоново
11341 - Саяногорск
11269 - Саянск
10859 - Светлогорск
11068 - Светлоград
10976 - Светлый Яр
10886 - Светогорск
11387 - Свободный
10932 - Себеж
959 - Севастополь
11327 - Северобайкальск
10849 - Северодвинск
11448 - Северо-Курильск
10898 - Североморск
11351 - Северск
10936 - Сегежа
11328 - Селенгинск
10682 - Семилуки
10977 - Серафимович
10752 - Сергиев Посад
11106 - Сердобск
10753 - Серебряные Пруды
11172 - Серов
10754 - Серпухов
10887 - Сертолово
11388 - Серышево
146 - Симферополь
11389 - Сковородино
10778 - Скопин
11252 - Славгород
11424 - Славянка
10888 - Сланцы
11073 - Слободской
12 - Смоленск
11218 - Снежинск
10899 - Снежногорск
10670 - Собинка
11456 - Советская Гавань
11110 - Соликамск
10755 - Солнечногорск
11094 - Соль-Илецк
10922 - Сольцы
10937 - Сортавала
10891 - Сосновый Бор
10943 - Сосногорск
239 - Сочи
10779 - Спас-Клепики
11425 - Спасск-Дальний
10978 - Средняя Ахтуба
11366 - Сретенск
36 - Ставрополь
10979 - Старая Полтавка
10923 - Старая Русса
10821 - Старица
10649 - Старый Оскол
11116 - Стерлитамак
11352 - Стрежевой
10756 - Ступино
10831 - Суворов
11472 - Судак
10708 - Суджа
10671 - Суздаль
973 - Сургут
10980 - Суровикино
11404 - Сусуман
11139 - Сызрань
19 - Сыктывкар
10796 - Сычевка
971 - Таганрог
11270 - Тайшет
10757 - Талдом
10684 - Таловая
11253 - Тальменка
13 - Тамбов
11390 - Тамбовка
11295 - Таштагол
14 - Тверь
11018 - Теберда
10901 - Териберка
11014 - Терскол
11440 - Тикси
11296 - Тисуль
10892 - Тихвин
11002 - Тихорецк
11175 - Тобольск
240 - Тольятти
67 - Томск
11297 - Топки
10822 - Торжок
10823 - Торопец
10893 - Тосно
10855 - Тотьма
11219 - Трёхгорный
11220 - Троицк
11254 - Троицкое
1058 - Туапсе
15 - Тула
11271 - Тулун
11372 - Тура
11335 - Туран
11322 - Турочак
11313 - Туруханск
11391 - Тында
55 - Тюмень
11298 - Тяжинский
11221 - Увельский
10840 - Углич
11461 - Угольные Копи
10797 - Угра
10824 - Удомля
10833 - Узловая
11222 - Уйское
198 - Улан-Удэ
11367 - Улёты
195 - Ульяновск
11192 - Урай
10981 - Урюпинск
10944 - Усинск
11272 - Усолье-Сибирское
11426 - Уссурийск
11019 - Усть-Джегута
11273 - Усть-Илимск
11255 - Усть-Калманка
11399 - Усть-Камчатск
11223 - Усть-Катав
11323 - Усть-Кокса
11354 - Усть-Ордынский
10856 - Устюжна
172 - Уфа
10945 - Ухта
11462 - Уэлен
10711 - Фатеж
11469 - Феодосия
10982 - Фролово
76 - Хабаровск
57 - Ханты-Мансийск
11011 - Хасавюрт
11427 - Хасан
11346 - Хатанга
10917 - Хвойная
11368 - Хилок
10758 - Химки
10798 - Хиславичи
10924 - Холм
10799 - Холм-Жирковский
10850 - Холмогоры
11428 - Хороль
11052 - Цимлянск
11336 - Чадан
11141 - Чапаевск
10714 - Чаплыгин
11362 - Чара
11224 - Чебаркуль
45 - Чебоксары
56 - Челябинск
11274 - Черемхово
968 - Череповец
1104 - Черкесск
11429 - Черниговка
219 - Черноголовка
11342 - Черногорск
11369 - Чернышевск
10983 - Чернышковский
10760 - Черусти
11226 - Чесма
10761 - Чехов
11129 - Чистополь
68 - Чита
11441 - Чокурдах
11324 - Чоя
11430 - Чугуевка
10925 - Чудово
11337 - Шагонар
11159 - Шадринск
10704 - Шарья
10762 - Шатура
10763 - Шаховская
11053 - Шахты
10780 - Шацк
11325 - Шебалино
11275 - Шелехов
11107 - Шемышейка
10851 - Шенкурск
11371 - Шилка
11392 - Шимановск
10918 - Шимск
11343 - Шира
11442 - Шологонцы
10800 - Шумячи
10691 - Шуя
10834 - Щекино
10765 - Щелково
1094 - Элиста
10984 - Эльтон
11147 - Энгельс
11338 - Эрзин
10683 - Эртиль
11177 - Югорск
11449 - Южно-Курильск
80 - Южно-Сахалинск
11227 - Южноуральск
11299 - Юрга
10692 - Юрьевец
11431 - Яковлевка
74 - Якутск
11470 - Ялта
11178 - Ялуторовск
11075 - Яранск
16 - Ярославль
10801 - Ярцево
11300 - Яшкино
11301 - Яя

Характеристики модели

Описание

GET /models/{id}/specification

Возвращает список характеристик, соотнесенных с указанной моделью.

URL ресурса:

http://wb.apisystem.name/models/{id}/specification


Пример запроса:

http://wb.apisystem.name/models/11962621/specification?&format=json&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
model_id model_id

Int64

Идентификатор модели.
url url

String

Адрес страницы модели на Wildberries.
product_name product_name

String

Наименование модели.
category category

String

Наименование категории.
prev_image prev_image

String

URL для предпросмотра фотографии товара.
description description

String

Описание товара.
vendor vendor

String

Производитель.
photos photos

Object list

Список фотографий товара.
specifications    specifications

Object list

Список характеристик товара.
Параметры, вложенные в photos
url url

String

URL фотографии товара.
Параметры, вложенные в specifications
name name

String

Название характеристики.
value value

String

Значение характеристики.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Список предложений на модель

Описание

GET /models/{id}/offers

Возвращает список товарных предложений, соотнесенных с указанной моделью.

URL ресурса:

http://wb.apisystem.name/models/{id}/offers


Пример запроса:

http://wb.apisystem.name/models/84018137/offers?format=json&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
gps QUERY List Нет

Географические координаты в формате широта,долгота

По умолчанию: 55.752490,37.623205 (Москва, Красная площадь, 7)
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json.
Параметры страницы
count QUERY Int32 Нет

Размер страницы (количество элементов на странице).

Ограничения:

  • Минимальное значение: 1, максимальное значение: 30

Значение по умолчанию: 10.
page QUERY Int32 Нет

Номер страницы.

Ограничения:

  • Минимальное значение: 1, максимальное значение: 50

Значение по умолчанию: 1.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
total_offers total_offers

Int32

Количество найденных предложений.
page page

Int32

Номер страницы.
count count

Int32

Размер страницы (количество элементов на странице).
price_avg price_avg

String

Средняя цена.
price_max price_max

String

Максимальная цена.
price_min price_min

String

Минимальная цена.
product_id product_id

Int64

Идентификатор модели.
product_name product_name

String

Наименование модели на Wildberries.
product_url product_url

String

Адрес страницы модели на Wildberries.
offers offers

Object list

Список товарных предложений модели

Предложение

Параметры, вложенные в offers
model_id model_id

Int64

Идентификатор модели.
offer_name offer_name

String

Наименование товара.
colors colors

String

Цвет товара.
brand brand

String

Торговая марка.
brand_id brand_id

Int32

Идентификатор торговой марка.
on_stock on_stock

Int32

Доступное количество товара для заказа.
stock_id stock_id

Int32

Идентификатор склада.
rating rating

Int32

Уровень популярности.
photos photos

Int32

Количество фотографий.
reviews reviews

Int32

Количество отзывов.
shop_id shop_id

Int32

Идентификатор магазина.
delivery_partner delivery_partner

String

Партнер, осуществляющий доставку.
delivery_time delivery_time

String

Дата курьерской доставки.
delivery_cost delivery_cost

Int32

Стоимость курьерской доставки.
discount_percent discount_percent

Int32

Процент скидки.
price price

Int32

Цена товара.
price_without_discount    price_without_discount

Int32

Цена товара без учёта скидки.
url url

String

Ссылка на Яндекс.Маркет.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Отзывы о модели

Описание

GET /models/{id}/opinions

Возвращает отзывы пользователей о модели.

URL ресурса:

http://wb.apisystem.name/models/{id}/opinions


Пример запроса:

http://wb.apisystem.name/models/11962621/opinions?format=json&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json .
Параметры страницы
count QUERY Int32 Нет

Размер страницы (количество элементов на странице).

Ограничения:

  • Минимальное значение: 1, максимальное значение: 30

Значение по умолчанию: 10.
page QUERY Int32 Нет

Номер страницы.

Ограничения:

  • Минимальное значение: 1

Значение по умолчанию: 1.
Параметры сортировки
sort QUERY Enum Нет

Тип сортировки отзывов о модели.

Возможные значения:
  • date — сортировка по дате.
  • grade — сортировка по оценке.
  • useful — сортировка по полезности.
  • only_photo — сортировка только с фото.
Значение по умолчанию: date.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
page page

Int32

Номер страницы.
count count

Int32

Размер страницы (количество элементов на странице).
model_id model_id

Int64

Идентификатор модели.
url url

String

Адрес страницы модели на Wildberries.
total_reviews total_reviews

Int32

Количество найденных отзывов.
total_pages total_pages

Int32

Количество страниц.
reviews reviews

Object list

Отзывы

Отзыв о модели

Параметры, вложенные в reviews
user_name user_name

String

Имя пользователя.
user_avatar_small user_avatar_small

String

Ссылка на малый аватар пользователя.
user_avatar_big user_avatar_big

String

Ссылка на большой аватар пользователя.
user_link user_link

String

Ссылка на профиль пользователя.
created created

Date

Дата создания отзыва.
comment comment

String

Комментарий пользователя.
answer answer

String

Ответ продавца на отзыв.
grade grade

Int32

Средняя оценка.
votes_yes votes_yes

Int32

Количество голосов "за".
votes_no votes_no

Int32

Количество голосов "против".
photos photos

Object list

Список фотографий товара.
Параметры, вложенные в photos
url url

String

URL фотографии товара.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.

Информация о магазине

Описание

GET /shop/{id}

Возвращает информацию об поставщике, соотнесенных с указанной ID модели.

URL ресурса:

http://wb.apisystem.name/shop/{id}


Пример запроса:

http://wb.apisystem.name/shop/19069981?format=json&api_key=

Входные данные

Параметр Положе­ние Тип Обяза­тельность Описание
id PATH Int64 Да

Идентификатор модели.
format QUERY Enum Нет

Формат выходных данных.

Возможные значения:
  • json — выходные данные будут в формате JSON.
  • xml — выходные данные будут в формате XML.
  • xls — выходные данные будут в формате MS Excel.
  • csv — выходные данные будут в формате CSV.
Значение по умолчанию: json.

Выходные данные

Описание параметров:

Параметр для формата JSON Параметр для формата XML Тип Описание
status status

Enum

Статус обработки запроса.

Возможные значения:

  • OK — операция выполнена успешно.

  • ERROR — произошла ошибка.
model_id model_id

Int32

Идентификатор модели.
shop_id shop_id

Int32

Идентификатор поставщика.
shop_name shop_name

String

Наименование поставщика.
vendor vendor

String

Наименование продавца.
logo logo

String

URL логотипа продавца.
inn inn

String

ИНН продавца.
ogrn ogrn

String

ОГРН продавца.
address address

String

Адрес.
registration registration

Date

Дата регистрации.
rating rating

String

Рейтинг.
reviews reviews

Int32

Количество отзывов.
sales sales

Int32

Количество продаж.
deliveries_on_time deliveries_on_time

Int32

Время доставки.
sales_defect sales_defect

String

Количество дефектов.

Возможные ошибки

В случае возникновения ошибочной ситуации сервер возвращает HTTP-статус ответа и сообщение об ошибке.