TikTok Shop Promotion Activities Report

Promotion type, status, dates, discounts, prices, and limits for each product in your TikTok Shop promotions.

tiktok shop reports api and data fields

4.8 Rating · 11k+ Downloads · Trusted by Sellers

Encased
Pet Lovers
Vahdam Teas
Boldify
Viva Naturals
Hyperzon
Ridgeline Insights
Lovebug Probiotics
Encased
Pet Lovers
Vahdam Teas
Boldify
Viva Naturals
Hyperzon
Ridgeline Insights
Lovebug Probiotics
Last updated -
October 27, 2026

What This Report Covers

✅ Activity ID, title, type, and status for every promotion in your TikTok Shop account

‍

✅ Product, SKU, discount percentage, and activity price for each item in a promotion

‍

✅ Begin and end times plus quantity limits, so you can check every promotion in one sheet

The TikTok Shop Promotion Activities report pulls your promotions from your TikTok Shop account. It covers activity ID, title, type, status, begin and end times, products and SKUs, discount percentage, activity price, and quantity limits. The report returns one row for each product or SKU in an activity. No date range is needed, so you always see your promotions as they are now. This report is part of our TikTok Shop Reports dataset.

Supported Fields

|Report Name|API|Field Name|Description| |---|---|---|---| |Promotion Activities|TikTok Shop Promotion Activities API|Activity ID|Unique ID of the promotion activity| |Promotion Activities|TikTok Shop Promotion Activities API|Product ID|Unique ID of the product| |Promotion Activities|TikTok Shop Promotion Activities API|SKU ID|Unique ID of the SKU (variant)| |Promotion Activities|TikTok Shop Promotion Activities API|Title|Title of the promotion activity| |Promotion Activities|TikTok Shop Promotion Activities API|Activity Type|Type of promotion, such as flash sale, direct discount, or fixed price| |Promotion Activities|TikTok Shop Promotion Activities API|Status|Status of the activity, such as ongoing, expired, or deactivated| |Promotion Activities|TikTok Shop Promotion Activities API|Product Level|Level at which the activity applies, such as a product or SKU| |Promotion Activities|TikTok Shop Promotion Activities API|Duration Type|Duration type of the activity| |Promotion Activities|TikTok Shop Promotion Activities API|Begin Time|Date and time the activity starts| |Promotion Activities|TikTok Shop Promotion Activities API|End Time|Date and time the activity ends| |Promotion Activities|TikTok Shop Promotion Activities API|Create Time|Date and time the activity was created| |Promotion Activities|TikTok Shop Promotion Activities API|Update Time|Date and time the activity was last updated| |Promotion Activities|TikTok Shop Promotion Activities API|Product Name|Name of the product| |Promotion Activities|TikTok Shop Promotion Activities API|Seller SKU|SKU code set by the seller| |Promotion Activities|TikTok Shop Promotion Activities API|Discount Percentage|Discount percentage in the activity| |Promotion Activities|TikTok Shop Promotion Activities API|Activity Price Amount|Price of the product or SKU in the activity| |Promotion Activities|TikTok Shop Promotion Activities API|Activity Price Currency|Currency of the activity price| |Promotion Activities|TikTok Shop Promotion Activities API|Quantity Limit|Quantity limit set for the activity| |Promotion Activities|TikTok Shop Promotion Activities API|Quantity Per User|Quantity limit for each buyer|

What Sellers Use This For

See every promotion in one sheet. Title, Activity Type, Status, Begin Time, and End Time show which promotions are running, scheduled, or over.

Check promotion prices by SKU. Seller SKU, Discount Percentage, Activity Price Amount, and Activity Price Currency show the price each SKU sells at during a promotion.

Catch promotions before they end. End Time and Status show which ongoing promotions end soon, so you can extend or replace them in time.

Review quantity limits. Quantity Limit and Quantity Per User show the limits on each promotion, so you can check them against your stock.

How Gorilla ROI Pulls This Data

Gorilla ROI connects to your TikTok Shop account and pulls your Promotion Activities data directly. Data updates automatically on a regular schedule. No csv exports. No manual downloads. The numbers are current the moment you open your report. Feed AI with our data to stay on top and ahead of your business.

For setup instructions, see the TikTok Shop Data Supported article in our help center.

Our TikTok Shop Reports and Fields

This data is available through our TikTok Shop Reports

| Report | What It Covers | Fields | |---|---|---| | [Orders](/tiktok-shop-reports/orders/) | Order status, payment totals, seller and platform discounts, shipping fees, taxes, fulfillment and delivery type, tracking number, and SKU details per order line item | 67 | | [Order Total](/tiktok-shop-reports/order-total/) | Order count, item count, original and sale price, seller and platform discounts, tax amount, and tax rate by date | 9 | | [Returns](/tiktok-shop-reports/returns/) | Return status, return type, refund amount, and quantity per returned line item, with return ID, order ID, seller SKU, and product name | 13 | | [Finance](/tiktok-shop-reports/finance/) | Gross and net sales, revenue, settlement amount, discounts, shipping fees and costs, referral, transaction, and FBT fees, affiliate commissions, and taxes per transaction | 67 | | [Finance Total](/tiktok-shop-reports/finance-total/) | Gross and net sales, revenue, settlement amount, discounts, shipping fees and costs, referral and transaction fees, platform commission, affiliate commissions, and taxes for your whole shop | 54 | | [Inventory](/tiktok-shop-reports/inventory/) | Available, committed, and in-shop quantities, plus campaign and creator inventory, by SKU, product, and warehouse | 11 | | [Inventory History](/tiktok-shop-reports/inventory-history/) | Available, committed, and in-shop quantities, plus campaign and creator inventory, by SKU and warehouse for the period you choose | 11 | | [Warehouses](/tiktok-shop-reports/warehouses/) | Warehouse name, type, sub type, status, default flag, full address, city, and region code for each warehouse | 10 | | [Products](/tiktok-shop-reports/products/) | Product title, status, brand, category, price, quantity, attributes, and image URLs per product and SKU | 24 | | [Product Performance](/tiktok-shop-reports/product-performance/) | GMV, items sold, and orders per product for each time window | 8 | | [SKU Performance](/tiktok-shop-reports/sku-performance/) | GMV, units sold, page views, clicks, conversion rate, and order count per SKU | 9 | | [Shop Performance](/tiktok-shop-reports/shop-performance/) | GMV, gross revenue, items sold, orders, refunds, average customers, page views, visitors, and conversion rate for your shop | 14 | | [Promotion Activities](/tiktok-shop-reports/promotion-activities/) | Activity type, status, schedule, discount percentage, activity price, and quantity limits per product or SKU in each promotion | 19 | | [Coupon](/tiktok-shop-reports/coupon/) | Promo code, status, display type, discount type and amount, minimum spend, claim and redemption windows, and usage limits per coupon | 26 |

Frequently
Asked Questions

Black upward arrow on white background

What TikTok Shop reports and fields are supported?

Gorilla ROI pulls 14 TikTok Shop reports from your TikTok Shop account: Orders, Order Total, Returns, Finance, Finance Total, Inventory, Inventory History, Warehouses, Products, Product Performance, SKU Performance, Shop Performance, Promotion Activities, and Coupon. Together they cover orders, returns, payments and settlements, fees, taxes, inventory, warehouses, product listings, sales performance, promotions, and coupons.

Black upward arrow on white background

How do I connect my TikTok Shop account to Gorilla ROI?

For step-by-step connection instructions, see the TikTok Shop Data Supported article in our help center. Once connected, Gorilla ROI pulls your TikTok Shop data automatically on a regular schedule with no csv exports or manual downloads required.

Black upward arrow on white background

Can I see TikTok Shop fees, commissions, and settlement amounts?

Yes. The Finance report shows settlement amount, referral fee, transaction fee, platform commission, affiliate commissions, FBT fulfillment fee, shipping costs, and sales tax per transaction, with order ID, seller SKU, and transaction type. Finance Total returns the same amounts for your whole shop.

Black upward arrow on white background

Can I combine my TikTok Shop data with data from my other ecommerce channels?

Yes, for any other channel Gorilla ROI supports. Gorilla ROI pulls your TikTok Shop data into Google Sheets alongside data from the supported ecommerce marketplaces, stores, and ad platforms you connect. You can compare TikTok Shop sales, fees, and inventory with your other channels in one sheet, with no csv exports or copy and paste between tools.

Black upward arrow on white background

Can I track TikTok Shop inventory over time?

Yes. The Inventory report shows available, committed, and in-shop quantities, plus campaign and creator inventory, by SKU, product, and warehouse. Inventory History returns the same fields for a period you choose, including day-by-day values. The Warehouses report adds each warehouse's name, type, status, and address.

Black upward arrow on white background

Can I track TikTok Shop promotions and coupons?

Yes. The Promotion Activities report lists each activity's type, status, begin and end time, discount percentage, activity price, and quantity limits, with one row per product or SKU in the activity. The Coupon report covers promo code, status, display type, discount type and amount, minimum spend, claim and redemption windows, and usage limits per coupon.

Black upward arrow on white background

What is the difference between the Orders and Order Total reports?

The Orders report returns one row per order line item, with order status, timestamps, payment totals, discounts, shipping fees, taxes, fulfillment details, and SKU details. The Order Total report returns totals by date: order count, item count, original and sale price, seller and platform discounts, tax amount, and tax rate. Use Orders to look into individual orders and Order Total to track sales trends over time.

Try Gorilla ROI Free For 30 Days

Replace the Manual Spreadsheet Work and Save 40 Hours a Month