TikTok

List TikTok library items

Returns TikTok ads and organic videos from the Public API TikTok library. This namespace is separate from the Meta-only /v1/ads endpoints and is backed by the tiktoks-search Elasticsearch alias.

get/v1/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/tiktok/library
  • Auth: HTTP bearer

Query parameters

searchstring
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.

countriesstring[]
hashtagsstring[]

Hashtags with or without #, case-insensitive.

tiktokPageIdstring
domainstring
handlestring
publishedAfterstring date-time
publishedBeforestring date-time
minViewsinteger
maxViewsinteger
minEngagementRatenumber
maxEngagementRatenumber
sortBy'relevance' | 'newest' | 'updatedAt' | 'views' | 'likes' | 'comments' | 'shares' | 'saves' | 'engagementRate' | 'daysRunning' | 'followers'
order'asc' | 'desc'
pageObject
limitObject

Response

Paginated 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.