Skip to content
Managed gateway · LeanPool

Seller catalog

A seller's storefront and catalog.

GETapi.tikultra.com/v1/shop/sellerPremium · 25 credits
Upstream/api/shop/v1/homepage/get/api/shop/v1/product/list{ cursor, has_more }Every plan

Parameters

NameTypeDescription
seller_idrequiredstringThe TikTok Shop seller ID.
e.g. 7495000000000000001
regionstringTwo-letter country code for egress and storefront.
e.g. US
cursorstringThe cursor from the previous page. Omit it for the first page.
countintegerItems per page.
e.g. 20

Pricing

PlanPer callPer 1,000 calls
Starter25 credits$2.90
Growth25 credits$1.98
Scale25 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/seller \
  -H "x-api-key: $TIKULTRA_KEY" \
  --data-urlencode "seller_id=7495000000000000001"
{
  "cursor": "20",
  "has_more": true,
  "items": [
    {
      "product_id": "1729384756192837461",
      "title": "Low-profile mechanical keyboard 75%",
      "price": "79.99",
      "currency": "USD",
      "sold_count": 18204,
      "stock_status": "in_stock"
    }
  ]
}
Try it in the playgroundFull reference in the docs

More in TikTok Shop

Ready to build?

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