TikTok Discovery: Setup guide

TikTok Discovery: Setup guide#

This guide explains how to collect data from TikTok Discovery.

Introduction#

TikTok Discovery provides trending content data from TikTok, including popular hashtags, trending videos, and trending search keywords. It enables marketing and brand activation teams to understand what content and topics are trending on TikTok across industries and regions.

Prerequisites#

Before you start collecting data from TikTok Discovery, perform all of the following actions:

  • Ensure you have a TikTok Ads account with at least one active advertiser.

Creating a datastream to collect data from TikTok Discovery#

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from TikTok Discovery.

Authorization: Allow Adverity to access TikTok Discovery#

TikTok Discovery uses the same authorization flow as TikTok Ads. To set up a new authorization to fetch data from TikTok Discovery, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access TikTok Discovery using your credentials.

  2. Click Next.

  3. Follow the TikTok sign-in flow to grant Adverity access to your TikTok Ads account.

  4. Click Authorize.

As a result, Adverity has access to TikTok Discovery using the credentials you provided.

Configuration: Choose the data you want to collect from TikTok Discovery#

To choose what data to collect and customize the TikTok Discovery datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Advertisers, select the advertiser account to use for authentication.

    Note

    TikTok Discovery data is not specific to any advertiser. Results are the same regardless of which advertiser you select.

  3. In Report type, select the type of data to collect:

    • Popular hashtags (default) — the most popular hashtags on TikTok for the selected country and category

    • Popular hashtag details — detailed trending history for a specific hashtag

    • Trending videos for hashtags — trending videos associated with specific hashtags

  4. In Country, select one or more countries for which to collect data.

  5. In Categories, select one or more industry categories to filter hashtag results.

    Note

    Categories applies to the Popular hashtags and Popular hashtag details report types only.

  6. In Date range, select the timeframe in which the items have been popular.

    Note

    Date range is required for Popular hashtag details and Trending videos for hashtags.

  7. In Hashtags, select the specific hashtags for which to collect data.

    Note

    Hashtags is required for the Trending videos for hashtags report type, and applies to Popular hashtag details as well. Available hashtags are filtered based on the selected country.

  8. (Optional) Select Flatten trending history to expand trending history data into separate rows. If not selected, trending history is returned as nested JSON.

As a result, Adverity fetches data from TikTok Discovery according to the configuration you set.

What’s next?#

Contents