API reference / TikTok Shop / Product page

Product page

The full SDUI product detail page the app renders: SKUs, prices, inventory, shipping, coupons and seller stats.

GETapi.tikultra.com/v1/shop/product-pagePremium · 25 credits

Upstream: /api/v2/shop/sdui_pdp/get/api/v1/shop/item/product_info/get
Access: Every planExclusive
Runs on: LeanPool · android · tiktok · 47.5.41
Client: os, app_flavour, app_version overrides
Billing: Failed calls are free
Older path: /v1/shop/pdp

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Query parameters

product_idstringproduct_id or url

The TikTok Shop product ID. For example 1729487391071113352.

urlstringproduct_id or url

A Shop product link.

regionstring

Two-letter country code for egress and storefront. For example US.

citystring

A city in that region. See the supported cities list. For example miami.

Client and egress

Optional. Leave them out to run as android · tiktok · 47.5.41 from the default LeanPool context. See Clients and versions.

osstring

android or ios. For example android.

app_flavourstring

Run as tiktok, lite, lite_coin, pro, studio, shop, tv, douyin. For example tiktok.

app_versionstring

A release of that app. Defaults to the current default for (os, app_flavour). For example 47.5.41.

regionstring

Two-letter country code for egress. For example US.

citystring

A supported city in that region. For example miami.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

status_codeinteger

Upstream TikTok mobile status code (0 indicates success).

product_idstring

TikTok Shop product identifier.

titlestring

Decoded title value.

regionstring

Two-letter ISO 3166-1 country code associated with the item or context.

citystring

City-level egress or location identifier.

currencystring

Decoded currency value.

statusstring

Current lifecycle or health status.

price_rangeobject

Structured price range metadata.

price_range.minstring

Decoded min value.

price_range.maxstring

Decoded max value.

price_range.originalstring

Decoded original value.

price_range.discount_pctinteger

Decoded discount pct value.

sold_countinteger

Total sold count.

ratingnumber

Decoded rating value.

review_countinteger

Total review count.

skusobject[]

Purchasable SKU variants with per-variant price, stock and sale attributes.

skus[].sku_idstring

Unique sku identifier.

skus[].pricestring

Formatted and numeric price breakdown with currency.

skus[].original_pricestring

Decoded original price value.

skus[].stockinteger

Decoded stock value.

skus[].sku_namestring

Decoded sku name value.

skus[].propsobject

Structured props metadata.

logisticsobject

Shipping origin, carrier tier, fee and estimated delivery window.

logistics.free_shippingboolean

Whether free shipping is enabled or true.

logistics.free_shipping_thresholdstring

Decoded free shipping threshold value.

logistics.shipping_feestring

Decoded shipping fee value.

logistics.eta_daysinteger[]

Decoded eta days value.

logistics.warehouse_regionstring

Decoded warehouse region value.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.

import { TikUltra } from 'tikultra' const client = new TikUltra({ apiKey: process.env.TIKULTRA_KEY }) const res = await client.shop.pdp({ product_id: '1729487391071113352' }) console.log(res.creditsCost, res.data)

{ "status_code": 0, "product_id": "1729487391071113352", "title": "Low-profile mechanical keyboard 75% CNC Aluminum", "region": "US", "city": "miami", "currency": "USD", "status": "active", "price_range": { "min": "79.99", "max": "89.99", "original": "109.00", "discount_pct": 27 }, "sold_count": 18204, "rating": 4.8, "review_count": 2941, "skus": [ { "sku_id": "1729384756192837462", "price": "79.99", "original_price": "109.00", "stock": 412, "sku_name": "Tactile Brown / Space Grey", "props": { "switch": "Tactile Brown", "color": "Space Grey" } }, { "sku_id": "1729384756192837463", "price": "89.99", "original_price": "119.00", "stock": 195, "sku_name": "Silent Linear / Anodized Silver", "props": { "switch": "Silent Linear", "color": "Silver" } } ], "logistics": { "free_shipping": true, "free_shipping_threshold": "35.00", "shipping_fee": "0.00", "eta_days": [ 3, 6 ], "warehouse_region": "California, US", "cod_supported": false, "return_policy": "Free 30-day returns" }, "promotion_vouchers": [ { "voucher_id": "vch_save10_us", "code": "SAVE10", "label": "10% off orders over $50", "discount_type": "percentage", "discount_value": 10, "min_spend": "50.00", "claimable": true }, { "voucher_id": "vch_newbuyer_5", "code": "SHOPNEW5", "label": "$5 off first TikTok Shop order", "discount_type": "fixed", "discount_value": 5, "min_spend": "25.00", "claimable": true } ], "seller": { "seller_id": "7495298225862576264", "name": "Acme Studio Shop", "shop_score": 4.8, "product_count": 28, "sold_count": 42910, "response_rate_pct": 99, "ship_on_time_pct": 98.4, "positive_review_pct": 97.2 }, "component_tree": { "protocol_version": "sdui_v2", "page_name": "pdp_main", "sections": [ { "component_id": "header_media_carousel", "type": "oec_pdp_header", "media_count": 6, "has_video": true }, { "component_id": "price_flash_banner", "type": "oec_pdp_price", "flash_sale_active": true, "ends_at": 1794455200 }, { "component_id": "sku_prop_selector", "type": "oec_pdp_sku", "prop_groups": [ "switch", "color" ], "total_skus": 2 }, { "component_id": "logistics_promise", "type": "oec_pdp_logistics", "carrier_tier": "tiktok_fulfilled_us", "guarantee_badge": "On-time delivery guarantee" }, { "component_id": "voucher_strip", "type": "oec_pdp_coupons", "voucher_count": 2 }, { "component_id": "seller_trust_card", "type": "oec_pdp_seller", "star_shop": true, "score": 4.8 }, { "component_id": "buyer_review_digest", "type": "oec_pdp_reviews", "featured_tags": [ "Great sound (418)", "Fast shipping (290)", "Solid aluminum (205)" ] } ] }, "log_pb": { "impr_id": "202611120200419F8E7D6C5B4A3210" } }