### GET /products
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Получить данные сбора по мониторингу
```markdown
### Parameters
- **limit** (string, query, optional): Кол-во записей на страницу (Макс. 100000)
- **skip** (string, query, optional): Смещение
- **apiKey** (string, query, required): API Key клиента
- **filter_market_sources** (union, query, optional): Названия сайтов через запятую
- **filter_monitoring** (union, query, optional): UUID мониторинга (если не указан - берется случайный из принадлежащих клиенту)
- **filter_market_collectedFrom** (string, query, optional): Дата время начала периода (Y-m-d H:i:s)
Обязателен при отсутствии filter_createdFrom и filter_createdTo
- **filter_market_collectedTo** (string, query, optional): Дата время окончания периода (Y-m-d H:i:s)
Обязателен при отсутствии filter_createdFrom и filter_createdTo
- **filter_createdFrom** (string, query, optional): Дата время начала периода записи в базу(Y-m-d H:i:s)
Обязателен при отсутствии filter_market_collectedFrom и filter_market_collectedTo
- **filter_createdTo** (string, query, optional): Дата время окончания периода записи в базу (Y-m-d H:i:s)
Обязателен при отсутствии filter_market_collectedFrom и filter_market_collectedTo
- **fields** (union, query, optional): Экспортируемые поля через запятую. Возможные поля:
| market.created | Дата/время записи данных в базу |
| market.collected | Дата/время получения данных |
| market.source | Название площадки - сайт |
| market.sourceId | ID площадки |
| market.url | Ссылка на товар |
| market.name | Название товара на площадке |
| market.article | Артикул товара на площадке |
| market.address | Адрес магазина |
| market.marketType | Формат магазина |
| market.partNumber | Артикул производителя |
| market.seller | Продавец |
| market.sellerName | Юр. название мерчанта |
| market.sellerId | Идентификатор продавца |
| market.brand | Бренд |
| market.availability | Наличие |
| market.remains | Остаток |
| market.image | Изображение |
| market.regionId | Регион |
| market.price.value | Цена товара |
| market.price.currency | Валюта товара |
| market.discountPrice.value | Цена товара со скидкой |
| market.discountPrice.currency | Валюта товара со скидкой |
| market.priceByCard.value | Цена по карте |
| market.priceByCard.currency | Валюта товара по карте |
| market.basicPrice.value | Цена без СПП |
| market.basicPrice.currency | Валюта товара без СПП |
| market.category | Категория товара |
| market.characteristics | Атрибуты товара |
| market.cashback | Баллы/бонусы |
| market.reviewsCount | Кол-во отзывов |
| market.deliveryDate | Дата доставки |
| market.deliveryDays | Срок доставки |
| market.pickupDate | Дата самовывоза |
| market.barcode | Штрих-код |
| market.isFromAbroad | Товар из-за рубежа |
| market.rating | Рейтинг |
| sku.name | Название товара из семантики (Name) |
| sku.nameClient | Название клиента из семантики (NameClient) |
| sku.brand | Бренд товара из семантики (Brand) |
| sku.article | Артикул товара из семантики (Barcode) |
| sku.category | Категория товара из семантики (Category) |
| sku.price.value | Цена РРЦ товара |
| sku.price.currency | Валюта товара |
| sku.custom | Доп.поля из семантики |
{
"success": true,
"message": null,
"data": [
{
"id": "199a4607-fded-4c8a-a2cb-33e269277928",
"market": {
"collected": "2022-09-26 02:14:04",
"availability": "InStock",
"article": null,
"name": "Эксмо / Убийство Роджера Экройда",
"url": "https://www.wildberries.ru/catalog/9414535/detail.aspx",
"seller": "ТД Эксмо",
"brand": "Эксмо",
"source": "wildberries.ru",
"price": {
"value": 343,
"currency": "RUB"
},
"discountPrice": {
"value": 264,
"currency": "RUB"
},
"regionId": "Москва",
"region": {
"city": "Москва",
"state": "Московская область",
"district": "Центральный федеральный округ",
"country": "Россия"
}
},
"sku": {
"name": "978-5-04-118543-5",
"article": "1698881",
"category": "ЭКСМО СЗКО",
"price": null
}
},
{
"id": "bebac394-b922-44ad-a19c-d8381848182d",
"market": {
"collected": "2022-09-26 02:14:57",
"availability": "InStock",
"article": null,
"name": "Эксмо / Великий Гэтсби",
"url": "https://www.wildberries.ru/catalog/42940647/detail.aspx",
"seller": "ТД Эксмо",
"brand": "Эксмо",
"source": "wildberries.ru",
"price": {
"value": 545,
"currency": "RUB"
},
"discountPrice": {
"value": 381,
"currency": "RUB"
},
"regionId": "Москва",
"region": {
"city": "Москва",
"state": "Московская область",
"district": "Центральный федеральный округ",
"country": "Россия"
}
},
"sku": {
"name": "978-5-04-097637-9",
"article": "1503672",
"category": "ЭКСМО СЗКО",
"price": null
}
},
{
"id": "645bae8f-e091-4b14-a38a-31e6eaedcb15",
"market": {
"collected": "2022-09-26 02:17:58",
"availability": "InStock",
"article": null,
"name": "Издательство АСТ / Волонтеры вечности (Лабиринты Ехо - 2, илл. О.Закис)",
"url": "https://www.wildberries.ru/catalog/12529492/detail.aspx",
"seller": "Издательство АСТ",
"brand": "Издательство АСТ",
"source": "wildberries.ru",
"price": {
"value": 802,
"currency": "RUB"
},
"discountPrice": {
"value": 641,
"currency": "RUB"
},
"regionId": "Москва",
"region": {
"city": "Москва",
"state": "Московская область",
"district": "Центральный федеральный округ",
"country": "Россия"
}
},
"sku": {
"name": "978-5-17-087846-8",
"article": "1067778",
"category": "АСТ СЗКО",
"price": null
}
}
],
"pagination": {
"total": 92492,
"limit": 3,
"skip": 1
}
}
- **paginate** (object) (required)
- **total** (integer) (required)
- **limit** (integer) (required)
- **skip** (integer) (required)
#### 404 - Not Found
**ErrorModel**
- **success** (boolean)
- **message** (string) (required)
- **data** (unknown) (required)
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X GET "https://api.example.com/products?limit=10000&skip=0&apiKey=string&filter_market_sources=value&filter_monitoring=value&filter_market_collectedFrom=string&filter_market_collectedTo=string&filter_createdFrom=string&filter_createdTo=string&fields=value"
```
```
--------------------------------
### GET /reports
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Получить список отчетов
```markdown
### Parameters
- **apiKey** (string, query, required): API Key клиента
- **filter_monitoring** (union, query, optional): Список UUID мониторингов
### Responses
#### 200 - Successful Response
**ResponseModelReports**
- **success** (boolean)
- **message** (string) (required)
- **data** (array (object)) (required): response example:
{
"success": true,
"message": null,
"data": [
{
"uuid": "310ad629-867e-4ab2-8e14-253c889c61e1",
"monitoring_uuid": "77a71c13-a038-42ab-96d9-ff98d5b00d51",
"report_type": "advanced_report",
"period_start": "2025-02-12 09:00:00",
"period_end": "2025-02-12 13:00:00"
},
{
"uuid": "abb0c02f-ed9a-4a8c-a7c4-cdfb0a1022f3",
"monitoring_uuid": "77a71c13-a038-42ab-96d9-ff98d5b00d51",
"report_type": "advanced_report",
"period_start": "2025-02-11 21:00:00",
"period_end": "2025-02-12 09:00:00"
},
{
"uuid": "5e0570ad-059f-4871-b08a-1ab248a6b56c",
"monitoring_uuid": "77a71c13-a038-42ab-96d9-ff98d5b00d51",
"report_type": "advanced_report",
"period_start": "2025-02-11 13:00:00",
"period_end": "2025-02-11 17:00:00"
}
]
}
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X GET "https://api.example.com/reports?apiKey=string&filter_monitoring=value"
```
```
--------------------------------
### GET /reports/{report_id}
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Получить данные из отчета
```markdown
### Parameters
- **report_id** (string (uuid), path, required)
- **limit** (union, query, optional): Кол-во записей на страницу (Макс. 100000)
- **skip** (union, query, optional): Смещение
- **apiKey** (string, query, required): API Key клиента
### Responses
#### 200 - Successful Response
**ResponseModelReportRU**
- **success** (boolean)
- **message** (string) (required)
- **data** (array (object)) (required): response example:
{
"success": true,
"message": null,
"data": [
{
"index": "1",
"uuid": "d078ebee-ff1f-4549-9e52-dd97e0d81e58",
"RegionUUID": "19dc8656-1b85-4f00-baaf-0a6c2e8c22f9",
"market_seller": "kuvalda.ru",
"market_hash": "3ccb9663b601de98e2668aedd5817706",
"market_source_isMarket": "N",
"sku_nameClient": "SE 4 Plus *EU",
"market_brand": "KARCHER",
"sku_article": "1.081-170.0",
"market_price_oldPrice": "41290.00",
"sku_name": "SE 4 Plus *EU",
"sku_note": "",
"sku_uuid": "033634b5-9096-4b77-aa95-a3be17627b6b",
"market_price_currency": "RUB",
"sku_category": "",
"market_price_discountPrice": "0.00",
"market_region_uuid": "19dc8656-1b85-4f00-baaf-0a6c2e8c22f9",
"market_source_name": "kuvalda.ru",
"sku_ean": "",
"market_address": "",
"sku_price_value": "41290.00",
"sku_brand": "Karcher",
"sku_category2": "",
"market_custom": "{'imageLink': 'https://cdn.kuvalda.ru/data/file_resize/product/60/3c/a3/landing-603ca31c1c5766a4df40da258649c129.jpg'}",
"market_url": "https://www.kuvalda.ru/catalog/9985/product-199778/",
"market_rating": "",
"market_image": "https://cdn.kuvalda.ru/data/file_resize/product/60/3c/a3/landing-603ca31c1c5766a4df40da258649c129.jpg",
"sku_image": "",
"market_availability": "InStock",
"market_internalArticle": "",
"market_screenshot": "",
"market_article": "",
"sku_custom": "{}",
"market_price_price": "34990.00",
"market_collected": "2025-02-12 09:14:49+03:00",
"market_source_uuid": "62365f85-2969-4f50-8bc1-d9bc919df483",
"market_name": "Пылесос сетевой KARCHER SE 4 Plus (1.081-170.0), моющий 1.081-170.0",
"date": "2025-02-12",
"no_scheme_www": "kuvalda.ru/catalog/9985/product-199778/",
"cleaned_url": "kuvalda.ru/catalog/9985/product-199778",
"s_url_1": "",
"s_url2": "",
"pre_hash": "3ccb9663b701de88e2768aedd5817706kuvalda.ru",
"hash": "192b7df2436ce77d0f9cdbd510c7e605",
"market_custom_imageLink": "https://cdn.kuvalda.ru/data/file_resize/product/60/3c/a3/landing-603ca31c1c5766a4df40da258649c129.jpg",
"market_region_name": "Москва",
"market_region_city_name": "Москва",
"market_region_city_uuid": "19dc8656-1b85-4f00-baaf-0a6c2e8c22f9",
"market_region_state_name": "Московская область",
"market_region_state_uuid": "469ec355-14d7-4666-ae0b-5c45e1e84af0",
"market_region_district_name": "Центральный федеральный округ",
"market_region_district_uuid": "9ae4b531-f577-487c-b011-32e7b91f7389",
"market_region_country_name": "Россия",
"market_region_country_uuid": "e51092b2-2041-49d9-ad60-19d2e29f6a37",
"market_custom_color": "nan",
"market_custom_sellerOgrn": "nan",
"market_custom_region": "nan",
"market_custom_supplierName": "nan",
"market_custom_sellerLink": "nan",
"market_custom_typeProduct": "nan",
"market_custom_sellerAddress": "nan",
"market_custom_rating": "nan",
"market_custom_reviewsCount": "nan",
"market_custom_breadCrumbs": "nan",
"market_custom_power": "nan",
"market_custom_voltage": "nan",
"market_custom_battery_capacity": "nan",
"market_custom_itemCondition": "nan",
"market_custom_partNumber": "nan",
"market_custom_count": "nan",
"market_custom_uom": "nan",
"market_custom_uom_count": "nan",
"market_custom_volume": "nan",
"market_custom_material": "nan",
"market_custom_speeds_count": "nan",
"market_custom_is_available": "nan",
"market_custom_model": "nan",
"market_custom_card_price": "nan",
"market_custom_comments": "nan",
"market_custom_sellerRating": "nan",
"market_custom_productDescription": "nan",
"market_custom_ordersCount": "nan",
"market_custom_availableCount": "nan",
"market_custom_characteristics": "nan",
"market_custom_sellerInn": "nan",
"market_custom_sellerLegalAddress": "nan",
"market_custom_subjName": "nan",
"market_custom_firstDate": "nan",
"market_custom_deep": "nan",
"market_custom_width": "nan",
"market_custom_partnumber": "nan",
"market_custom_collection": "nan",
"market_custom_ean": "nan",
"market_custom_sellerINN": "nan",
"market_custom_email": "nan",
"market_custom_phone": "nan",
"market_custom_deliveryDays": "nan",
"market_custom_pickupDays": "nan",
"market_custom_itemAppearance": "nan",
"market_custom_itemState": "nan",
"market_custom_dateAndAvailableCount": "nan",
"market_custom_availableCountStatus": "nan",
"market_custom_series": "nan",
"market_custom_length": "nan",
"market_custom_city": "nan",
"market_custom_price_type": "nan",
"market_custom_availableText": "nan",
"market_custom_net_weight": "nan"
}
],
"pagination": {
"total": 17996,
"limit": 3,
"skip": 0
}
}
- **paginate** (object) (required)
- **total** (integer) (required)
- **limit** (integer) (required)
- **skip** (integer) (required)
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X GET "https://api.example.com/reports/{report_id}?limit=value&skip=value&apiKey=string"
```
```
--------------------------------
### POST /products/file
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Отправить список товаров файлом
```markdown
### Parameters
- **apiKey** (union, query, required): API Key клиента
- **Content-Type** (union, header, optional)
### Request Body
**Content-Type:** multipart/form-data
- **file** (string (binary)) (required): Отправлять файл или тело запроса в формате JSON или XML. Файл можно упаковать в ZIP или GZ. Имя файла должно совпадать с именем в архиве.
### Responses
#### 200 - Successful Response
**ResponseModelPostFiles**
- **success** (boolean)
- **message** (string) (required)
- **data** (null) (required)
#### 400 - Bad Request
**ErrorModel**
- **success** (boolean)
- **message** (string) (required)
- **data** (unknown) (required)
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X POST "https://api.example.com/products/file?apiKey=value" \
-H "Content-Type: application/json" \
-d '{
"file": "string"
}'
```
```
--------------------------------
### POST /products
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Отправить список товаров
```markdown
### Parameters
- **apiKey** (string, query, required): API Key клиента
- **content-type** (union, header, required)
### Request Body
**Content-Type:** application/json
- **products** (array (ProductRU)) (required): Пример данных в xml:
{
"products":[{
"name":"test name",
"brand":"test brand",
"vendor_code":"test vendor_code",
"vendor_code_internal":"test vendor_code_internal",
"category":"test category",
"currency":"RUB",
"price":100,
"price_discount":90,
"availability":"InStock",
"barcode":"test barcode",
"color":"black",
"url":"https://www.php.net/manual/ru/xmlreader.xml.php",
"image_url":"https://www.php.net/manual/ru/xmlreader.xml.php",
"assortment_distribution":"test"
},{
"name":"test name2",
"brand":"test brand2",
"vendor_code":"test vendor_code2"
}]
}
Array items:
- **external_uuid** (string)
- **name** (string) (required): Наименование товара
- **brand** (string) (required): Бренд
- **vendor_code** (string)
- **vendor_code_internal** (string)
- **vendor_country** (string)
- **category** (string)
- **currency** (string)
- **price** (integer)
- **price_discount** (integer)
- **availability** (string (InStock|OutOfStock)) ("InStock"|"OutOfStock")
- **barcode** (string)
- **color** (string)
- **url** (string (uri))
- **image_url** (string (uri))
- **assortment_distribution** (string)
- **name_translation** (string)
- **volume** (string)
- **series** (string)
- **sugar** (string)
- **note** (string)
### Responses
#### 200 - Successful Response
**ResponseModelPostFiles**
- **success** (boolean)
- **message** (string) (required)
- **data** (null) (required)
#### 400 - Bad Request
**ErrorModel**
- **success** (boolean)
- **message** (string) (required)
- **data** (unknown) (required)
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X POST "https://api.example.com/products?apiKey=string" \
-H "Content-Type: application/json" \
-d '{
"products": [
"value"
]
}'
```
```
--------------------------------
### Schema: ProductToDeleteRU
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Schema definition for ProductToDeleteRU
```markdown
## Schema: ProductToDeleteRU
Schema definition for ProductToDeleteRU
**Type:** object
- **products** (array (string)) (required): Список наименований товаров
{
"products":[{
"name":"test name",
"brand":"test brand",
"vendor_code":"test vendor_code",
"vendor_code_internal":"test vendor_code_internal",
"category":"test category",
"currency":"RUB",
"price":100,
"price_discount":90,
"availability":"InStock",
"barcode":"test barcode",
"color":"black",
"url":"https://www.php.net/manual/ru/xmlreader.xml.php",
"image_url":"https://www.php.net/manual/ru/xmlreader.xml.php",
"assortment_distribution":"test"
},{
"name":"test name2",
"brand":"test brand2",
"vendor_code":"test vendor_code2"
}]
}
Array items:
- **external_uuid** (string)
- **name** (string) (required): Наименование товара
- **brand** (string) (required): Бренд
- **vendor_code** (string)
- **vendor_code_internal** (string)
- **vendor_country** (string)
- **category** (string)
- **currency** (string)
- **price** (integer)
- **price_discount** (integer)
- **availability** (string (InStock|OutOfStock)) ("InStock"|"OutOfStock")
- **barcode** (string)
- **color** (string)
- **url** (string (uri))
- **image_url** (string (uri))
- **assortment_distribution** (string)
- **name_translation** (string)
- **volume** (string)
- **series** (string)
- **sugar** (string)
- **note** (string)
```
--------------------------------
### POST /post_links
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Отправить список товаров со ссылками
```markdown
### Parameters
- **apiKey** (string, query, required): API Key клиента
- **content-type** (union, header, required)
### Request Body
**Content-Type:** application/json
- **domain** (string) (required)
- **products** (array (LinkRU)) (required): Пример данных в xml:
{
"domain": "test.com",
"products":[{
"name":"test name",
"brand":"test brand",
"vendor_code":"test vendor_code",
"vendor_code_internal":"test vendor_code_internal",
"category":"test category",
"currency":"RUB",
"price":100,
"price_discount":90,
"availability":"InStock",
"barcode":"test barcode",
"color":"black",
"url":"https://test.com/manual/ru/xmlreader.xml.php",
"image_url":"https://test.com/manual/ru/xmlreader.xml.php",
"assortment_distribution":"test"
},{
"name":"test name2",
"url":"https://test.com/manual/ru/xmlwriter.xml.php"
}]
}
Array items:
- **external_uuid** (string)
- **name** (string) (required): Наименование товара
- **url** (string (uri)) (required): Ссылка на товар
- **brand** (string)
- **vendor_code** (string)
- **vendor_code_internal** (string)
- **vendor_country** (string)
- **category** (string)
- **currency** (string)
- **price** (integer)
- **price_discount** (integer)
- **availability** (string (InStock|OutOfStock)) ("InStock"|"OutOfStock")
- **barcode** (string)
- **color** (string)
- **image_url** (string (uri))
- **assortment_distribution** (string)
- **name_translation** (string)
- **volume** (string)
- **series** (string)
- **sugar** (string)
- **note** (string)
### Responses
#### 200 - Successful Response
**ResponseModelPostFiles**
- **success** (boolean)
- **message** (string) (required)
- **data** (null) (required)
#### 400 - Bad Request
**ErrorModel**
- **success** (boolean)
- **message** (string) (required)
- **data** (unknown) (required)
#### 422 - Validation Error
**HTTPValidationError**
- **detail** (array (ValidationError))
Array items:
- **loc** (array (union)) (required)
- **msg** (string) (required)
- **type** (string) (required)
### Example Usage
```bash
curl -X POST "https://api.example.com/post_links?apiKey=string" \
-H "Content-Type: application/json" \
-d '{
"domain": "string",
"products": [
"value"
]
}'
```
```
--------------------------------
### Schema: Paginate
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Schema definition for Paginate
```markdown
## Schema: Paginate
Schema definition for Paginate
**Type:** object
- **total** (integer) (required)
- **limit** (integer) (required)
- **skip** (integer) (required)
```
--------------------------------
### Schema: ResponseModelPostFiles
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Schema definition for ResponseModelPostFiles
```markdown
## Schema: ResponseModelPostFiles
Schema definition for ResponseModelPostFiles
**Type:** object
- **success** (boolean)
- **message** (string) (required)
- **data** (null) (required)
```
--------------------------------
### Schema: LinkRU
Source: https://api.kipmonitor.com/v2/openapi-ru.json
Schema definition for LinkRU
```markdown
## Schema: LinkRU
Schema definition for LinkRU
**Type:** object
- **external_uuid** (string)
- **name** (string) (required): Наименование товара
- **url** (string (uri)) (required): Ссылка на товар
- **brand** (string)
- **vendor_code** (string)
- **vendor_code_internal** (string)
- **vendor_country** (string)
- **category** (string)
- **currency** (string)
- **price** (integer)
- **price_discount** (integer)
- **availability** (string (InStock|OutOfStock)) ("InStock"|"OutOfStock")
- **barcode** (string)
- **color** (string)
- **image_url** (string (uri))
- **assortment_distribution** (string)
- **name_translation** (string)
- **volume** (string)
- **series** (string)
- **sugar** (string)
- **note** (string)
```