Skip to main content
TikTok Shop is TikTok’s e-commerce marketplace, where sellers list products and fulfill orders placed through in-feed videos, LIVE sessions, the product showcase and the Shop tab. The TikTok Shop Partner Open API gives access to a seller’s shop data, including orders, product catalog, stock, settlement statements, returns, packages, promotions, and LIVE analytics.

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:
  1. 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.
  2. Review the permissions Nekt is requesting — product, order, logistics, finance, and analytics information — accept the acknowledgement and click Authorize.
You’ll be redirected back to Nekt with the connection filled in automatically. If you ever need to reconnect the shop, use the Refresh button next to the field. The following configurations are also available:
  • Start Date: The earliest date from which records will be synced. If not provided, all available historical data will be extracted.
The following advanced settings are also available:
  • 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.
Once you’re done, click Next.

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.
Once you are done configuring, click Next.

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.
Once you are ready, click Next to finalize the setup.

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.
For you to be able to see it on your Catalog, you need at least one successful source run.

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:
The shops the connected authorization gives access to. Useful to map shop_id values to shop names and regions.
Orders placed in the shop, with their status timeline, buyer information, fulfillment data and full payment breakdown. Synced incrementally by update_time.
Products listed in the shop, with their SKUs, prices and stock. Synced incrementally by update_time.
Available and committed stock per SKU and warehouse. Synced incrementally by product_update_time.
Settlement statements, that is, the payouts TikTok Shop transfers to the seller. Synced incrementally by statement_time.
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 and transfers made from the TikTok Shop balance. Synced incrementally by create_time.
Return and refund requests opened against the shop’s orders. Synced incrementally by update_time.
Order cancellation requests raised by buyers, sellers or the platform. Synced incrementally by update_time.
Packages created to fulfill the shop’s orders. Synced incrementally by update_time.
Promotion activities configured in the shop, such as flash sales and direct discounts.
Coupons created by the shop.
Warehouses registered by the shop for pickup and returns.
LIVE sessions that generated sales for the shop, with their performance metrics. Synced incrementally by start_time (with lookback).
Minute-by-minute breakdown of each finished session (available only for OFFICIAL and MARKETING accounts). Full table child of live_sessions.
Performance of each product featured in a session (available only for OFFICIAL and MARKETING accounts). Full table child of live_sessions.
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. Without start_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_days setting before the bookmark to capture these changes.
  • Account Types: live_sessions and live_daily_performance are requested once per account type (OFFICIAL_ACCOUNTS, MARKETING_ACCOUNTS, AFFILIATE_ACCOUNTS) and carry an account_type column. 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_id column identifying which shop it came from, and the shops stream lists the shops the authorization reaches.
  • Timestamps: TikTok Shop returns dates as Unix timestamps in seconds (UTC), so fields such as create_time and update_time are 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.