To export your product catalog, internal prices, and matched competitor market data, use the GET /v1/products endpoint.

Before getting started, make sure you have reviewed authentication, pagination, and error codes in Working with the API.

Endpoint Overview

• HTTP Method: GET
• Endpoint: https://api.pricer24.com/v1/products
• Default Behavior: Returns active products only (stateId = 1)

Request Example (cURL)

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

Query Parameters

Response Structure

The response returns an array of product items inside result.items:

{
  "success": true,
  "result": {
    "totalCount": 1540,
    "items": [
      {
        "id": "018f4a3e-1234-7abc-8901-abcdef012345",
        "externalId": "10482",
        "name": "Sony WH-1000XM5 Wireless Noise Cancelling Headphones - Black",
        "vendor": "Sony",
        "vendorCode": "WH1000XM5B.CE7",
        "barcode": "4548736132580",
        "link": "https://my-store.eu/products/sony-wh-1000xm5-black",
        "stateId": 1,
        "prices": [
          {
            "price": 349.99,
            "currencyId": "EUR",
            "priceType": {
              "id": "24c7164d-050b-4891-908b-58e61fc58400",
              "name": "Retail Price"
            }
          }
        ],
        "contractorsPrices": [
          {
            "name": "Sony WH-1000XM5 Over-Ear Bluetooth Wireless Headphones with Auto NC Optimizer",
            "isAvail": true,
            "url": "https://www.amazon.de/dp/B09Y2MYL5C",
            "parsedOn": "2026-11-03T08:15:30Z",
            "contractor": {
              "id": "c71a823b-0012-4091-bb21-123456789abc",
              "name": "Amazon",
              "externalId": "CTR-AMAZON-DE"
            },
            "prices": [
              {
                "price": 329.00,
                "currency": "EUR",
                "priceType": {
                  "id": "pt-01",
                  "code": "price",
                  "name": "Online Price",
                  "priceSetId": "competitors"
                }
              }
            ],
            "avails": [
              {
                "avail": "In Stock",
                "isAvail": true,
                "warehouse": {
                  "id": "wh-01",
                  "code": "prime",
                  "name": "Prime Fulfillment Center"
                }
              }
            ]
          },
          {
            "name": "SONY WH-1000XM5 ANC Bluetooth Headphones, Black",
            "isAvail": true,
            "url": "https://www.mediamarkt.de/de/product/_sony-wh-1000xm5-2798150.html",
            "parsedOn": "2026-11-03T09:40:12Z",
            "contractor": {
              "id": "e82b934c-1123-5192-cc32-987654321def",
              "name": "MediaMarkt",
              "externalId": "CTR-MEDIAMARKT-DE"
            },
            "prices": [
              {
                "price": 349.99,
                "currency": "EUR",
                "priceType": {
                  "id": "pt-01",
                  "code": "price",
                  "name": "Retail Price",
                  "priceSetId": "competitors"
                }
              }
            ],
            "avails": [
              {
                "avail": "Available for delivery & pickup",
                "isAvail": true,
                "warehouse": null
              }
            ]
          }
        ]
      }
    ]
  },
  "error": null
}

Product Object Fields

Nested Data Models

1. Internal Prices Array: prices[]

• price — Numeric price value
• currencyId — Currency code (UAH, EUR, USD)
• priceType.id — Internal UUID of the price type in Pricer24
• priceType.name — Label of the price type (e.g., "Retail Price")

2. Competitor Prices Array: contractorsPrices[]

• name — Listing title on the competitor's website
• isAvail — Availability flag at the competitor (true / false)
• url — Direct URL to the competitor's product page
• parsedOn — Scraping timestamp in ISO 8601 UTC format
• contractor — Competitor store details:
• • id — Competitor UUID in Pricer24;
  • name — Competitor merchant name;
  • externalId — Competitor code in your system (if mapped).
• prices[] — Competitor pricing entries:
• • price — Price value;
  • currency — Currency;
  • priceType.code — Competitor's internal price type code;
  • priceType.priceSetId — Pricer24 price group (competitors, competitors_promo).
• avails[] — Warehouse-specific stock availability breakdown (if configured).

Next Steps

• Review rate limiting and authentication in Working with the API
• If you prefer downloading all competitor pricing in a single batch without pagination, use the Competitor Price Feed Specification
• To automatically receive price updates in real time, configure Webhooks: Price Updates

Updated on: 04/11/2026