Ця стаття також доступна на:

Отримання цін на товари через API

Для вивантаження інформації про ваші товари, ваші власні ціни та зібрані ціни конкурентів використовується метод GET /v1/products.

Перед початком ознайомтеся із правилами авторизації, пагінації та лімітів у статті Робота з API

Загальний вигляд методу

HTTP-метод: GET
Ендпоінт: https://api.pricer24.com/v1/products
Особливість: за замовчуванням метод повертає лише активні товари (stateId = 1).

Приклад запиту (cURL)

curl -X GET "https://api.pricer24.com/v1/products?Include=Prices,ContractorsPrices&MaxResultCount=50&SkipCount=0" \
  -H "X-ApiKey: YOUR_API_KEY"

Параметри запиту

Параметр	Тип	За замовчуванням	Опис
MaxResultCount	integer	10	Кількість товарів на сторінку (від 1 до 1000).
SkipCount	integer	0	Кількість товарів, яку слід пропустити.
Include	string	null	Список пов'язаних об'єктів через кому: `Prices`, `ContractorsPrices`, `Availability`, `Category`, `Tags`.
ApiKey	string	null	API-ключ (якщо не передається у заголовку запиту).

Структура відповіді

Відповідь містить масив items із даними товарів:

{
  "success": true,
  "result": {
    "totalCount": 1540,
    "items": [
      {
        "id": "018f4a3e-1234-7abc-8901-abcdef012345",
        "externalId": "10221",
        "name": "Наповнювач Trixie Simple and Clean 8 л",
        "vendor": "Trixie",
        "vendorCode": "TX-40221",
        "barcode": "4011905402215",
        "link": "https://myshop.ua/products/trixie-8l",
        "stateId": 1,
        "prices": [
          {
            "price": 899.00,
            "currencyId": "UAH",
            "priceType": {
              "id": "24c7164d-050b-4891-908b-58e61fc58400",
              "name": "Роздрібна ціна"
            }
          }
        ],
        "contractorsPrices": [
          {
            "name": "Trixie Наповнювач силікагель 8л",
            "isAvail": true,
            "url": "https://rozetka.com.ua/item/10221/",
            "parsedOn": "2026-11-03T08:15:30Z",
            "contractor": {
              "id": "c71a823b-0012-4091-bb21-123456789abc",
              "name": "Rozetka",
              "externalId": "CTR-ROZETKA"
            },
            "prices": [
              {
                "price": 922.00,
                "currency": "UAH",
                "priceType": {
                  "id": "pt-01",
                  "code": "price",
                  "name": "Ціна на сайті",
                  "priceSetId": "competitors"
                }
              }
            ],
            "avails": [
              {
                "avail": "В наявності",
                "isAvail": true,
                "warehouse": {
                  "id": "wh-01",
                  "code": "central",
                  "name": "Центральний склад"
                }
              }
            ]
          }
        ]
      }
    ]
  },
  "error": null
}

Опис полів об'єкта товару

Поле	Тип	Опис
id	string (Guid)	Системний ідентифікатор товару в Pricer24.
externalId	string	Код товару у вашій системі обліку (значення `id` з фіду каталогу).
name	string	Назва товару.
vendor	string	Бренд / виробник.
vendorCode	string	Артикул товару.
barcode	string	Штрихкод товару.
link	string	Посилання на товар на вашому сайті.
stateId	integer	Статус товару: `1` — активний, `2` — архівний.
prices	array	Масив ваших цін (повертається, якщо вказано `Include=Prices`).
contractorsPrices	array	Масив цін контрагентів (повертається, якщо вказано `Include=ContractorsPrices`).

Вкладені масиви

1. Масив ваших цін: `prices[]`

price — значення ціни (число)
currencyId — код валюти (UAH, EUR, USD)
priceType.id — системний ID типу ціни в Pricer24
priceType.name — назва типу ціни (наприклад, «Роздрібна ціна»)

2. Масив цін контрагентів: `contractorsPrices[]`

name — назва позиції на сайті конкурента
isAvail — флаг наявності в магазині конкурента (true / false)
url — пряме посилання на сторінку товару у конкурента
parsedOn — дата і час збору даних у форматі ISO 8601 (UTC)
contractor — інформація про контрагента:
- id — код контрагента в Pricer24;
- name — назва магазину конкурента;
- externalId — код контрагента у вашій системі (за наявності).
prices[] — ціни контрагента:
- price — значення ціни;
- currency — валюта;
- priceType.code — код ціни у контрагента;
- priceType.priceSetId — системна група цін (наприклад, competitors або competitors_promo).
avails[] — наявність на окремих складах конкурента (за наявності)

Ціни контрагентів повертаються лише для товарів, зіставлених у модулі матчингу. Для товарів без зіставлень масив contractorsPrices буде порожнім.

Що далі

Ознайомтеся з обробкою помилок та лімітами у статті Робота з API
Якщо вам простіше отримувати всі ціни конкурентів одним файлом без пагінації, використовуйте Фід цін контрагентів
Якщо ви хочете автоматично оновлювати ціни у своєму магазині одразу після перерахунку, налаштуйте Вебхук: передача цін

Оновлено: 04/11/2026

Чи була ця стаття корисною?

Дякуємо!