Configuring TikTok Shop as a Source
In the Sources tab, click on the “Add source” button located on the top right of your screen. Then, select the TikTok Shop option from the list of connectors. Click Next and you’ll be prompted to add your access.1. Add account access
You’ll need to authorize Nekt to access your TikTok Shop data. You don’t need to register anything in the TikTok Shop Partner Center — Nekt already has an approved app there, and you simply grant it access to your shop. Click on the Authorization button. You’ll be redirected to TikTok Shop, where you need to be signed in to the Seller Center account that owns the shop you want to sync. There you’ll:- Confirm the shop the authorization applies to, choose the access duration (we recommend Unlimited, so the connection doesn’t stop working on a fixed date) and enter a contact email, then click Confirm installation.
- Review the permissions Nekt is requesting — product, order, logistics, finance, and analytics information — accept the acknowledgement and click Authorize.
- Start Date: The earliest date from which records will be synced. If not provided, all available historical data will be extracted.
- Shop cipher: The encrypted identifier of a single shop. Leave it empty to sync every shop the authorization covers — the connector resolves the shops automatically.
- Shop ID: The shop identifier reported alongside the records. Only used when a shop cipher is set manually.
- Lookback Days: (Default:
7) How many days before the last synced day the LIVE analytics streams re-read on each run, so metrics TikTok Shop restates after the fact (late payments, returns, refunds) are captured.
Don’t have access to the TikTok Shop account yourself? Use the Share link option at the top of this step to send the authorization to whoever manages the shop — they complete it without needing a Nekt account.
2. Select streams
Choose which data streams you want to sync. For faster extractions, select only the streams that are relevant to your analysis. You can select entire groups of streams or pick specific ones.Tip: The stream can be found more easily by typing its name.Select the streams and click Next.
3. Configure data streams
Customize how you want your data to appear in your catalog. Select the desired layer where the data will be placed, a folder to organize it inside the layer, a name for each table (which will effectively contain the fetched data) and the type of sync.- Layer: choose between the existing layers on your catalog. This is where you will find your new extracted tables as the extraction runs successfully.
- Folder: a folder can be created inside the selected layer to group all tables being created from this new data source.
- Table name: we suggest a name, but feel free to customize it. You have the option to add a prefix to all tables at once and make this process faster!
- Sync Type: you can choose between INCREMENTAL and FULL_TABLE.
- Incremental: every time the extraction happens, we’ll get only the new data - which is good if, for example, you want to keep every record ever fetched.
- Full table: every time the extraction happens, we’ll get the current state of the data - which is good if, for example, you don’t want to have deleted data in your catalog.
4. Configure data source
Describe your data source for easy identification within your organization, not exceeding 140 characters. To define your Trigger, consider how often you want data to be extracted from this source. This decision usually depends on how frequently you need the new table data updated (every day, once a week, or only at specific times). Optionally, you can define some additional settings:- Configure Delta Log Retention and determine for how long we should store old states of this table as it gets updated. Read more about this resource here.
- Determine when to execute an Additional Full Sync. This will complement the incremental data extractions, ensuring that your data is completely synchronized with your source every once in a while.
5. Check your new source
You can view your new source on the Sources page. If needed, manually trigger the source extraction by clicking on the arrow button. Once executed, your data will appear in your Catalog.Streams and Fields
Available streams
The table below lists every stream, its slug (the exact identifier to pass when creating the source via API) and a short description.Fields by stream
Below you’ll find all available data streams from TikTok Shop and their corresponding fields:Shops
Shops
The shops the connected authorization gives access to. Useful to map
shop_id values to shop names and regions.Orders
Orders
Orders placed in the shop, with their status timeline, buyer information, fulfillment data and full payment breakdown. Synced incrementally by
update_time.Products
Products
Products listed in the shop, with their SKUs, prices and stock. Synced incrementally by
update_time.Product Inventory
Product Inventory
Available and committed stock per SKU and warehouse. Synced incrementally by
product_update_time.Statements
Statements
Settlement statements, that is, the payouts TikTok Shop transfers to the seller. Synced incrementally by
statement_time.Statement Transactions
Statement Transactions
The individual transactions that make up each settlement statement, which is where order-level revenue, fees and shipping costs can be reconciled. Synced incrementally by
statement_time.Withdrawals
Withdrawals
Withdrawals and transfers made from the TikTok Shop balance. Synced incrementally by
create_time.Returns
Returns
Return and refund requests opened against the shop’s orders. Synced incrementally by
update_time.Cancellations
Cancellations
Order cancellation requests raised by buyers, sellers or the platform. Synced incrementally by
update_time.Packages
Packages
Packages created to fulfill the shop’s orders. Synced incrementally by
update_time.Promotion Activities
Promotion Activities
Promotion activities configured in the shop, such as flash sales and direct discounts.
Coupons
Coupons
Coupons created by the shop.
Warehouses
Warehouses
Warehouses registered by the shop for pickup and returns.
LIVE Sessions
LIVE Sessions
LIVE sessions that generated sales for the shop, with their performance metrics. Synced incrementally by
start_time (with lookback).LIVE Session Minutes
LIVE Session Minutes
Minute-by-minute breakdown of each finished session (available only for OFFICIAL and MARKETING accounts). Full table child of
live_sessions.LIVE Session Products
LIVE Session Products
Performance of each product featured in a session (available only for OFFICIAL and MARKETING accounts). Full table child of
live_sessions.LIVE Daily Performance
LIVE Daily Performance
The shop’s LIVE sales aggregated per day. Synced incrementally by
start_date (with lookback).Data Model
The following diagram illustrates the relationships between the core data streams in TikTok Shop.Implementation Notes
- LIVE analytics: The
live_*streams read the TikTok Shop Analytics API. They are date-window endpoints (start_date_ge/end_date_lt, in the shop’s timezone), so the sync range is split into 30-day windows and each partition represents a unique combination of shop, account type, and window. Withoutstart_date, the first sync covers the last 365 days. - Restated data: LIVE analytics data is published on a T-1 basis and restated as orders are paid, returned, or refunded. Incremental runs automatically re-read previous days based on the
lookback_dayssetting before the bookmark to capture these changes. - Account Types:
live_sessionsandlive_daily_performanceare requested once per account type (OFFICIAL_ACCOUNTS,MARKETING_ACCOUNTS,AFFILIATE_ACCOUNTS) and carry anaccount_typecolumn. Interaction metrics and the per-session drill-downs (live_session_minutes,live_session_products) only exist for LIVEs hosted by official and marketing accounts. - Multiple shops: A single authorization can cover more than one shop. Every record carries a
shop_idcolumn identifying which shop it came from, and theshopsstream lists the shops the authorization reaches. - Timestamps: TikTok Shop returns dates as Unix timestamps in seconds (UTC), so fields such as
create_timeandupdate_timeare integers. - Amounts: Monetary values arrive as strings in the shop’s currency, preserving the exact value returned by TikTok Shop. Ratio fields (like
click_through_rate) are kept as strings, as their format varies between endpoints. - Nested data: Fields that contain nested structures — such as the order payment breakdown or the product SKUs — are stored as JSON strings, so they stay stable as TikTok Shop adds new subfields.
- Rate limits: TikTok Shop allocates request capacity dynamically per app and shop. When the platform throttles a request, the connector waits and retries automatically, which can make an extraction take longer.
Skills for agents
Download TikTok Shop skills file
TikTok Shop connector documentation as plain markdown, for use in AI agent contexts.