Документация API
ParserData API предоставляет доступ к актуальным данным о товарах с маркетплейсов и интернет магазинов в режиме реального времени.
Base URL: https://apimarket.parserdata.ru/api/v2
Аутентификация
Все запросы к API требуют токен аутентификации. Токен передается в заголовке Authorization.
Найти и скопировать токен вы можете на главной странице после входа в аккаунт.
curl -X POST "https://apimarket.parserdata.ru/api/v2/cards/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json"
Важно: Храните ваш API ключ в безопасности.
Быстрый старт
Простой пример поиска товара на Wildberries:
curl -X POST "https://apimarket.parserdata.ru/api/v2/cards/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{"name": "iPhone 17 Pro"}
],
"domain": ["wildberries.ru"]
}'
Поиск товаров
Поиск товаров по названию или ссылкам на указанных маркетплейсах.
Постановка задачи
/api/v2/cards/
Создает задачу на поиск товаров. Возвращает task_id для получения результатов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
products |
array | Массив объектов с полем name или link. Дополнительно можно передать custom_fields |
domain |
array | Список доменов маркетплейсов (wildberries.ru, ozon.ru и т.д.) |
Пример запроса
curl -X POST "https://apimarket.parserdata.ru/api/v2/cards/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{"link": "https://petrovich.ru/catalog/285396691/"},
{"name": "Santek Ламма 170х70", "custom_fields": {"db_id": 981546324723}}
],
"domain": ["petrovich.ru"],
}'
Пример ответа
{
"task_id": 2716331
}
Получение результатов
/api/v2/cards/{task_id}/
Получает результаты выполненной задачи по task_id. Поддерживает пагинацию для больших результатов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
page |
integer | Номер страницы (по умолчанию: 1) |
Пример запроса
curl -X GET "https://apimarket.parserdata.ru/api/v2/cards/2716331/?page=1" \
-H "Authorization: Token YOUR_API_KEY"
Пример ответа
{
"count": 2,
"next": null,
"previous": null,
"results": [
{
"domain": "petrovich.ru",
"product_name": null,
"custom_fields": {},
"status": "OK",
"cards": [
{
"sku": "650607",
"link": "https://petrovich.ru/product/650607/",
"brand": null,
"image": "https://cs.p-static.ru/image/5747956/original.jpg",
"price": 201.0,
"title": "Выключатель Systeme Electric AtlasDesign одноклавишный встраиваемый белый (ATN000111)",
"position": 1,
"card_price": 195.0,
"original_price": 201.0
}
]
},
{
"domain": "petrovich.ru",
"product_name": "Santek Ламма 170х70",
"custom_fields": {
"db_id": 981546324723
},
"status": "OK",
"cards": [
{
"sku": "1033988",
"link": "https://petrovich.ru/product/1033988/",
"brand": null,
"image": "https://cs.p-static.ru/image/37282866/original.jpg",
"price": 12900.0,
"title": "Ванна акриловая Santek Ламма 170х70 см без ножек (1.WH50.1.747)",
"position": 1,
"card_price": null,
"original_price": 12900.0
},
{
"sku": "1033991",
"link": "https://petrovich.ru/product/1033991/",
"brand": null,
"image": "https://cs.p-static.ru/image/53994074/original.jpg",
"price": 7040.0,
"title": "Каркас для ванны акриловой Santek Ламма 170х70 см с монтажным набором (1.WH50.1.749)",
"position": 2,
"card_price": null,
"original_price": 7040.0
}
]
}
],
"status": "OK"
}
Получение цен
Получение актуальных цен товаров с маркетплейсов.
Постановка задачи
/api/v2/offers/
Создает задачу на получение цен товаров. Возвращает task_id для получения результатов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
products |
array | Массив объектов с полем link. Дополнительно можно передать custom_fields |
regions |
array | Массив идентификаторов регионов (работает не везде, уточняйте в поддержке). По умолчанию Москва |
Дополнительно: Также существует возможность сбора цен с использованием аккаунтов и сохранением скриншотов. Для информации обращайтесь в поддержку.
Пример запроса
curl -X POST "https://apimarket.parserdata.ru/api/v2/offers/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{
"link": "https://www.ozon.ru/product/apple-smartfon-iphone-13-eu-4-128-gb-chernyy-1974224330/",
"custom_fields": {"item_id": 85}
}
],
"regions": [213]
}'
Пример ответа
{
"task_id": 893041
}
Получение результатов
/api/v2/prices/{task_id}/
Получает результаты задачи по получению цен. Поддерживает пагинацию.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
page |
integer | Номер страницы (по умолчанию: 1) |
Пример запроса
curl -X GET "https://apimarket.parserdata.ru/api/v2/offers/893041/?page=1" \
-H "Authorization: Token YOUR_API_KEY"
Пример ответа
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"region": 213,
"domain": "ozon.ru",
"link": "https://www.ozon.ru/product/apple-smartfon-iphone-13-eu-4-128-gb-chernyy-1974224330/",
"custom_fields": {
"item_id": 85
},
"status": "OK",
"data": {
"sku": 1974224330,
"brand": "Apple",
"image": "https://ir.ozone.ru/s3/multimedia-1-h/c50/7503335117.jpg",
"title": "Apple Смартфон iPhone 13 EU 4/128 ГБ, черный",
"rating": 4.9,
"reviews": 220,
"brand_id": 26303000,
"category": "Электроника",
"not_found": false,
"scraped_at": "2026-04-16 23:19:07",
"breadcrumbs": "Электроника;;;Телефоны и смарт-часы;;;Смартфоны;;;Apple",
"category_id": 15500,
"out_of_stock": false,
"screenshot_url": null
},
"offers": [
{
"shop": "ОАЭшка",
"price": 39515.0,
"promo": null,
"shop_id": 2672324,
"promo_id": null,
"quantity": 10,
"shop_link": "https://www.ozon.ru/seller/oaeshka/",
"shop_ogrn": null,
"warehouse": null,
"card_price": 38341.0,
"delivery_date": null,
"delivery_type": null,
"original_price": 43249.0,
"shop_official_name": null
}
]
}
],
"status": "OK"
}
Получение характеристик
Получение подробных характеристик и описаний товаров.
Постановка задачи
/api/v2/specs/
Создает задачу на получение характеристик товаров. Возвращает task_id для получения результатов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
products |
array | Массив объектов с полем link. Дополнительно можно передать custom_fields |
Пример запроса
curl -X POST "https://apimarket.parserdata.ru/api/v2/specs/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{"link": "https://petrovich.ru/product/106958/", "custom_fields": {"ID": "651739df-2114-4929-ae3e-524fbe833546"}}
]
}'
Пример ответа
{
"task_id": 1322145
}
Получение результатов
/api/v2/specs/{task_id}/
Получает результаты задачи по получению характеристик. Поддерживает пагинацию.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
page |
integer | Номер страницы (по умолчанию: 1) |
Пример запроса
curl -X GET "https://apimarket.parserdata.ru/api/v2/specs/1322145/?page=1" \
-H "Authorization: Token YOUR_API_KEY"
Пример ответа
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"domain": "petrovich.ru",
"link": "https://petrovich.ru/product/106958/",
"custom_fields": {
"ID": "651739df-2114-4929-ae3e-524fbe833546"
},
"status": "OK",
"specs": {
"code": "106958",
"docs": [],
"title": "Штукатурка гипсовая Knauf Ротбанд 30 кг",
"photos": [
"https://cs.p-static.ru/image/1703875/original.jpg",
"https://cs.p-static.ru/image/1703866/original.jpg",
"https://cs.p-static.ru/image/52114405/original.jpg",
"https://cs.p-static.ru/image/52114393/original.jpg"
],
"rating": "4.7",
"details": [
{
"title": "Очистка",
"values": []
},
{
"title": "Грунтование",
"values": [
"Во избежание неравномерного схватывания раствора оштукатуриваемые поверхности обрабатываются грунтовкой Кнауф-Миттельгрунд, разведенной водой в соотношении 1:3, или грунтовкой Кнауф-Мультигрунд. Кладка из силикатного кирпича и газопенобетонных блоков грунтуется Кнауф-Миттельгрунд, разбавленной водой в соотношении 1:4 и 1:5 соответственно, или Кнауф-Мультигрунд. Плотные, гладкие, слабовпитывающие и не впитывающие влагу поверхности, например, бетон, цементные штукатурки, пазогребневые и пенополистирольные плиты, обрабатываются грунтовкой Кнауф-Бетоконтакт или Кнауф-Бетогрунд для улучшения адгезии (сцепления) штукатурки с поверхностью. После нанесения дать грунтовке высохнуть: Кнауф-Миттельгрунд и Кнауф-Мультигрунд —6 часов, Кнауф-Бетоконтакт — 12 часов, Кнауф-Бетогрунд — 2 часа.",
"Не допускать запыления загрунтованной поверхности.",
"Компания КНАУФ не гарантирует качество и долговечность получаемой поверхности в случае применения грунтов других производителей. "
]
},
{
"title": "Установка маячковых профилей",
"values": []
},
{
"title": "Установка защитных угловых профилей",
"values": []
},
{
"title": "Приготовление штукатурного раствора",
"values": []
},
{
"title": "Нанесение штукатурного раствора",
"values": []
},
{
"title": "Толщина слоя",
"values": [
"Рекомендуемая средняя толщина слоя штукатурки – 10 мм, минимальная – 5 мм. Допускается однослойное нанесение раствора слоем толщиной до 50 мм, однако при этом сроки высыхания штукатурного слоя под последующую отделку значительно увеличиваются. Для сокращения времени высыхания следует наносить раствор в два приема. Сначала наносится слой толщиной 35 мм, который, еще мягкий, нужно волнообразно «причесать» штукатурным гребнем и только после высыхания этого слоя обработать его грунтовкой Кнауф-Миттельгрунд, разведенной водой в соотношении 1:3. После высыхания грунтовки (мин. 6 часов) нанести второй штукатурный слой. Потолки штукатурить только в один слой толщиной не более 15 мм. ",
"Минимальная толщина штукатурного слоя для приклеивания керамической плитки – 10 мм."
]
},
{
"title": "Выравнивание поверхности",
"values": []
},
{
"title": "Рекомендации",
"values": []
}
],
"breadcrumbs": [
"Стройматериалы",
"Сухие строительные смеси",
"Штукатурки",
"Сухие штукатурки"
],
"description": "Сухая штукатурная смесь на основе гипса с полимерными добавками, обеспечивающими повышенную адгезию. Предназначена для высококачественного оштукатуривания внутри помещений потолков и стен с обычным твердым основанием: кладку из кирпича (керамического, силикатного, пустотелого и т.д.), бетон, гипсовые и бетонные блоки, старые цементные и гипсовые штукатурки, газобетон и пенобетон, а также на сложные основания: ЦСП, ПГП, ГКЛ (ГСП), щепоцементные плиты и блоки.Особенно рекомендуется для гладких бетонных потолочных и стеновых поверхностей. Можно использовать для отделки помещений с нормальной влажностью, а также в кухнях и ванных комнатах с последующей защитой от увлажнения.Наносится вручную. ",
"certificates": [
{
"links": [
"https://cs.p-static.ru/certificates/2926308.jpg"
],
"title": "Соответствия"
},
{
"links": [
"https://cs.p-static.ru/certificates/58982646.pdf"
],
"title": "Сертификат соответствия"
},
{
"links": [
"https://cs.p-static.ru/certificates/60914836.pdf"
],
"title": "Свид. о гос. регистрации"
},
{
"links": [
"https://cs.p-static.ru/certificates/58982359.pdf"
],
"title": "Пожарный сертификат"
}
],
"specifications": [
{
"name": "Артикул",
"value": "2862"
},
{
"name": "Тип товара",
"value": "Штукатурка"
},
{
"name": "Бренд",
"value": "Knauf"
},
{
"name": "Тип работ",
"value": "Внутренние"
},
{
"name": "Тип помещения",
"value": "Сухое"
},
{
"name": "Применение",
"value": "Для внутренних работ"
},
{
"name": "Назначение",
"value": "Для кирпича"
},
{
"name": "Толщина слоя, мм",
"value": "5-50 мм"
},
{
"name": "Расход сухой смеси",
"value": "8,5 кг/м2/10 мм"
},
{
"name": "Расход воды на упаковку сухой смеси",
"value": "18 л"
},
{
"name": "Жизнеспособность раствора, мин",
"value": "25 минут"
},
{
"name": "Время высыхания одного слоя",
"value": "7 суток"
},
{
"name": "Прочность на изгиб, МПа",
"value": "1 МПа"
},
{
"name": "Количество на поддоне",
"value": "40 шт."
},
{
"name": "Срок годности, мес",
"value": "6"
},
{
"name": "Страна-производитель",
"value": "Россия"
},
{
"name": "Вес, кг",
"value": "30"
}
]
}
}
],
"status": "OK"
}
Получение отзывов
Получение отзывов покупателей о товарах с маркетплейсов.
Постановка задачи
/api/v2/reviews/
Создает задачу на получение отзывов о товарах. Возвращает task_id для получения результатов.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
products |
array | Массив объектов с полем link. Дополнительно можно передать custom_fields |
Пример запроса
curl -X POST "https://apimarket.parserdata.ru/api/v2/reviews/" \
-H "Authorization: Token YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"products": [
{"link": "https://www.wildberries.ru/catalog/59376900/detail.aspx", "custom_fields": {"sku": "59376900"}}
]
}'
Пример ответа
{
"task_id": 15178
}
Получение результатов
/api/v2/reviews/{task_id}/
Получает результаты задачи по получению отзывов. Поддерживает пагинацию.
Параметры запроса
| Параметр | Тип | Описание |
|---|---|---|
page |
integer | Номер страницы (по умолчанию: 1) |
Пример запроса
curl -X GET "https://apimarket.parserdata.ru/api/v2/reviews/15178/?page=1" \
-H "Authorization: Token YOUR_API_KEY"
Пример ответа
{
"count": 1,
"next": null,
"previous": null,
"results": [
{
"domain": "market.yandex.ru",
"link": "https://www.wildberries.ru/catalog/59376900/detail.aspx",
"custom_fields": {
"sku": "59376900"
},
"status": "OK",
"reviews": [
{
"text": "Отпариватель прослужил почти 3 года. В целом, неплохой, удобный, лёгкий",
"rating": 3,
"username": "Ирина",
"created_at": "2025-09-23T05:19:11Z",
"updated_at": "2025-10-09T09:56:31Z"
}
]
}
],
"status": "OK"
}
Информация о балансе
Получение информации о текущем балансе и тарифном плане.
/balance/
Возвращает информацию о доступных единицах, активном тарифном плане и датах его действия.
Пример запроса
curl -X GET "https://apimarket.parserdata.ru/balance/" \
-H "Authorization: Token YOUR_API_KEY"
Пример ответа
{
"units": 10000,
"plan": "30 дней",
"plan_start_date": "2020-10-12T16:55:43Z",
"plan_end_date": "2020-11-12T16:55:45Z"
}
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
units |
integer | Доступное количество единиц для проверки товаров |
plan |
string | Название активного тарифного плана |
plan_start_date |
string | Дата начала действия тарифного плана (ISO 8601) |
plan_end_date |
string | Дата окончания действия тарифного плана (ISO 8601) |
Доступные сайты
Список поддерживаемых сайтов и доступных для них методов API.
| Сайт | Доступные методы |
|---|---|
| wildberries.ru | Поиск товаров, Получение цен, Получение характеристик, Получение отзывов |
| ozon.ru | Поиск товаров, Получение цен, Получение характеристик, Получение отзывов |
| market.yandex.ru | Поиск товаров, Получение цен, Получение характеристик, Получение отзывов |
| petrovich.ru | Поиск товаров, Получение характеристик |
| vseinstrumenti.ru | Поиск товаров, Получение цен |
| goldapple.ru | Поиск товаров, Получение цен |
| eapteka.ru | Поиск товаров, Получение цен |
Для добавления нужных методов, сайтов, а так же по проблемам обработки пишите в чат.
Коды ошибок
| Код | Описание |
|---|---|
| 200 | Успешный запрос |
| 400 | Неверные параметры запроса |
| 401 | Неверный или отсутствующий токен |
| 429 | Превышен лимит запросов |
| 500 | Внутренняя ошибка сервера |
Лимиты запросов
Лимиты зависят от вашего тарифного плана:
- Демо: 100 проверок товаров
- Стандартные тарифы: до 10 000 товаров в сутки
- Персональные тарифы: лимиты обсуждаются в индивидуальном порядке