TikTok Shop Coupon Report

Coupon details, discounts, minimum spend, claim and redemption dates, and usage limits for your TikTok Shop coupons.

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

✅ Coupon ID, title, promo code, status, and display type for every coupon in your TikTok Shop account

‍

✅ Discount type, amount, percentage, maximum discount, and minimum spend for each coupon

‍

✅ Claim and redemption dates plus usage limits, so you can check every coupon in one sheet

The TikTok Shop Coupon report pulls your coupons from your TikTok Shop account. It covers coupon ID, title, promo code, status, display type, product scope, buyer segment, discount, minimum spend, claim and redemption dates, and usage limits for each coupon. No date range is needed, so you always see your coupons as they are now. This report is part of our TikTok Shop Reports dataset.

Supported Fields

|Report Name|API|Field Name|Description| |---|---|---|---| |Coupon|TikTok Shop Coupon API|Coupon ID|Unique ID of the coupon| |Coupon|TikTok Shop Coupon API|Title|Title of the coupon| |Coupon|TikTok Shop Coupon API|Promo Code|Promo code of the coupon| |Coupon|TikTok Shop Coupon API|Status|Status of the coupon, such as ongoing, expired, or deactivated| |Coupon|TikTok Shop Coupon API|Display Type|Display type of the coupon, such as regular, live, or promo code| |Coupon|TikTok Shop Coupon API|Product Scope|Products the coupon applies to| |Coupon|TikTok Shop Coupon API|Target Buyer Segment|Buyer group the coupon targets| |Coupon|TikTok Shop Coupon API|Creation Source|Source from which the coupon was created| |Coupon|TikTok Shop Coupon API|Discount Type|Type of discount the coupon gives| |Coupon|TikTok Shop Coupon API|Discount Percentage|Discount percentage of the coupon| |Coupon|TikTok Shop Coupon API|Discount Amount|Discount amount of the coupon| |Coupon|TikTok Shop Coupon API|Discount Currency|Currency of the discount amount| |Coupon|TikTok Shop Coupon API|Discount Max Amount|Maximum discount the coupon can give| |Coupon|TikTok Shop Coupon API|Threshold Type|Type of threshold the buyer must meet to use the coupon| |Coupon|TikTok Shop Coupon API|Threshold Min Spend Amount|Minimum spend required to use the coupon| |Coupon|TikTok Shop Coupon API|Claim Start Time|Date and time buyers can start claiming the coupon| |Coupon|TikTok Shop Coupon API|Claim End Time|Date and time claiming ends| |Coupon|TikTok Shop Coupon API|Redemption Type|Redemption type of the coupon| |Coupon|TikTok Shop Coupon API|Redemption Start Time|Date and time the coupon can first be used| |Coupon|TikTok Shop Coupon API|Redemption End Time|Date and time the coupon can last be used| |Coupon|TikTok Shop Coupon API|Redemption Relative Days|Number of days the coupon can be used after it is claimed| |Coupon|TikTok Shop Coupon API|Usage Redemption Limit|Redemption limit of the coupon| |Coupon|TikTok Shop Coupon API|Usage Single Buyer Claim Limit|Number of times one buyer can claim the coupon| |Coupon|TikTok Shop Coupon API|Usage Total Claim Limit|Total number of times the coupon can be claimed| |Coupon|TikTok Shop Coupon API|Create Time|Date and time the coupon was created| |Coupon|TikTok Shop Coupon API|Update Time|Date and time the coupon was last updated|

What Sellers Use This For

See every coupon in one sheet. Title, Promo Code, Status, and Display Type show which coupons are live, scheduled, or over.

Check the discount on each coupon. Discount Type, Discount Amount, Discount Percentage, Discount Max Amount, and Threshold Min Spend Amount show what each coupon takes off and the spend it needs.

Catch coupons before they end. Claim End Time and Redemption End Time show when buyers can no longer claim or use a coupon, so you can replace it in time.

Review usage limits. Usage Total Claim Limit, Usage Single Buyer Claim Limit, and Usage Redemption Limit show the limits on each coupon.

How Gorilla ROI Pulls This Data

Gorilla ROI connects to your TikTok Shop account and pulls your Coupon 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