Competitor Price Intelligence API - Price, Stock, Seller Offers

Export the competitor price intelligence your Lengow Market Intelligence account already collects: daily competitor prices, stock and promotions, marketplace seller offers, category rank and review history, as clean rows for a warehouse, a spreadsheet or a repricing rule.

What it collects

• Competitor price history: one row per competitor product per day with price, stock and promotion text, for the last 90 days by default or any date range you give. The same history is available for your own products.
• Your products with the competitor price range: price, price difference, shipping, stock and stock quantity, plus the number of matched competitor products and the lowest and highest competitor price.
• Competitor products: every competitor product matched to yours, with code, variant, price, shipping, stock, product URL, image and detection, update and last failure dates.
• Marketplace seller offers: seller id and name, offer position, price, shipping, condition, product status, active flag and buy box winner, plus the daily price history of each seller's offer.
• Category placement, review score and review count history: the rank of each product in its category and its rating and review count per day.
• Product connections and attributes: which competitor product is matched to which of yours and since when, and brand, EAN and categories on both sides.
• Stores and geo locations: your own stores, every competitor store and marketplace monitored for you, and the cities and zip codes prices are read from, with geo-located offers.
• Filters: store ids and date range sent to the provider, plus product id, country, marketplace seller and in-stock filters applied to the answer.
• Read only, pay per result, bring your own key.

Input

Field	What it does
What to read	One of 18 services. My stores (default) needs only the key.
Store ids	Optional. One request per store id, sent as the provider's stores filter.
From date / To date	Dated history services: the period, as YYYY-MM-DD.
Only these product ids	Keep records for these public or private product ids.
Only these countries	Stores and products: keep these ISO country codes.
Only these marketplace sellers	Marketplace offers: keep these seller names.
In stock only	Keep records whose stock is above zero.
Maximum results	Row cap for the run.
Requests per minute	Pacing for calls to the provider.
API key	Your own 60-character Business Intelligence API key, as a secret input.

FAQ

What is a competitor price intelligence API used for?

Moving competitor prices out of a price monitoring tool and into the systems that act on them. An ecommerce pricing team loads yesterday's competitor price history into BigQuery or Snowflake and tracks its price index per category. A brand manager checks which marketplace sellers hold the buy box on Amazon or Cdiscount and at what price. A category manager charts a product's category rank and review count against competitors over 90 days. A repricing script reads the lowest competitor price for each of the merchant's own products.

Which data source does this actor read?

The Lengow Market Intelligence API (the NetRivals and NetMonitor products) at endpoint.netrivals.com, through the eighteen read routes of its Business Intelligence API, documented publicly at endpoint.netrivals.com/docs/v1. Examples are GET /bi/v1/public/history/products-price, GET /bi/v1/public/products-marketplace-offers and GET /bi/v1/private/products. It reads the stores and products already monitored in your own account; it does not add products, start scrapes or reprice anything.

Do I need an API key?

Yes. This actor is bring-your-own-key and never ships one. The Business Intelligence API uses a 60-character API key that Lengow provides to Market Intelligence customers. Paste it into the input or set it once as the DATA_API_KEY environment secret. A missing key, a key of the wrong length and a refused key each end the run cleanly with a message saying which it was.

How do I find my store ids?

Run the My stores service first. Each row carries a privateStoreId, the domain and the country. The Monitored competitor stores service lists each competitor store's publicStoreId, domain, country and store type. Put the ids you want in the store ids input to narrow any other service; leave it empty to read every store the key can see.

What is the difference between private and public products?

Private products are your own catalogue as the provider imported it from your feed. Public products are the same items found on competitor shops and marketplaces. The Product connections service says which public product is matched to which private product, and the My products service summarises each private product's matched competitors with their count and lowest and highest price.

How far back does price history go?

Price, review score and review count history default to the last 90 days on a daily basis, and category placement history to the last 30 days, when no dates are given. Give a from and to date to read another period. The marketplace offer price history route takes no date filter.

What happens when there is nothing for a store or period?

It becomes its own row with found: false and a note: a store id the key cannot read, a period with no history, or an answer where no record passed your filters. Those rows are never charged.

Can this actor change anything in my account?

No. Every request is a GET to the Business Intelligence API. The provider's Standard API also documents a route that recalculates price suggestions and one that starts a feed import; neither is wired, and the Standard API is not called at all. The key never appears in a row or in the log.

How is it priced?

Pay per result. A product or offer row (your product, a competitor product, a marketplace seller offer or a geo-located offer) is one charge; a smaller row (one day of history, an attribute set, a connection, a store or a location) is charged at a lower rate. Rows for store ids or periods that produced nothing, and records dropped by your filters, are free. Your Lengow subscription applies separately.

Example output

{
  "service": "marketplaceOffers",
  "serviceLabel": "Marketplace seller offers",
  "recordType": "marketplaceOffer",
  "requestedStoreId": "1234",
  "found": true,
  "publicProductId": "8f14e45fceea167a5a36dedd4bea2543",
  "position": 1,
  "offerNum": 3,
  "sellerId": "A1X6FK5RDHNB96",
  "sellerName": "Example Electronics",
  "productStatus": "new",
  "condition": "new",
  "price": 249,
  "shipping": 4.99,
  "stock": null,
  "inStock": null,
  "active": "1",
  "buyBoxWinner": true,
  "url": "https://www.example-marketplace.fr/dp/B0EXAMPLE",
  "detectionDate": "2026-06-02 08:11:40",
  "updateDate": "2026-09-27 06:02:13",
  "retrievedAt": "2026-09-28T09:14:52.118Z",
  "note": null
}

Values are illustrative, and empty columns are left out here for brevity; every source field is one the provider documents.

Keyword map

competitor price intelligence API, competitor price monitoring, price history API, marketplace seller monitoring, buy box tracking, reseller price monitoring, ecommerce market intelligence, category rank tracking, review score history, price index data, repricing data feed, Lengow Market Intelligence API, NetRivals API.