REreacherapp
Promotion Snapshots

Seller Center promotions and vouchers, with start and end times

Changed on

Activities (product discounts, flash sales, shipping discounts, buy-more-save-more, gifts) and vouchers that are upcoming, live, or ended in the last 90 days, from the newest stored snapshot of each shop. Live first by soonest end, then upcoming, then most recently ended. Times are UTC with a *_shop_tz twin. coverage says per shop which snapshot answered and whether it is current; not_covered lists what TikTok's API cannot show (bundle deals, creator LIVE flash deals, creator-exclusive prices). With product_id or sku_id, filter_complete is false when a promotion's product list could not be read.

get/shop-promotions

Request

  • Base URL
    https://api.reacherapp.com/public/v1
  • URL
    https://api.reacherapp.com/public/v1/shop-promotions
  • Auth
    API key in header x-api-key and API key in header x-shop-id

Query parameters

statusstring[] nullable

Keep these statuses (repeatable).

tool_typestring[] nullable

Keep these promotion tools (repeatable).

ending_within_hoursinteger nullable

Upcoming or live promotions whose scheduled end is within this many hours.

ended_within_daysinteger

Ended or deactivated within this many days.

product_idstring nullable

Promotions that list this product.

sku_idstring nullable

With product_id: promotions of this SKU.

qstring nullable

Title contains, or id.

pageinteger
page_sizeinteger
snapshotstring nullable

The snapshot token from page 1, to read later pages from the same runs (valid 24 h).

Response

Successful Response

snapshotstring required

Echo as ?snapshot= on later pages to read the same runs (valid 24 h).

filter_completeboolean

False when a product_id/sku_id filter could miss a promotion whose product list is unresolved.

Changes