Tiktok Shop
TikTok Shop provides an integrated commerce solution that enables sellers to connect with creators to drive meaningful shopping experiences for their customers. With Weld, you can sync your TikTok Shop data to your data warehouse, enabling you to analyze and visualize your data alongside other data sources.
Features
| Feature name | Supported | |
|---|---|---|
| Column Hashing | True | Field level |
| Blocking | True | Field level |
| Incremental | True | ORDER, PRODUCT, STATEMENT, STATEMENT_TRANSACTION |
| Custom data | False | |
| History | False | |
| ReSync | True | Table level |
| Templates | False |
π§ Setup Guide
TikTok Shop partner registration
Unfortunately, due to TikTok specific requests, you'll need to register as a partner on TikTok Shops Partner Center yourself.
You should register as a Seller Developer partner, which will allow to create custom apps, tailored to your needs. To help you get started with this process you can follow the two guides from TikTok, by clicking the titles below:
Once you done this come back and follow this guide
Whitelist Weld's IP Pool
Requests from Weld will always come from the following IP pool:
3.64.84.1393.65.119.16935.156.133.78
To ensure seamless integrations, whitelist all the IP addresses, found above, under the IP Allowlist section of your TikTok Shop app's configuration list. The whitelisting step must be done for every app
you wish to use with Weld.
The whitelisting enables Weld to use your app's app_key to make requests on your behalf. If the whitelisting step is skipped, TikTok shop will block every request it receives from Weld.
Step 1 - Configure Your TikTok Shop App
Start by making sure that you have done the prerequsite described in the two Info-boxes above.
Once you have registered as partner and created your app, the next step is to add the correct API endpoints that your app will use, to synchronize the desired data into your data warehouse.
You can do this by clicking on the "Manage API" button in the "Basic info" section of the app's settings page inside the TikTok Shop Partner Center. The list below provides a quick overview of what subset of TikTok's Open API is currently supported by Weld.
| Name | Description | Required | |
|---|---|---|---|
| Shop Authorized Information | The Partner will have access to seller's TikTok shop ID(s) | Yes (always) | |
| Product basic | The Partner will have access to product information | Yes (for product table) | |
| Order information | The Partner will have access to order information | Yes (for order table) | |
| Finance information | The Partner will have access to finance information, such as statements and statement transactions | Yes (for statement and statement_transaction tables) |
When creating an app be mindful about which categories you select for your app. Different categories expose different subsets of TikTok's Open API, which may prevent you from selecting the scops you need for your app.
When you have choosen the scopes need, then you should set the redirect url to https://api.weld.app/connections/oauth/tiktok-shop/redirect under the redirect url section of your app's configuration.
Step 2 - Approve and finalize
- Fill in the form and Authorize your app to access your shops.
- When authorization is complete, you will be redirected back to the Weld connections overview, where you should be able to select the shops you would like to syncronize.
- Now the configuration of the connector is done
Step 3 - Data to Sync
You can view the schema, remove columns, or hash sensitive information.
- Full sync - sync all data from the source to the destination.
- Incremental sync - sync only new or updated data from the source to the destination
- Select how often you would like the data to be synced.
- Provide a unique destination table name.
Weld will take over from here and commence syncing data from your TikTok Shop account.
The tables below are not available yet, as the TikTok API has not released them to the public yet. We will make them available through our connector as soon as they are released.
shop_performance
product_performance
sku_performance