This article is also available in:

Competitor Price Feed Specification

The "Competitor Price Feed" exports up-to-date competitor pricing and stock availability for products matched to your catalog within Pricer24.

For general feed concepts, live generation, caching, and IP whitelisting, refer to Working with Data Feeds.

Feed Variations: Lite vs Extended

The feed is available in two variations depending on your integration depth:

Lite — Lightweight payload containing only essential fields: prices, stock availability, and competitor product URLs. Ideal for fast, regular synchronization with ERP, CRM, or 1C/BAS.
Extended — Comprehensive payload including product titles as listed on competitor websites, customer ratings, review counts, category display positions, promotional tags, and extra merchant attributes.

JSON Example (Lite)

[
  {
    "externalId": "10482",
    "offers": [
      {
        "contractor": "Amazon",
        "url": "https://www.amazon.de/dp/B09Y2MYL5C",
        "lastParsedOn": "2026-11-03 10:15:30",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 329.00, "currency": "EUR" },
          { "priceType": "price_old", "priceSet": "competitors_old", "price": 379.99, "currency": "EUR" }
        ]
      },
      {
        "contractor": "MediaMarkt",
        "url": "https://www.mediamarkt.de/de/product/_sony-wh-1000xm5-2798150.html",
        "lastParsedOn": "2026-11-03 09:40:12",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 349.99, "currency": "EUR" }
        ]
      }
    ]
  }
]

JSON Example (Extended)

[
  {
    "externalId": "10482",
    "name": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black",
    "availability": "in_stock",
    "offers": [
      {
        "contractor": "Amazon",
        "name": "Sony WH-1000XM5 Over-Ear Bluetooth Wireless Headphones with Auto NC Optimizer",
        "feedbackCount": 1840,
        "rating": 4.6,
        "position": 1,
        "promo": "Prime Deal: Extra 5% off at checkout",
        "properties": {
          "delivery": "One-Day Delivery (Prime)",
          "seller": "Amazon.de"
        },
        "imageUrl": "https://images-eu.ssl-images-amazon.com/images/I/51aXvjzpQkL._AC_SL1500_.jpg",
        "url": "https://www.amazon.de/dp/B09Y2MYL5C",
        "lastParsedOn": "2026-11-03 10:15:30",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 329.00, "currency": "EUR" },
          { "priceType": "price_old", "priceSet": "competitors_old", "price": 379.99, "currency": "EUR" }
        ]
      },
      {
        "contractor": "MediaMarkt",
        "name": "SONY WH-1000XM5 ANC Bluetooth Headphones, Black",
        "feedbackCount": 312,
        "rating": 4.7,
        "position": 3,
        "promo": null,
        "properties": {
          "delivery": "Standard 2-4 days, Store Pickup available",
          "seller": "MediaMarkt"
        },
        "imageUrl": "https://assets.mmsrg.com/isr/166325/c1/-/ASSET_MMS_94726481",
        "url": "https://www.mediamarkt.de/de/product/_sony-wh-1000xm5-2798150.html",
        "lastParsedOn": "2026-11-03 09:40:12",
        "inStock": true,
        "prices": [
          { "priceType": "price", "priceSet": "competitors", "price": 349.99, "currency": "EUR" }
        ]
      },
      {
        "contractor": "Coolblue",
        "name": "Sony WH-1000XM5 Black",
        "feedbackCount": 89,
        "rating": 4.8,
        "position": null,
        "promo": null,
        "properties": null,
        "imageUrl": "https://image.coolblue.de/products/1827412.jpg",
        "url": "https://www.coolblue.de/en/product/904576/sony-wh-1000xm5-black.html",
        "lastParsedOn": "2026-11-02 18:20:00",
        "inStock": false,
        "prices": []
      }
    ]
  }
]

Field Definitions

The root object is an array of your store's products. Each product contains an array of matched competitor offers (offers), and each offer contains an array of prices (prices).

1. Product Level

Field	Type	Lite	Extended	Description
externalId	string	Yes	Yes	Product code in your internal system (matches `id` in your catalog feed).
name	string	—	Yes	Your product title as registered in Pricer24.
availability	string	—	Yes	Your product stock status: `in_stock` or `not_in_stock`.
offers	array	Yes	Yes	List of matched competitor offers.

2. Competitor Offer Level (`offers[]`)

Field	Type	Lite	Extended	Description
contractor	string	Yes	Yes	Competitor store name (e.g., "Rozetka", "Amazon").
url	string	Yes	Yes	Direct URL to the competitor's product listing.
lastParsedOn	string	Yes	Yes	Timestamp of the last data scrape (`YYYY-MM-DD HH:MM:SS`) in your account timezone.
inStock	boolean	Yes	Yes	Availability at the competitor: `true` (in stock), `false` (out of stock).
prices	array	Yes	Yes	Array of prices. If the item is out of stock (`inStock: false`), this is an empty array `[]`.
name	string	—	Yes	Product title as displayed on the competitor's website.
imageUrl	string	—	Yes	Product image URL hosted by the competitor.
rating	number / null	—	Yes	Competitor customer rating score (e.g., `4.8`).
feedbackCount	integer / null	—	Yes	Number of customer reviews on the competitor's page.
position	integer / null	—	Yes	Search or category ranking position in the competitor store.
promo	string / null	—	Yes	Active promotional badge, gift, or bundle description.
properties	object / null	—	Yes	Additional attributes (e.g., delivery terms, installment plans).

3. Price Level (`offers[].prices[]`)

Field	Type	Description
priceSet	string	Account price group code: `competitors` (current regular price), `competitors_old` (strikethrough/original price), `competitors_promo` (promotional price).
priceType	string	Merchant internal price code (varies across different competitors).
price	number	Numeric price value.
currency	string	3-letter currency code compliant with ISO 4217 (`UAH`, `EUR`, `USD`).

When a competitor removes an item or it runs out of stock, the prices array returns empty [] because inactive or obsolete prices are discarded.

Next Steps

Learn about caching and automated download schedules in Working with Data Feeds
For on-demand querying by specific category IDs or batch pagination, see Retrieving Prices via API

Updated on: 04/11/2026

Was this article helpful?

Thank you!