Price Monitoring API - Retailer Offers, Prices and Availability

Export every retailer and marketplace offer your price monitoring account has matched to your products: one row per product per offer per data update, with the offer price, shipping, availability and URL beside your own price, ready for a warehouse, a spreadsheet or a repricing rule.

What it collects

• Retailer offers: for each data update, every offer matched to your products, with the retailer or marketplace seller, the offer name, the offer price with and without shipping, availability text and a true or false reading of it, stock, the offer URL and the source it was found on.
• Your own product data beside each offer: your product id, article name, EAN, product code, brand, producer, your price with and without shipping, catalogue, minimum and maximum price, wholesale price, VAT, currency, labels, crossed out, previous and original price and promotion description, as far as your account holds those columns.
• Computed on every offer: your price gap to the offer in percent, and whether the offer is below your minimum price (a minimum advertised price breach).
• Every column kept: all report columns, including any your account adds, are also kept under fields with their original names.
• History by update: the latest update by default, the latest few, or every update in a date range, one report per update so every row carries its update time.
• Lookups: the list of update dates, and the list of report columns your account can request.
• Filters: available offers only (sent to the provider) and retailer names (applied to the answer).
• Read only, pay per result, bring your own key.

Input

Field	What it does
What to read	Retailer offers (default, needs nothing else), update dates, or available columns.
Latest updates	Retailer offers: how many recent updates to read when no date range is given.
From date / To date	Retailer offers and update dates: a range of updates, as YYYY-MM-DD or YYYY_MM_DD_HH_MM.
Report columns	Retailer offers: the columns to read. Empty reads all.
Available offers only	Retailer offers: only currently available offers.
Only these retailers	Retailer offers: keep offers whose retailer name contains one of these.
Maximum results	Row cap for the run.
Requests per minute	Pacing for calls to the provider, at most 60.
Account ID / API key	Your own credentials, as secret inputs.

FAQ

What is a price monitoring API used for?

Getting retailer prices out of a price monitoring tool and into the systems that act on them. A brand manager loads every offer for its catalogue into BigQuery or Snowflake after each update and flags retailers selling below the minimum price. An ecommerce team compares its own price with Allegro sellers and other online shops per EAN. A category manager tracks which retailers ran out of stock on a best seller. A repricing script reads the cheapest available offer per product.

Which data source does this actor read?

The Dealavo API v3 at app.dealavo.com, through the three routes documented in its public OpenAPI file: Get update dates (GET /api/v3/updates), Get available columns (GET /api/v3/columns) and Generate a report (POST /api/v3/report, requested in its JSON format). It reads the products and retailer matches already set up in your own account; it does not add products or trigger new price checks.

Do I need an API key?

Yes. This actor is bring-your-own-key and never ships one. The provider issues an account ID and an API key with API access; paste both into the input, or set them once as the DATA_API_ACCOUNT_ID and DATA_API_KEY environment secrets. Missing or refused credentials end the run cleanly with a message saying which it was.

How far back can I read prices?

As far back as your account's update list goes. Leave the dates empty to read the latest update, raise latest updates to read several recent ones, or set a from and to date to read every update in that range. Run the update dates mode first to see what exists. Each update is read as its own report, so every row carries the time of the update it came from.

Which columns will I get?

Every column your account has, unless you name some. Run the available columns mode to see the exact names. Documented columns include Id, Article, Retailer, Retailer offer name, Retailer price, Retailer price with shipping, Availability, Source, Labels, Price, Url, Currency, Brand, EAN, Minimum Price and Maximum Price. A column name the account does not have ends the run with the provider's list of available columns.

What does the price gap mean?

It is computed here from two provider columns: your own price (Price) minus the offer's price (Retailer price), as a percentage of the offer's price. A positive number means you are more expensive than that retailer. belowMinimumPrice is true when the offer's price is under your Minimum Price column.

Can this actor change anything in my account?

No. The update and column lists are GET requests, and the report is a POST only because it takes its options as a JSON body; it reads data and changes nothing. The provider documents no write route. The credentials travel as the query parameters the provider requires and never appear in a row or in the log.

How is it priced?

Pay per result: one price per retailer offer returned, and a lower price per update date or column listed. Updates with no offers and offers left out by the retailer filter are free. Your provider subscription applies separately, and the provider allows 60 requests per minute and up to 20,000 rows per request.

Example output

{
  "mode": "offers",
  "modeLabel": "Retailer offers",
  "found": true,
  "updateTime": "2026_09_28_06_00",
  "productId": "1182986505",
  "article": "Wet dog food adult beef and lamb 400g",
  "ean": "4017721829861",
  "brand": "ExampleBrand",
  "retailer": "petshop_example (allegro.pl)",
  "retailerOfferName": "Wet dog food adult beef 400g",
  "source": "Allegro",
  "url": "https://allegro.pl/oferta/example-400g",
  "currency": "PLN",
  "price": 5.3,
  "retailerPrice": 4.99,
  "retailerPriceWithShipping": 13.98,
  "priceGapPercent": 6.21,
  "availability": "Available, in assortment",
  "available": true,
  "minimumPrice": 5.0,
  "belowMinimumPrice": true,
  "labels": ["Promo", "Core range"],
  "fields": { "Id": "1182986505", "Retailer": "petshop_example (allegro.pl)", "Retailer price": "4.99" },
  "retrievedAt": "2026-09-28T09:14:52.118Z",
  "note": null
}

Values are illustrative; every source column is one the provider documents.

Keyword map

price monitoring API, retailer price monitoring, competitor price tracking, MAP monitoring, minimum price violations, marketplace offer data, Allegro price monitoring, ecommerce price intelligence, retailer availability tracking, EAN price lookup, price history export, dynamic pricing data, Dealavo API.