Offers

List offers

Filter by a single product, a batch of products, a brand, or a chain. product_id / product_ids / brand_slug / chain_slug cannot be combined.

get/api/v1/public/catalog/offers

Request

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

Query parameters

product_idstring uuid

Offers matched to a single product.

product_idsstring

Comma-separated list of UUIDs (1–100). Offers matched to a batch of products.

brand_slugstring

Every current offer matched to a product of this brand — the one-call form of product_ids.

chain_slugstring

Restrict to a single chain by slug.

ingested_sincestring date-time

Only offers ingested at or after this timestamp (filters on ingestedAt). Accepts a bare date (2026-08-21) or a full ISO 8601 datetime. Built for incremental sync: poll with the newest ingestedAt you have already stored instead of re-fetching the whole catalog on every call. Composes with every other filter and with cursor pagination. A product link made later (productId appearing on an offer you already hold) does not change ingestedAt, so the offer is not returned again: re-fetch with product_id for the products you follow, or do a full chain_slug sync once a week.

cursorstring nullable

Opaque pagination cursor returned in a previous response.

limitinteger

Page size (1–200, default 50).

Response

A page of offers.

oktrue required

Changes

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