TikTok

List TikTok library items for a shop

Returns TikTok library items linked to one public shop id using exact ES shop identifiers. This route has a TikTok endpoint key and ads entitlement even though it is nested under /v1/shops.

get/v1/shops/{shopId}/tiktok/library

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/shops/{shopId}/tiktok/library
  • Auth: HTTP bearer

Path parameters

shopIdstring required
Example:3f8aa146-6f96-46e8-9781-64db5166f9a8

Stable public shop identifier.

Query parameters

searchstring
Example:protein gummies
searchArea'all' | 'caption' | 'profile' | 'hashtag' | 'music'
type'all' | 'ad' | 'organic'
status'all' | 'active' | 'inactive'
mediaTypesstring[]
languagesstring[]

ISO 639-1 codes (en, fr) or English language names (English, french), case-insensitive.

[
  "en",
  "fr"
]
countriesstring[] 
[
  "US",
  "FR"
]
hashtagsstring[]

Hashtags with or without #, case-insensitive.

[
  "beauty",
  "makeup"
]
tiktokPageIdstring
Example:1234567890123456789
domainstring
Example:example.com
handlestring
Example:examplebrand
publishedAfterstring
Example:2026-01-01
publishedBeforestring
Example:2026-06-05
minViewsnumber
Example:10000
maxViewsnumber
Example:1000000
minEngagementRatenumber
Example:5
maxEngagementRatenumber
Example:100
sortBy'relevance' | 'newest' | 'updatedAt' | 'views' | 'likes' | 'comments' | 'shares' | 'saves' | 'engagementRate' | 'daysRunning' | 'followers'
order'asc' | 'desc'
pageObject
limitObject

Response

Paginated shop-scoped TikTok library response. One returned TikTok item is one billable ads credit.

requestIdstring required

Example response

{
  "requestId": "req_123",
  "data": [
    {
      "id": "tiktok_7078586231734521093",
      "type": "ad",
      "status": "active",
      "media": {
        "type": "video",
        "medias": [
          {
            "type": "video"
          }
        ]
      }
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 25,
    "total": 250,
    "totalPages": 10
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.