Product object

5 endpoints on 2 platforms return the Product object with the same 13 fields, so code written for one platform reads the others unchanged. A call costs $0.0020 to $0.0200. It is a preview structure and may still change.

Preview object · Updated 2026-10-17Open in ChatGPTOpen in Claude

A Product is something for sale in a platform's shop: its title, its price and original_price in a currency, its pictures, the buyers' rating out of 5 and the units sold. It comes from TikTok Shop in the United States and from the shop of Xiaohongshu (RedNote), in yuan.

shop.id and shop.name say who sells it, and on TikTok Shop the seller's ID lists the rest of what it has on sale. Its id goes unchanged to the product detail and to its reviews, which come back as Review.

Fields

A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.

id text

ID; pass it unchanged to the endpoints that get the product and list its reviews

url link

Link that opens the product

title text

Title of the product

description text standard

The text of the product's description

price amount

Current price; the lowest one when its variants are priced differently

original_price amount standard

The price before the discount; null when there is none

currency text

Currency of the prices, an ISO 4217 code

images list of link standard

Addresses of the product's pictures

rating number

Buyers' rating, out of 5

metrics object

Product counts

metrics.sold integer

Units sold

metrics.reviews integer

Reviews

shop object

The shop that sells it

shop.id text

Shop ID

shop.name text

Name of the shop

Where each number comes from

The same field name does not always mean the same act on every platform. This table says which of the platform's own numbers goes into the field.

FieldWhat it holds thereOn
titleThe title as the result card words it, which may differ from the title on the product's pageXiaohongshu (RedNote)
imagesThe one picture of the result card; the product itself has all of themXiaohongshu (RedNote)
metrics.soldUnits sold as the product's page shows themXiaohongshu (RedNote)
Units sold as the result card shows themXiaohongshu (RedNote)

What a platform cannot give

A platform stands against a field when none of its endpoints gives it.

FieldNot available on
urlXiaohongshu (RedNote)
One endpoint may still leave out a field another gives: each endpoint's page lists what it cannot give, and every answer says so in meta.unavailable.

Endpoints that return Product

The number beside each platform is how many of its endpoints return it.

EndpointPathPrice
TikTok Shop product detailGET/v1/tiktok/shop/products/get$0.0020
TikTok Shop product searchGET/v1/tiktok/shop/products/search$0.0020
TikTok Shop seller productsGET/v1/tiktok/shop/sellers/products/list$0.0020
Xiaohongshu product detailGET/v1/xiaohongshu/shop/products/get$0.0200
Xiaohongshu product searchGET/v1/xiaohongshu/shop/products/search$0.0200

Example

One item from tiktok.shop.products.get, as recorded 2026-10-12 21:46 UTC. Names, text, IDs and links are examples; the figures are as recorded.

Product · tiktok.shop.products.get
{
  "id": "1716954397711561377",
  "url": "https://shop.tiktok.com/view/product/1716954397711561377",
  "title": "I tried weekend hiking for 30 days. Here is what happened",
  "description": "My honest take on weekend hiking, a month in.",
  "images": [
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/c864758cf8a90105a3d1~c5_720x720.jpeg",
    "https://p16-sign-va.tiktokcdn.com/tos-maliva-p-0068/2061b170200b03e40ffe~c5_720x720.jpeg",
    // … 1 more
  ],
  "rating": 4.1,
  "metrics": { "sold": 233, "reviews": 18 },
  "shop": { "id": "1748001744684903334", "name": "Lumen Outdoor Store" }
}

The whole response is on the endpoint's page →

Related

Other objects