Offer Queries#

Set offers between 20 and 100 to include marketplace offers. Offer queries consume more tokens than metadata-only product queries.

product = api.query("1454857935", offers=20)[0]
offers = product.get("offers", [])

Offer History#

Each offer can contain an offerCSV history. Convert it into timestamp and price arrays with convert_offer_history.

offer = offers[0]
times, prices = keepa.convert_offer_history(offer["offerCSV"])

for timestamp, price in list(zip(times, prices))[:10]:
    print(timestamp, price)

Active Offers#

liveOffersOrder contains indices into offers for currently active offers. Not every historical offer is active, and the field can be absent.

active_offers = [
    offers[index]
    for index in product.get("liveOffersOrder", [])
    if index < len(offers)
]

for offer in active_offers:
    times, prices = keepa.convert_offer_history(offer["offerCSV"])

Offer Stock#

Set stock=True together with offers when you need current offer stock data. Keepa can only collect stock for live offers, and the backend caps reported offer stock at 10 units.

product = api.query("1454857935", offers=20, stock=True)[0]

for index in product.get("liveOffersOrder", []):
    offer = product["offers"][index]
    stock_history = offer.get("stockCSV")
    latest_stock = offer.get("stock")

Existing stockCSV history can be present even when stock=True is not set, but stock=True asks Keepa to refresh stock for the current live offers and consumes additional tokens.

Active marketplace offer histories — Active offer price histories#

Typed Offers#

With typed=True, product.offers contains Offer models and product.liveOffersOrder contains the active indices. Both are optional.

See Keepa’s product request documentation for offer-specific token costs and backend behavior.