Managed gateway · LeanPool

Promotions

Active promotions on a product.

GETapi.tikultra.com/v1/shop/promotionsPremium · 25 credits

Upstream/api/v1/shop/promotion_info/getEvery plan

Parameters

Name	Type	Description
`product_id`product_id or url	string	The TikTok Shop product ID. e.g. 1729384756192837461
`url`product_id or url	string	A Shop product link.
`region`	string	Two-letter country code for egress and storefront. e.g. US

Pricing

Plan	Per call	Per 1,000 calls
Starter	25 credits	$2.90
Growth	25 credits	$1.98
Scale	25 credits	$1.45

Responses

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining. Errors return a JSON body with a stable code and cost 0 credits. Error codes

curl -G https://api.tikultra.com/v1/shop/promotions \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "product_id=1729384756192837461"

{
  "product_id": "1729384756192837461",
  "promotions": [
    {
      "promo_id": "prm_101",
      "type": "seller_coupon",
      "label": "10% off $50+",
      "discount_pct": 10,
      "expires_at": 1764547200
    },
    {
      "promo_id": "prm_102",
      "type": "free_shipping",
      "label": "Free standard shipping",
      "min_spend": "35.00"
    }
  ]
}

Try it in the playground Full reference in the docs

More in TikTok Shop

GET/v1/shop/pdpProduct page25 cr GET/v1/shop/live-bagLIVE shopping bag25 cr GET/v1/shop/searchShop search25 cr GET/v1/shop/sellerSeller catalog25 cr GET/v1/shop/seller/categoriesSeller categories25 cr GET/v1/shop/seller/reviewsSeller reviews25 cr GET/v1/shop/showcaseCreator showcase25 cr GET/v1/shop/reviewsProduct reviews25 cr GET/v1/shop/anchorsShop anchors25 cr GET/v1/shop/mallMall home25 cr GET/v1/shop/tabShop tab25 cr GET/v1/shop/live-productsLIVE product pop-up25 cr GET/v1/shop/live-roomLIVE shop info25 cr GET/v1/shop/suggestionsShop suggestions25 cr GET/v1/shop/creatorShop creator25 cr GET/v1/shop/same-shopMore from this shop25 cr GET/v1/shop/recommendationsProduct recommendations25 cr GET/v1/shop/translationProduct translation25 cr

Ready to build?

Start with 2,500 free credits and test every public endpoint, then pick a plan.

Get an API key See pricing