Skip to main content
Docs
Feature Requests Onboarding Trust Center Status Page

Community

Enable data fetching of TikTok Spark Ads (identity-based ads) by using TikTok's Identity API to retrieve the linked post or video content

Answered
Vikas Badiger User

Which connector?: Tiktok ads

 

Additional details:

Enable data fetching of TikTok Spark Ads (identity-based ads) by using TikTok's Identity API to retrieve the linked post or video content

Please sign in to leave a comment.

Comments

2 comments

Date Votes
  • Official comment
    Lucas Alexander Fivetranner

    Hi Vikas,

    Thanks for submitting this feature request. Can you share a bit more detail about what Spark ads data you need?


    Based on what you've provided so far, I think it makes sense to add a new item_history table using the /identity/video/info/ endpoint. We'd use item_id as the primary key and include child tables for the array fields (image_info and anchor_list). I assume ad_history.tiktok_item_id would act as a foreign key to item_history.item_id.

    Does that address your use case?

    Cheers,
    Luke

  • Vikas Badiger User

    Hi Luke ,

    Thanks for the suggestion.

    My primary requirement is to obtain the actual video details associated with Spark Ads, specifically:

    • video_id
    • video_url (or the closest available video URL/reference returned by TikTok)

    Could you confirm whether the proposed item_history table sourced from /identity/video/info/ would expose these fields?

    While item_id may provide a useful join path from ad_history.tiktok_item_id, my use case requires access to the underlying video asset itself rather than just the item identifier. If the endpoint only returns item_id, that would not fully address the requirement.

    The goal is to be able to link every ad, including Spark Ads, to its corresponding video creative and retrieve the video identifier and URL for reporting and creative analysis.

    TiktTok Support suggested to use https://business-api.tiktok.com/portal/docs/get-posts-under-an-identity/v1.3 endpoint

    Thanks,

    Vikas