Official TikTok Shop Partner · REST API v1

TikTok Shop Profit API for Accurate Financial and Net Profit Data

One REST API for TikTok Shop net profit per order, SKU and day. It covers GMV, TikTok fees, affiliate commission, COGS, refunds and ad spend, calculated the same way as your Kixmon dashboard.

7-day free trial for new accounts. Enable under Setting → REST APIs.

GET /v1/orders
curl 'https://api.kixmon.io/api/v1/orders' \
  -H "X-App-Key: $KIXMON_APP_KEY" \
  -H "X-App-Secret: $KIXMON_APP_SECRET" \
  -H "X-Shop-Id: $SHOP_ID"

{
  "grossSales": 40.00,
  "promos": -2.00,
  "tiktokFees":          { "total": -5.60 },
  "affiliateCommission": { "total": -3.80 },
  "costOfGoods": -6.80,
  "orderProfit": 21.80
}
// $40.00 gross sales → $21.80 order profit
9REST endpoints
45+TikTok fee types reconciled
15Supported markets
1App key for every shop on your account
OfficialTikTok Shop Partner
The problem

Raw TikTok data isn't profit data

TikTok's own APIs return statements, transactions and payments. To reach net profit, you join several APIs, map every fee type, and add cost of goods that TikTok never stores. The Kixmon TikTok Shop Profit API does that reconciliation before the data reaches you.

Comparison

Kixmon Profit API vs. TikTok Shop Finance API

TikTok Shop Finance API Kixmon Profit API
Access Register a Partner app, pass review, manage multiple keys One app key from your Kixmon account
Returns Raw statements, transactions, payments Calculated P&L per order, product and day
Cost of goods Not available Included from COGS stored in Kixmon
Ad spend Separate TikTok Ads API Shop and product ads, net of ads credit
Unsettled orders Separate Order API you reconcile Settled and unsettled in one endpoint
Fee logic You map and maintain every fee type 45+ fee types already reconciled
What you get

Everything in the TikTok Shop P&L, in nine endpoints

Base URL https://api.kixmon.io/api · JSON · GET

Endpoint What it returns
Get Shops Connected shops with region, seller type, timezone and shop id
Get Products Products and SKUs with price, COGS and shipping cost
Get Orders Paid orders with GMV, promos, shipping, itemized TikTok fees, affiliate commission and COGS
Get Orders by Product The same P&L split per product and SKU
Get Refunds Daily refund cost with a seven-field breakdown
Get Non-Order Adjustments Settlement credits and deductions not tied to an order
Get Expenses General expenses and creator retainers
Get Shop Ads Daily shop ad spend, ads credit and net cost
Get Product Ads Daily ad cost per promoted product

Each endpoint name links to its page in the documentation. Supported markets are the US, UK, Ireland, Germany, France, Italy, Spain, Japan, Brazil, Mexico, Singapore, Malaysia, the Philippines, Thailand and Vietnam.

United StatesUnited KingdomIrelandGermanyFranceItalySpainJapanBrazilMexicoSingaporeMalaysiaPhilippinesThailandVietnam
Net profit formula

Net profit, calculated the same way as your dashboard

Net profit = Gross sales−Promos−TikTok fees−Affiliate commission−Shipping−COGS−Refunds−Ad cost±Adjustments−Expenses

Use orderType=SETTLED for figures that match TikTok payouts, or UNSETTLED for orders still in the return window. Unsettled figures are estimates until TikTok settles the order.

Use cases

Put profit data where your team already works

Google Sheets

A daily P&L with one row per day.

SKU dashboards

Profit after ads per product and SKU.

Payout reconciliation

Settled orders plus non-order adjustments.

Agency reporting

One report across all client shops, using one key.

Creator cost analysis

Affiliate commission plus creator retainers.

Data warehouse sync

Your own ETL job at 100 results per page.

It works with n8n, Make and Zapier through any HTTP GET request with custom headers.

Get started

Send your first request in minutes

01

Enable

Go to Setting → REST APIs and click Enable REST APIs.

02

Copy your secret

Store it server-side. It isn't shown again.

03

Call Get Shops

Copy your shop id.

04

Fetch orders

Send the id as X-Shop-Id to Get Orders.

text
curl 'https://api.kixmon.io/api/v1/shops' \
  -H "X-App-Key: $KIXMON_APP_KEY" \
  -H "X-App-Secret: $KIXMON_APP_SECRET"

Prefer no code? The API Testing Tool sends live requests from your browser and shows the matching cURL command. A Postman collection is also available.

Developer details

Built for simple integration

No OAuth and no token refresh. Test live requests in your browser with the API Testing Tool, or import the Postman collection.

Open testing tool
  • Auth: App key and secret as headers. No OAuth and no token refresh.
  • Format: JSON over GET requests.
  • Pagination: limit up to 100, with date ranges up to 366 days.
  • Rate limits: 60 requests per minute per app key and 120 per IP.
  • Errors: Standard codes including 429 with a Retry-After header.
  • Plan access: REST APIs must be included in your plan, otherwise requests return 403 FEATURE_UNAVAILABLE.
FAQs

Got a question? Get your answer

Does it include COGS and ad spend?

Yes. COGS comes from Get Products and Get Orders, and ad cost from Get Shop Ads and Get Product Ads.

Can one key access multiple shops?

Yes. Call Get Shops, then pass each shop id as X-Shop-Id.

Can I get unsettled orders?

Yes, with orderType=UNSETTLED. Figures are estimates until settlement.

Does it work with Sheets, n8n, Make or Zapier?

Yes, through any tool that can send HTTP GET requests with custom headers.

How is it different from TikTok's Finance API?

TikTok returns raw records. Kixmon returns calculated profit, including COGS.

How do I get credentials?

Open Setting → REST APIs and click Enable REST APIs.

Get TikTok Shop net profit data through one API

Stop stitching TikTok APIs and fee tables together. Enable REST APIs and pull reconciled profit data into your own tools.

7-day free trial for new accounts.

Tiktok Shop Partner

Kixmon makes it so easy to know your numbers. See all hidden costs, track every penny, and avoid profit headaches—it’s all at your fingertips.

Get in Touch

©Kixmon LLC. All Rights Reserved.
Certified TikTok Shop Partner