1. Авторизация по ключу

Для передачи ключа, в запросе необходимо использовать HTTP заголовок с параметром Authorization. Authorization: Token xxxxxxxxxxxxxxxxxxxx

2. HTTP методы

POST - для создания таска GET - для получения информации

3. Создание таска

POST запрос по URL: https://apimarket.parserdata.ru/task/text-search/ В теле запроса необходимо передать город мониторинга и список названий товаров: 1. Город передается параметром region_ids (список городов), можно передать как один, так и несколько городов. 2. Названия товаров передаются параметром product_name в массиве site_products.

Пример передачи товаров 1 Тело запроса с названиями товаров, город мониторинга Москва: { "region_ids":[213], "site_products":[ {"product_name":"KN-980013"}, {"product_name":"KN-982501SL"}, {"product_name":"KN-9855SB"} ] }

Пример передачи товаров 2 Тело запроса с названиями товаров, город мониторинга Москва и Санкт-Петербург. Важно, в ссылке должен присутствовать параметр product и offers: { "region_ids":[213, 2], "site_products":[ {"product_name":"KN-980013"}, {"product_name":"KN-982501SL"}, {"product_name":"KN-9855SB"} ] }

Пример передачи товаров 3 Для дополнительной идентификации переданных товаров, возможно передать внутренний код или любые другие дополнительные данные вместе с товаром в параметре custom_field_1 (доступно до 5 custom_field по каждому товару). { "region_ids":[213, 2], "site_products":[ {"product_name":"KN-980013", "custom_field_1": "000001"}, {"product_name":"KN-982501SL", "custom_field_1": "000002", "custom_field_2": "акционный товар"}, {"product_name":"KN-9855SB"} ] }

Пример ответа на успешный запрос созданного таска: { "task_id": 123 } где 123, номер созданного таска

4. Проверка статуса таска

GET запрос по URL: https://apimarket.parserdata.ru/task/TASK_ID/text-search/?page=1 где TASK_ID, номер созданного таска Пример ответа, во время парсинга: { "count": 0, "next": null, "previous": null, "results": [ ], "status": "PARSING" }

Возможные статусы: SAVE_PRODUCTS – подготовка IN_PROGRESS – отправка PARSING – парсинг DONE – завершено

5. Получение результатов по таску

Проверку статуса у таска, рекомендуем проводить с задержкой в 1 секунду. При смене статуса на DONE, в теле ответа выводятся результаты, где: count – количество переданных названий товаров next – следующая страница с результатами (на одной странице 25 товаров) previous – предыдущая страница с результатами (если значение на странице null, вы находитесь на последней странице) results – массив с полученными данными status – статус задания

Пример ответа с данными после парсинга. Пример сокращен по количеству офферов для визуального удобства. В реальном ответе будут все офферы полученные на первой странице по каждому товару. По умолчанию предложения магазинов отсортированы от мин до макс по параметру price_min. Если необходимо отобразить предложения магазинов в порядке по популярности (сортировка маркета), необходимо добавить параметр ?sort=2 https://apimarket.parserdata.ru/task/TASK_ID/text-search/?sort=2&page=1 { "count": 50, "next": "https://apimarket.parserdata.ru/task/TASK_ID/text-search/?page=2", "previous": null, "results": [{ "site_product_name": "KN-980013", "site_product_url": "https://market.yandex.ru/search?text=KN-980013&cvredirect=1&lr=213&onstock=1&local-offers-first=1", "region_id": 213, "region_name": "Москва", "custom_fields": { "custom_field_1": "000001", "custom_field_2": null, "custom_field_3": null, "custom_field_4": null, "custom_field_5": null }, "offers": [{ "price": 1747.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 1747.0, "promo": null, "shop_name": "Yoza", "shop_id": 378143, "delivery_cost": 350.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2097.0, "offer_name": "Ключ рожковый KNIPEX KN-980013 (13 мм) 130 мм", "model_id": null, "url": "", "warranty": false, "on_stock": false }, { "price": 2297.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 2297.0, "promo": null, "shop_name": "ВДЛ-Электро", "shop_id": 170175, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2597.0, "offer_name": "Ключ гаечный рожковый 13мм Knipex диэлектрический VDE 1000V (KN-980013)", "model_id": null, "url": "", "warranty": false, "on_stock": false }, { "price": 2297.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 2297.0, "promo": null, "shop_name": "Магазин Knipex", "shop_id": 402494, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2597.0, "offer_name": "Ключ гаечный рожковый KNIPEX KN-980013", "model_id": null, "url": "", "warranty": true, "on_stock": true } ] }, { "site_product_name": "KN-982501SL", "site_product_url": "https://market.yandex.ru/search?text=KN-982501SL&cvredirect=1&lr=213&onstock=1&local-offers-first=1", "region_id": 213, "region_name": "Москва", "custom_fields": { "custom_field_1": "000002", "custom_field_2": "акционный товар", "custom_field_3": null, "custom_field_4": null, "custom_field_5": null }, "offers": [{ "price": 998.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 998.0, "promo": null, "shop_name": "ОНЛАЙН ТРЕЙД.РУ", "shop_id": 255, "delivery_cost": 0.0, "delivery_region": "Доставка из Москвы", "is_priority_region": false, "price_with_delivery_cost": 998.0, "offer_name": "Отвертка диэлектрическая KNIPEX 982501SL", "model_id": null, "url": "", "warranty": true, "on_stock": true }, { "price": 998.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 998.0, "promo": null, "shop_name": "Магазин Knipex", "shop_id": 402494, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 1298.0, "offer_name": "Отвертка для винтов с крестообразным шлицем Pozidriv® KNIPEX 982501SL", "model_id": null, "url": "", "warranty": true, "on_stock": true }, { "price": 998.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 998.0, "promo": null, "shop_name": "KNIPEX в России", "shop_id": 607135, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 1298.0, "offer_name": "Отвертка для винтов с крестообразным шлицем 982501SL", "model_id": null, "url": "", "warranty": true, "on_stock": false } ] }, { "site_product_name": "KN-9855SB", "site_product_url": "https://market.yandex.ru/search?text=KN-9855SB&cvredirect=1&lr=213&onstock=1&local-offers-first=1", "region_id": 213, "region_name": "Москва", "custom_fields": null, "offers": [{ "price": 1325.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 1325.0, "promo": null, "shop_name": "ВсеИнструменты.ру", "shop_id": 4106, "delivery_cost": 190.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 1515.0, "offer_name": "Кабельный нож Knipex KN-9855SB", "model_id": null, "url": "", "warranty": false, "on_stock": true }, { "price": 1844.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 1844.0, "promo": null, "shop_name": "TZE1.RU", "shop_id": 584493, "delivery_cost": 350.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2194.0, "offer_name": "Стриппер для коаксиала Knipex, 125 мм {KN-9855SB}", "model_id": null, "url": "", "warranty": false, "on_stock": false }, { "price": 1862.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 1862.0, "promo": null, "shop_name": "KNIPEX в России", "shop_id": 607135, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2162.0, "offer_name": "Резак для кабеля KNIPEX 98 52 KN-9855SB", "model_id": null, "url": "", "warranty": true, "on_stock": false }, { "price": 1862.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 1862.0, "promo": null, "shop_name": "ВсеИнструменты.ру", "shop_id": 4106, "delivery_cost": 190.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2052.0, "offer_name": "Кабельный нож Knipex KN-9855SB", "model_id": null, "url": "", "warranty": false, "on_stock": true }, { "price": 2065.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 2065.0, "promo": null, "shop_name": "KNIPEX в России", "shop_id": 607135, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2365.0, "offer_name": "Нож для снятия изоляции KNIPEX 98 53 13 KN-9855", "model_id": null, "url": "", "warranty": true, "on_stock": false }, { "price": 2397.0, "price_discount": null, "price_promo": null, "price_card": null, "price_min": 2397.0, "promo": null, "shop_name": "KNIPEX в России", "shop_id": 607135, "delivery_cost": 300.0, "delivery_region": "Доставка из Москвы", "is_priority_region": true, "price_with_delivery_cost": 2697.0, "offer_name": "Стриппер для снятия изоляции с коаксиальных кабелей KNIPEX 16 60 05 SB KN-166005SB", "model_id": null, "url": "", "warranty": true, "on_stock": false } ] } ], "status": "DONE" }