Price Monitoring API - Competitor Offers, Price Recommendations

Export your price monitoring account's data as a clean dataset: every competitor offer per product and shop, every dynamic pricing recommendation, and the catalogue behind them, ready for a spreadsheet, a BI tool or a repricing script.

What it collects

• Competitor offers: the newest offer per product on each monitored domain, with shop or seller name, unit price, delivery costs, total price, rank by total and unit price, stock, delivery time, offer URL and when it was retrieved.
• Price recommendations: the newest recommended price per product in a time range, with your current price, the percentage change, your market position before and after, the price boundaries in force and the pricing strategy branch that decided it.
• Price recommendation history: every recommendation calculated for chosen products over any date range.
• Products: the contract's catalogue with GTIN, your own product ID, reference price and minimum and maximum price boundaries, optionally filtered to a list of your product IDs.
• Monitoring status: when each product was last monitored on each domain and the outcome, such as ProductFound or ProductNotAvailable.
• Monitored domains: every shop and marketplace the platform can monitor, across 50+ countries, with its offer sources.

Input

Field	What it does
What to read	One mode per run. Defaults to the domain list, which needs only credentials.
Contract ID	The contract to read. Required by every mode except the domain list.
Start date, End date, Lookback hours	Time range for offers, recommendations and history. Blank means the last 48 hours.
Product IDs	Internal product IDs for recommendation history and monitoring status.
Customer product IDs	Your own IDs, to restrict the products mode to them.
Only these domains	Keep offers from these domains only, for example amazon.de.
Skip ignored offers, Only in-stock offers	Offer filters on the API's own ignored and availability flags.
Only price changes	Keep recommendations whose price differs from your current price.
Include product tags	Return the tags imported with each product.
Maximum results	A row cap for the whole run.
API username, API password	Your own credentials, stored as secrets.

FAQ

What is a price monitoring API used for?

Pricing teams at online retailers and brands use a price monitoring API to pull competitor prices and repricing suggestions out of their pricing platform and into their own systems. Typical jobs are a nightly export of competitor offers into a data warehouse, a daily list of price recommendations that changed the price to feed a shop's repricer, a price index against Amazon, bol.com or other marketplaces, and a check of which products failed to be monitored so they can be fixed.

What data does one competitor offer row contain?

The product ID, your customer product ID, GTIN and name, the domain the offer was found on, the shop or marketplace seller name, unit price, delivery costs, total price, currency, the offer's position by total price and by unit price, availability, minimum and maximum delivery time in hours, whether the platform ignores the offer, the offer URL, and when it was retrieved and stored. Your own reference price sits alongside it for comparison.

How are dynamic pricing recommendations explained?

Each price recommendation row gives the recommended price and delivery costs, your current cheapest price and its delivery costs, the relative price change in percent, your market position now and the projected position at the new price (1 is cheapest), the minimum and maximum price boundaries at calculation time, the relevant domain, and the name and node of the strategy branch that set the price.

Which modes need a contract ID and which need product IDs?

Only the domain list needs neither. Competitor offers, price recommendations and products need the contract ID alone. Price recommendation history and monitoring status also need product IDs, which are the productId column of a products or offers run.

How long a time range can I read?

Offers and price recommendations take the range you give and return the newest record per product inside it. Recommendation history is limited by the API to 48 hours per call, so this actor walks a longer range in 48 hour windows for you.

Can this actor change anything in my pricing account?

No. Every route it calls is a read. The API also documents routes that upload or delete products, offers and orders, change contract settings, callbacks and plugin registrations, and create companies and contracts. None of them is wired. The product query is sent as a POST because the API documents it that way, but it only carries the page and the IDs to look up.

Do I need an API key?

Yes. This actor is bring-your-own-key and never ships credentials of its own. The API uses HTTP Basic authentication with your account's API username and password; enter both, paste username:password in the password field, or set the DATA_API_USERNAME and DATA_API_KEY environment secrets. A JWT bearer token pasted into the password field also works. Missing credentials end the run cleanly before any request, and refused credentials end it cleanly with the API's answer.

Does the output contain personal data?

No account or user data is read. Rows carry products, prices, shops and marketplace seller names as the monitored domains list them. The credentials never appear in a row or in the log.

What does it cost?

Pay per result. A pricing record, meaning one competitor offer, one price recommendation or one catalogue product, is one charge. Domain rows and monitoring status rows are priced lower as small reference rows. A product ID that returns nothing becomes a row marked found false and is never charged.

Example output

{
  "mode": "priceRecommendations",
  "contractId": "qbcxvb",
  "found": true,
  "retrievedAt": "2026-09-26T08:00:00.000Z",
  "recordType": "priceRecommendation",
  "productId": "PROD-001",
  "customerProductId": "CUST-PROD-001",
  "gtin": "1234567890123",
  "price": 27.99,
  "deliveryCosts": 4.99,
  "currency": "EUR",
  "oldPrice": 29.99,
  "oldDeliveryCosts": 4.99,
  "relativePriceChangePercentage": 6.67,
  "oldPosition": 5,
  "newPosition": 3,
  "minPriceBoundary": 20,
  "maxPriceBoundary": 50,
  "relevantDomain": "amazon.de",
  "strategyBranchName": "CompetitorPricing",
  "strategyLeafNodeId": 123,
  "timestamp": "2024-01-15T14:30:00Z",
  "tags": null,
  "originalTags": null,
  "note": null
}

Keyword map

price monitoring API, competitor price monitoring, dynamic pricing API, repricing API, price recommendation API, ecommerce price tracking, competitor offers export, marketplace price monitoring, Amazon price monitoring, price intelligence data, pricing strategy export, price index, retail pricing software API, price optimization data, product price history, GTIN price comparison.