TikTok Product API

Open in ChatGPT Open in Claude Open in Gemini

A single TikTok Shop product: title, description, images, price and original price, rating, review and sales counts, stock, category and the seller. price is the lowest-priced variant; it is null when TikTok hides the digits from logged-out visitors. Catalogues are per market: region picks one, default US. Calls cost 1 credit each. A cache hit is free, and a failed or empty response is never charged.

Try it

Prefilled with the request that produced the example below. No key yet? Get a free key.

Request

GET/v1/tiktok/product

Parameter	Type	Required	Description
url	string	yes	Product id, or a tiktok.com/shop/pdp/… URL
region	string	no	Two-letter market code (US, GB, ID…). TikTok feeds and catalogues are per-market.

Parameter

Type

Required

Description

url

string

yes

Product id, or a tiktok.com/shop/pdp/… URL

region

string

Two-letter market code (US, GB, ID…). TikTok feeds and catalogues are per-market.

Also accepts cache_max_age (a hit costs 0 credits) and include_raw (returns the untouched upstream payload under raw).

curl

curl "$API/v1/tiktok/product?url=https%3A%2F%2Fshop.tiktok.com%2Fus%2Fpdp%2Fxtep-2000km-series-mens-pro-running-shoes-breathable-stable%2F1732423766407353143&cache_max_age=7d" \
  -H "x-api-key: $KEY"

JavaScript

const query = new URLSearchParams({
  url: 'https://shop.tiktok.com/us/pdp/xtep-2000km-series-mens-pro-running-shoes-breathable-stable/1732423766407353143',
  cache_max_age: '7d',
});

const response = await fetch(`${API}/v1/tiktok/product?${query}`, {
  headers: { 'x-api-key': KEY },
});

const body = await response.json();
if (!body.success) throw new Error(body.error.code);

// 1 credit, 0 on a cache hit
console.log(body.data, body.meta.creditsCharged);

Python

import os, httpx

r = httpx.get(
    f"{os.environ['API']}/v1/tiktok/product",
    params={
        "url": "https://shop.tiktok.com/us/pdp/xtep-2000km-series-mens-pro-running-shoes-breathable-stable/1732423766407353143",
        "cache_max_age": "7d",
    },
    headers={"x-api-key": os.environ["KEY"]},
    timeout=30,
)

body = r.json()
if not body["success"]:
    raise RuntimeError(body["error"]["code"])

print(body["data"], body["meta"]["creditsCharged"])

Example response

Captured on 2026-10-21, with raw removed and lists cut to two items. A live call returns current data.

response

{
  "success": true,
  "data": {
    "platform": "tiktok",
    "id": "1732423766407353143",
    "title": "Xtep 2000km Series Men's Pro Running Shoes | Breathable Comfort Training Sneakers for Jogging, Marathon & Road Run",
    "url": "https://shop.tiktok.com/us/pdp/1732423766407353143",
    "description": "XTEP 2000km 3.0 | The Daily Hero\nThe high-value workhorse for daily runs and heavy runners.\nMaximum Stability: Built-in Nylon Plate and a wider last design provide essential support for low arches and high insteps.\nSoft & Steady: Full-length ACE supercritical foam (45C) delivers a balanced, responsive ride.\nBreathable Build: Lightweight knit upper keeps you cool during 5K/10K daily training.\nEngineered for All: The go-to choice for wide feet and those looking for a stable, high-mileage walker or jogger.\nXTEP 2000km 5.0 | The Training Specialist (The Big Upgrade)\nThe perfect balance of softness, durability, and speed.\nNext-Gen Midsole: Upgraded to ACE 2.0 PEBA foam. It’s softer (43C) and bouncier (70% energy return) than the 3.0.\nUnbreakable Upper: The new King Abrasion Jacquard replaces standard knit. Tested for 80,000 flexes—no tearing, just relentless durability.\nPro-Level Stability: Replaces the nylon plate with an Expanded Dual-Wing TPU System on a 2mm wider platform for elite lateral support.\nLighter & Faster: Only 8.04oz (228g)—shaving weight while increasing protection.\nXTEP 2000km 5.0 Pro | The Elite Speedster\nMax Energy Return: Specialized ACE 2.0 Pro PEBA foam tuned for 75%+ rebound—our most explosive foam ever.\nFeatherlight Racing Spec: Stripped down to just 7.4oz (210g) with an ultralight, high-strength mesh upper.\nThe Pro Edge: While most carbon shoes die after 300 miles, the Pro’s Aerospace-grade CPU outsole is built to last 1,200+ miles.",
    "price": {
      "amount": 76.69,
      "currency": "USD",
      "formatted": "$76.69"
    },
    "originalPrice": {
      "amount": null,
      "currency": "USD",
      "formatted": null
    },
    "imageUrls": [
      "https://p16-oec-general-useast8.ttcdn-us.com/tos-useast8-i-rt0ujvrtvp-tx2/8c38ead8da6d45ce897e2c4ca4f0871a~tplv-fhlh96nyum-crop-webp:1254:1254.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839",
      "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/4a0d0f3f72a448b8ad23af40f0d63ab4~tplv-fhlh96nyum-crop-webp:1254:1254.webp?dr=12190&t=555f072d&ps=933b5bde&shp=8dbd94bf&shcp=607f11de&idc=useast5&from=2378011839"
    ],
    "rating": 4.7,
    "reviewCount": 26,
    "soldCount": 397,
    "inStock": true,
    "sellerId": "7496108937431518007",
    "sellerName": "XtepOfficial",
    "categoryName": null,
    "fetchedAt": "2026-10-21T02:00:20.243Z"
  },
  "meta": {
    "platform": "tiktok",
    "endpoint": "tiktok.product",
    "creditsCharged": 1,
    "cached": false,
    "cacheAgeSeconds": null,
    "durationMs": 19606,
    "requestId": "req_emg4sl7bvwg2pt2pnnoh"
  }
}

Returns

Returns an object with platform, id, title, url, description, price, originalPrice, imageUrls, rating, reviewCount, soldCount, inStock, sellerId, sellerName, categoryName, fetchedAt.

Fields

Field	Type	Present	Description
platform	"tiktok"	always
id	string	always
title	string	always
url	string \| null	always
description	string \| null	always
price	object	always
price.amount	number \| null	always	Numeric amount in major units (12.99, not 1299). Null if unparseable.
price.currency	string \| null	always	ISO-4217 where TikTok gives one. Null means we will not guess.
price.formatted	string \| null	always	Exactly what TikTok displayed, e.g. "$12.99".
originalPrice	object	always
originalPrice.amount	number \| null	always	Numeric amount in major units (12.99, not 1299). Null if unparseable.
originalPrice.currency	string \| null	always	ISO-4217 where TikTok gives one. Null means we will not guess.
originalPrice.formatted	string \| null	always	Exactly what TikTok displayed, e.g. "$12.99".
imageUrls	string[]	always
rating	number \| null	always	Star rating out of 5. Null on a product with no reviews yet.
reviewCount	number \| null	always
soldCount	number \| null	always
inStock	boolean \| null	always
sellerId	string \| null	always
sellerName	string \| null	always
categoryName	string \| null	always
fetchedAt	string	always

Field

Type

Present

Description

platform

"tiktok"

always

string

always

title

string

always

url

string | null

always

description

string | null

always

price

object

always

price.amount

number | null

always

Numeric amount in major units (12.99, not 1299). Null if unparseable.

price.currency

string | null

always

ISO-4217 where TikTok gives one. Null means we will not guess.

price.formatted

string | null

always

Exactly what TikTok displayed, e.g. "$12.99".

originalPrice

object

always

originalPrice.amount

number | null

always

Numeric amount in major units (12.99, not 1299). Null if unparseable.

originalPrice.currency

string | null

always

ISO-4217 where TikTok gives one. Null means we will not guess.

originalPrice.formatted

string | null

always

Exactly what TikTok displayed, e.g. "$12.99".

imageUrls

string[]

always

rating

number | null

always

Star rating out of 5. Null on a product with no reviews yet.

reviewCount

number | null

always

soldCount

number | null

always

inStock

boolean | null

always

sellerId

string | null

always

sellerName

string | null

always

categoryName

string | null

always

fetchedAt

string

always

Cost and behaviour

Credits

1 per live request, 0 on a cache hit

Cacheable

yes: cache_max_age accepts a cached copy

Batchable

yes: usable as a target in POST /v1/jobs/batch

Subscribable

yes: as often as every 3600 seconds, firing a webhook only on a change

Other TikTok endpoints

/v1/tiktok/ad-library/ad One TikTok ad
/v1/tiktok/ad-library/search Search the TikTok Ads Library
/v1/tiktok/collection/videos Collection videos
/v1/tiktok/comment-replies Replies to a comment
/v1/tiktok/comments Comments on a video
/v1/tiktok/creators/popular Popular creators
/v1/tiktok/followers Accounts following a creator
/v1/tiktok/following Accounts a creator follows

All TikTok endpoints The unified schema

Contents

Site

TikTok Product API

Try it

Request

Example response

Returns

Cost and behaviour

Other TikTok endpoints