TikTok Shop

Videos and LIVEs that sold one product in a window, ranked by GMV

GET/api/public/v1/tik_tok_shop/products/{productId}/contents
ConnectorAnswers empty results in the documented shape until the brand switches on this connection.

Operation id listTikTokShopProductContents

Request

curl

curl "https://creator.growthdept.ai/api/public/v1/tik_tok_shop/products/<productId>/contents?start_date=2026-11-01&end_date=2026-11-01" \
  -H "Authorization: Bearer gdc_..."

Parameters

NameInTypeNotes
productIdpathstringrequired
start_datequerystring (date)required
end_datequerystring (date)required
typequerystringOne of allvideolive Default all
limitqueryinteger Default 50
organization_idqueryinteger

Responses

200Success

FieldTypeNotes
contentsarray of object
contents[].[].commissionnumber, nullable
contents[].[].contentIdstring
contents[].[].creatorHandlestring, nullable
contents[].[].creatorOecIdstring, nullable
contents[].[].currencystring, nullable
contents[].[].daysinteger
contents[].[].firstDaystring (date)
contents[].[].gmvnumber, nullable
contents[].[].kindstringOne of videolive
contents[].[].lastDaystring (date)
contents[].[].ordersinteger, nullable
contents[].[].refundedAmountnumber, nullable
contents[].[].refundedItemsinteger, nullable
contents[].[].startedAtstring (date-time), nullable
contents[].[].titlestring, nullable
contents[].[].unitsSoldinteger, nullable
endDatestring (date)
productIdstring
shopIdstring
startDatestring (date)
totalinteger

Example

{
  "contents": [
    {
      "commission": 125.5,
      "contentId": "string",
      "creatorHandle": "string",
      "creatorOecId": "string",
      "currency": "usd",
      "days": 3,
      "firstDay": "2026-11-01",
      "gmv": 125.5,
      "kind": "video",
      "lastDay": "2026-11-01",
      "orders": 3,
      "refundedAmount": 125.5,
      "refundedItems": 3,
      "startedAt": "2026-11-01T15:04:05Z",
      "title": "string",
      "unitsSold": 3
    }
  ],
  "endDate": "2026-11-01",
  "productId": "string",
  "shopId": "string",
  "startDate": "2026-11-01",
  "total": 3
}

Errors: 400401404422429502with an error and usually a message. See errors.

Example values are made up from each field's type and name.