TikTok Shop · Details & Aggregates

This guide documents the JSON payloads for "detail" endpoints. Unlike the "explore" endpoints which return lists, these routes provide deep-dives into specific entities (shops, products, creators, videos).

Shop Details#

PUBLICATION /api/v1/tiktok-shop/shop-detail#

Retrieve core profile information for a shop.

Request Body:

{
  "id": "7493920192384910",
  "country": "US"
}

PUBLICATION /api/v1/tiktok-shop/shop-detail/total#

Retrieve aggregate performance metrics (revenue, sales, conversion) for a shop over a specific period.

Request Body:

{
  "id": "7493920192384910",
  "period": 30
}

PUBLICATION /api/v1/tiktok-shop/shop-detail/product/queryList#

List products sold by a specific shop with performance filtering.

Request Body:

{
  "id": "7493920192384910",
  "page": 1,
  "limit": 20,
  "period": 30,
  "sort": "revenue",
  "order": "desc"
}

Product Details#

OBTENIR /api/v1/tiktok-shop/product-detail/{id}#

Retrieve the full profile of a single product.

PUBLICATION /api/v1/tiktok-shop/product-detail/total#

Retrieve aggregate totals for a product.

Request Body:

{
  "id": "1729384756102394",
  "period": 30
}

PUBLICATION /api/v1/tiktok-shop/product-detail/history#

Retrieve historical time-series data (daily sales/revenue) for a product.

Request Body:

{
  "id": "1729384756102394",
  "period": 30
}

Creator Details#

PUBLICATION /api/v1/tiktok-shop/creator-detail/total#

Retrieve aggregate metrics for a creator.

Request Body:

{
  "id": "6892301928374615",
  "period": 30
}

PUBLICATION /api/v1/tiktok-shop/creator-detail/searchProducts#

Retrieve the list of products promoted by a creator.

Request Body:

{
  "id": "6892301928374615",
  "page": 1,
  "limit": 20,
  "period": 30
}

Video Details#

OBTENIR /api/v2/videos/{id}#

Retrieve core metadata for a TikTok video.

OBTENIR /api/v2/videos/{id}/metrics#

Retrieve performance metrics (views, likes, shares) for a video.

Query Parameters:

• période: 1 (yesterday), 7, 30 (default).

Tips for Detail Routes#

1. Prefer id over names: Detail routes always require a unique internal identifier (id). Use the découvrir routes first to find the ID if you only have a name or keyword.
2. Standard Periods: Most detail aggregates support période values of 1 (yesterday), 7, 30, et 90.
3. Consistency: All detail routes return a JSON object with a success boolean and a data object containing the results.