Документация 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"]
  }'

Поиск товаров

Поиск товаров по названию или ссылкам на указанных маркетплейсах.

Постановка задачи

POST /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"],
  }'

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

JSON Response
{
  "task_id": 2716331
}

Получение результатов

GET /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"

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

JSON Response
{
  "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"
}

Получение цен

Получение актуальных цен товаров с маркетплейсов.

Постановка задачи

POST /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]
  }'

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

JSON Response
{
  "task_id": 893041
}

Получение результатов

GET /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"

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

JSON Response
{
  "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"
}

Получение характеристик

Получение подробных характеристик и описаний товаров.

Постановка задачи

POST /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"}}
    ]
  }'

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

JSON Response
{
  "task_id": 1322145
}

Получение результатов

GET /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"

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

JSON Response
{
  "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"
}

Получение отзывов

Получение отзывов покупателей о товарах с маркетплейсов.

Постановка задачи

POST /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"}}
    ]
  }'

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

JSON Response
{
  "task_id": 15178
}

Получение результатов

GET /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"

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

JSON Response
{
  "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"
}

Информация о балансе

Получение информации о текущем балансе и тарифном плане.

GET /balance/

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

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

curl -X GET "https://apimarket.parserdata.ru/balance/" \
  -H "Authorization: Token YOUR_API_KEY"

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

JSON Response
{
  "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 товаров в сутки
  • Персональные тарифы: лимиты обсуждаются в индивидуальном порядке