tiktok_account_summary
ChatGPTOne shop's account-level sales and profit figures for a date window, as a single flat object (GMV, orders, units, fees, cost of goods, margins, ad spend and more). Dates are inclusive UTC calendar days, not the shop's local days; with no dates it covers the 30 complete UTC days ending yesterday (UTC), an endDate later than yesterday (UTC) is refused, and the answer's requested block states the dates and currency used. Currency defaults to the shop's own. Cost lines are negative and adsSpend is positive; ads-dependent fields are null when the ads data is unavailable, for example when the Business API is not connected, and ppcClicks and ppcImpressions, which count GMV Max campaigns, are also null (with a note in notes) when GMV Max spend (ppcSpend) is reported but they are not. When nothing was sold in the window the answer says noResults. Filtering by brand, spu or sku sets the statement adjustments (counted inside tiktokFees; detail: true lists them) to 0. By default the answer carries the headline fields only: sales (gmv, sales, orders, units, customers, aov, grossRevenue, netRevenueChain), refunds (refunds, refundCount, refundPct), revenue and costs (totalNetRevenue, cogs, tiktokFees, shippingCost, marketing, affiliateCommission, samplesCost), margins (cm1, cm2 and cm3 with their Pct, roc2, roc3), advertising (adsSpend, ppcSpend, ppcSpendAuction, ppcClicks, ppcImpressions, tacos) and cost-of-goods coverage (skusInScope, skusMissingCogs: above 0, that many SKUs have no cost set, so cogs and the margins understate cost). tiktokFees already includes shippingCost (it is totalFees + shippingCost + adjustmentFees + mcfFeeAmount + otherFulfillmentAmount), so shippingCost is shown separately and is not an extra deduction from cm2 or cm3. A headline field Titan Tools did not send is absent, and one it sent as null stays null (no data, not zero). detail: true returns every field Titan Tools reports (over 100, large).
tiktok_brands
ChatGPTList a shop's brands, ordered by name, each with its status (Active or Inactive) and the number of SKUs carrying it, with optional name search and paging. Inactive brands are hidden from every other shop tool, so this is where they show. Brand names from here are what tiktok_products and the summary tools filter by.
tiktok_inventory_breakdown
ChatGPTExplain one catalogue row's stock figure: one row per warehouse holding units for the key, with available and committed units, most available first. Set level to the grain of the key: a brand name, a TikTok product id (spu), or a TikTok variant id (skuId from tiktok_products, not the seller SKU label).
tiktok_lessons
ChatGPTSearch Titan's TikTok Shop training lessons: the TikTok Profit System course (validate, onboard, create, optimize, accelerate, shop management) and the cross-platform Brand Workbook. Returns the best-matching lesson passages with title, space, a date where the title carries one, and a url only when a link to the lesson is on record.
tiktok_list_shops
ChatGPTList the TikTok Shops the member's linked Titan Tools account can reach, grouped by organization, with each shop's name, shopId, country, currency, the timezone Titan Tools reports for it (informational only: the summary tools do not use it) and whether its Shop API and Business (ads) API are connected. The shopId values here are what the other shop tools take; a member who reaches one shop needs none.
tiktok_product_summary
ChatGPTSales and profit per brand, product (spu) or seller SKU for a date window, one page at a time, sorted by a chosen column (default gmv, highest first). Dates, currency, sign conventions and null ads fields work as in tiktok_account_summary; ads-dependent fields are also null at SKU grain. As in tiktok_account_summary, tiktokFees already includes shippingCost (with totalFees, mcfFeeAmount and otherFulfillmentAmount; statement adjustments are account grain only), so shippingCost is shown separately and is not an extra deduction from cm2 or cm3. To drill down, filter by the row's key at the next grain: brands with groupBy spu, spus with groupBy sku. Rows can overlap, so they need not add up to the account total. The default page is 10 rows. By default each row carries identity (rowType, key, brand, spu, sku, title, variantCount, productCount; there is no variant id here, so take a skuId from tiktok_products) and headline figures (gmv, units, orders, customers, aov, grossRevenue, netRevenueChain, refunds, refundPct, totalNetRevenue, cogs, tiktokFees, shippingCost, marketing, affiliateCommission, cm1, cm2 and cm3 with their Pct, adsSpend, ppcSpend, tacos); detail: true returns every field Titan Tools reports for each row (over 100 per row, large).
tiktok_products
ChatGPTBrowse or search a shop's catalogue one page at a time, at brand, product (spu) or SKU grain. Rows carry title, status, stock, price, cost of goods and grossProfit (an amount per unit in the row currency, price minus cost of goods, not a percentage) where a row is one variant, and ranges (priceMin, priceMax, grossProfitMin, grossProfitMax and so on) where it folds several. Filter by brands, spus, skus (seller SKU labels) or skuIds (TikTok variant ids); filter values are exact and case-sensitive, so copy them from tiktok_brands or this tool's rows, and use search for a case-insensitive part of a title, seller SKU label or SPU id. To drill down, filter by the row's brand or spu at the next grain, for example groupBy sku with spus. Variants of disabled brands are not returned. To keep answers small, rows omit imageUrl and every field that is null (for a single variant, the range fields such as priceMin and priceMax), so an omitted field means no value: a single variant carries price, cogs and grossProfit, a group of several carries their Min and Max ranges instead. cogs 0 with an empty cogsCurrencyCode means the seller never entered a cost for that variant, so its grossProfit overstates profit. detail: true returns each row exactly as Titan Tools sent it. The default page is 50 rows.
tiktok_shop_settings
ChatGPTOne shop's VAT and seller fulfilment fee settings: the two settings that change what the sales and profit summary figures mean. Sales VAT (salesVatActive, salesVatStartDate, salesVatDefaultRatePercent) and fees VAT (feesVatActive, feesVatStartDate, feesVatRatePercent) are applied when a summary is read, so a change shows on the next summary call; a null start date means none was ever set, and VAT is then off whatever the switch says. countryStandardVatRatePercent is the statutory standard rate of the shop's country, shown as a pre-fill hint only: it is not used in any figure, which follow salesVatDefaultRatePercent and any per-variant rates. sellerFulfillmentFeePeriods is the schedule of the flat fee charged per package shipped for seller-fulfilled orders, oldest period first, each with effectiveFrom (null means since the start of the shop history), feePerPackage and currency; an empty list means the fee is off. The fee reaches the summary figures only once a recalculation has run. salesVatStartDate, feesVatStartDate and each period's effectiveFrom are YYYY-MM-DD calendar days in the shop's reporting timezone, not UTC days like the summary tools, so a start date can sit a day away from a UTC summary window. Fields are returned exactly as Titan Tools sends them.