Offers

This week's biggest price drops

Active campaign offers whose price fell against the same item (its persisted item key, which must include a pack size) in the same chain's previous catalogue — the newest campaign offer whose validity ended within the 21 days before this offer's validFrom. Only offers that started within the last 7 days count, one row per item and chain, largest absolute drop first. Campaign offers are chain-level, so lat+lng narrows to chains with an active store within radius_km. Facts only: format your own copy from previousPrice, price, dropAmount and dropPercent.

get/api/v1/public/catalog/offers/price-drops

Request

  • Base URL: https://api.shelfatlas.com
  • URL: https://api.shelfatlas.com/api/v1/public/catalog/offers/price-drops
  • Auth: HTTP bearer

Query parameters

limitinteger

How many drops to return.

chain_slugstring

Restrict to a single chain by slug.

latnumber

Latitude. Must be given together with lng.

lngnumber

Longitude. Must be given together with lat.

radius_kmnumber

Only chains with an active store within this radius of lat/lng.

Response

This week's biggest drops, largest first. An empty list is not an error.

oktrue required

Changes

No recorded changes to this operation across all 1 revision of this API.