TikTok

Query TikTok library items

Advanced TikTok library query over ES-backed fields only. It intentionally does not use the internal Next /api/tiktok-ads route or per-request Postgres hydration.

post/v1/tiktok/library/query

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/query
  • Auth: HTTP bearer

Request body

searchstring[]
keywordMode'any' | 'all'
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[]
categoriesstring[]

TikTok content categories, case-insensitive.

hashtagsstring[]
tiktokPageIdsstring[]
tiktokPageIdstring
websiteIdstring
domainstring
handlestring
hasShopLinked'yes' | 'no'
publishedAfterstring
publishedBeforestring
updatedAfterstring
updatedBeforestring
minDaysRunningnumber
maxDaysRunningnumber
minViewsnumber
maxViewsnumber
minLikesnumber
minSharesnumber
minEngagementRatenumber
maxEngagementRatenumber
minFollowersnumber
minProfileViewsnumber
isPinnedboolean
sortBy'relevance' | 'newest' | 'updatedAt' | 'views' | 'likes' | 'comments' | 'shares' | 'saves' | 'engagementRate' | 'daysRunning' | 'followers'
order'asc' | 'desc'
pageobject
limitobject

Example request

{
  "search": [
    "protein gummies",
    "collagen"
  ],
  "languages": [
    "en",
    "fr"
  ],
  "countries": [
    "US",
    "FR"
  ],
  "categories": [
    "Beauty Care",
    "Outfit"
  ]
}

Response

Paginated TikTok library query 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.