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



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

  1. Ко всем запросам необходимо добавить GET-параметр api_key.
    В его значении указать API-ключ из личного кабинета. http://market.apisystem.name/models/10887816/offers?&api_key=<ключ>
  2. Частота запросов: не чаще 1-го запроса в секунду.
  3. После регистрации на аккаунте доступно 100 тестовых запроса.
  4. Все URL-запросы к API можно открыть в браузере и в реальном времени увидеть результат (вкладка JSON в Firefox), среднее время ответа ~2 секунды.
  5. Советы для избежания ошибок и быстрого ответа на запросы:
    - Дожидаться ответа сервера перед отправкой нового запроса.
    - Добавить задержку в 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. 403 "Error occurred, please try again later" - ошибка с нашей стороны.
    Повторите запрос, спустя ~30 секунд.
  7. 403 "Error. No such product." - такого товара, нет.
  8. 403 "Error. No such supplier." - такого поставщика, нет.

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

Описание

GET /models/{id}/specification

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

URL ресурса:

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


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

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


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

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


Пример ответа:

https://www.apisystem.name/example_ym/specification.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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/1773145542/offers?&sort=aprice&format=json&api_key=


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

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


Пример ответа:

https://www.apisystem.name/example_ym/offers.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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.
resale QUERY Int32 Нет

Фильтр "Только Ресейл товары".

Возможные значения:
  • 0 — Только новые товары.
  • 1 — Только Ресейл товары.
Значение по умолчанию: 0.
resale_condition QUERY String Нет

Фильтр "Внешний вид ресейл товаров".

Возможные значения:
  • perfect — Как новый.
  • excellent — Отличный.
  • well — Хороший.
По умолчанию не используется. Активен при resale=1.
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

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

String

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

Boolean

Признак экспресс-оффера.
resale resale

Boolean

Признак resale-оффера.
resale_condition resale_condition

String

Внешний вид resale-оффера.
on_stock on_stock

Int32

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

Int32

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

Int32

Бизнес идентификатор магазина.
shop_logo shop_logo

String

Логотип магазина.
shop_rating shop_rating

String

Уровень популярности магазина.
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

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

String

Промокод.
promocode_date promocode_date

String

Срок действия промокода.
price price

Int32

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

Int32

Цена товара по промокоду.
price_yandex_pay price_yandex_pay

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/1773145542/opinions?&format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_ym/opinions.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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-статус ответа и сообщение об ошибке.

Вопросы по модели

Описание

GET /models/{id}/questions

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

URL ресурса:

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


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

http://market.apisystem.name/models/1773145542/questions?&format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_ym/questions.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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.

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

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

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

Enum

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

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

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

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

Int32

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

Int32

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

Int64

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

String

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

Int32

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

Int32

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

Object list

Вопросы

Вопрос по модели

Параметры, вложенные в questions
id_questions id_questions

Int64

Уникальный идентификатор вопроса.
id_user id_user

String

Уникальный идентификатор пользователя.
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

Ответ продавца.

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

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

Вопросы по модели

Описание

GET /models/{id}/questions

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

URL ресурса:

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


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

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


Пример ответа:

https://www.apisystem.name/example_wb/questions.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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.

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

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

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

Enum

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

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

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

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

Int32

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

Int32

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

Int64

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

String

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

Int32

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

Int32

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

Object list

Вопросы

Вопрос по модели

Параметры, вложенные в questions
id_questions id_questions

String

Уникальный идентификатор вопроса.
id_user id_user

Int64

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

String

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

String

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

Date

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

String

Вопрос пользователя.
answer answer

String

Ответ продавца.

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

В случае возникновения ошибочной ситуации сервер возвращает 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 /info

Возвращает статистику аккаунта.

URL ресурса:

http://market.apisystem.name/info


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

http://market.apisystem.name/info?&api_key=


Пример ответа:

https://www.apisystem.name/example/info.json

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

Не требуются.

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

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

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

String

Адрес электронной почты.
api_key api_key

String

Ключ для доступа к API.
subscription subscription

Object list

Информация об активных подписках.
limit limit

Object list

Информация о лимитах.
remainded remainded

Object list

Информация о доступном количестве запросов.
discount discount

Object list

Информация о доступных скидках.
Параметры, вложенные в subscription
requests requests

Int32

Количество оставшихся запросов.
tarif_base_expired tarif_base_expired

Int64

Время окончания подписки на тариф "Базовый".
tarif_optima_expired tarif_optima_expired

Int64

Время окончания подписки на тариф "Оптимальный".
tarif_premium_expired tarif_premium_expired

Int64

Время окончания подписки на тариф "Премиум".
tarif_unlimited_expired tarif_unlimited_expired

Int64

Время окончания подписки на тариф "Безлимитный".
Параметры, вложенные в limit
tarif_base_limit tarif_base_limit

Int32

Количесто запросов в сутки на тарифе "Базовый".
tarif_optima_limit tarif_optima_limit

Int32

Количесто запросов в сутки на тарифе "Оптимальный".
tarif_premium_limit tarif_premium_limit

Int32

Количесто запросов в сутки на тарифе "Премиум".
tarif_unlimited_limit tarif_unlimited_limit

String

Количесто запросов в сутки на тарифе "Безлимитный".
Параметры, вложенные в remainded
tarif_base_requests tarif_base_requests

Int32

Количесто запросов, доступное на тарифе "Базовый".
tarif_optima_requests tarif_optima_requests

Int32

Количесто запросов, доступное на тарифе "Оптимальный".
tarif_premium_requests   tarif_premium_requests

Int32

Количесто запросов, доступное на тарифе "Премиум".
tarif_unlim_requests tarif_unlim_requests

String

Количесто запросов, доступное на тарифе "Безлимитный".
Параметры, вложенные в discount
15000 15000

String

Скидка, доступная при сумме пополнений больше 15 000 рублей.
30000 30000

String

Скидка, доступная при сумме пополнений больше 30 000 рублей.
60000 60000

String

Скидка, доступная при сумме пополнений больше 60 000 рублей.
sum_payment sum_payment

Int32

Сумма пополнений.
active_discount active_discount

String

Значение активной скидки.

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

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

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

Описание

GET /shop/{id}

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

URL ресурса:

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


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

http://market.apisystem.name/shop/1073490?format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_ym/shop.json

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

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

Идентификатор магазина.
Можно получить только в offers, параметр shop_id в ответе.
format QUERY Enum Нет

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

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

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

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

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

Enum

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

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

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

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

Int32

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

String

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

String

Название магазина поставщика.
ogrn ogrn

String

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

String

Адрес.

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

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

Артикул Маркета

Описание

GET /pr/{id}

Возвращает истинный ID модели при отправке ID из личного кабинета магазина.

URL ресурса:

http://market.apisystem.name/pr/{id}


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

http://market.apisystem.name/pr/4168341185?api_key=


Пример ответа:

https://www.apisystem.name/example_ym/pr.json

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

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

ID модели.
format QUERY Enum Нет

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

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

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

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

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

Enum

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

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

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

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

Int32

Внутренний ID Яндекс.Маркета.
market_url market_url

String

URL с внутренним ID Яндекс.Маркета.
true_article true_article

Int32

Истинный ID Яндекс.Маркета.
true_url true_url

String

URL с истинным ID Яндекс.Маркета.
true_specification true_specification

String

URL спецификации с истинным ID Яндекс.Маркета.
true_offers true_offers

String

URL списка предложений с истинным ID Яндекс.Маркета.
true_opinions true_opinions

String

URL отзывов с истинным ID Яндекс.Маркета.
true_questions true_questions

String

URL вопросов по модели с истинным ID Яндекс.Маркета.

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

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

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

Описание

GET /models/{id}/specification

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

URL ресурса:

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


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

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


Пример ответа:

https://www.apisystem.name/example_wb/specification.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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/175333001/offers?format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_wb/offers.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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_wb_pay price_wb_pay

Int32

Цена товара с WB кошельком.
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/32175789/opinions?format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_wb/opinions.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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 — сортировка по оценке.
  • 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
id_opinions id_opinions

String

Идентификатор отзыва.
id_user id_user

Int32

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

String

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

String

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

Date

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

String

Статус товара.

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

  • refused — покупатель отказался от товара.

  • buyout — покупатель выкупил товар.

  • null — нет данных.
dignities dignities

String

Достоинства товара.
disadvantages disadvantages

String

Недостатки товара.
comment comment

String

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

String

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

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/11962621?format=json&api_key=


Пример ответа:

https://www.apisystem.name/example_wb/shop.json

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

Параметр Положе­ние Тип Обяза­тельность Описание
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_url shop_url

String

Адрес страницы поставщика на Wildberries.
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-статус ответа и сообщение об ошибке.