> ## Knowledge Base Index > Fetch the complete knowledge base index at: https://help.pricer24.com/sitemap.xml > Use this file to discover available pages before exploring further. > Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash). # 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](https://help.pricer24.com/en/article/working-with-data-feeds-got0v9/). # 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) ```json [ { "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) ```json [ { "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](https://help.pricer24.com/en/article/working-with-data-feeds-got0v9/) * For on-demand querying by specific category IDs or batch pagination, see [Retrieving Prices via API](https://help.pricer24.com/en/article/getting-product-prices-1j9mpng/)