Get TikTok Marketing ad-performance report

GET

https://numueg.app/api/v1/stores/{store_id}/settings/tracking/tiktok/report

Last modified:2026-09-19 16:39:33

x-numu-scope:settings:read

Aggregated advertiser-level spend/impressions/conversions for the panel.

Returns connected=false when the store has no advertiser_id on file
(or no token) — the merchant only gets this after the OAuth flow, since a
hand-pasted Events API token lacks reporting scope. Reporting failures
(e.g. missing scope) come back as connected=true with an error
string rather than misleading zeros.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Query Params

Responses

🟢200

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://numueg.app/api/v1/stores//settings/tracking/tiktok/report?days=' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "success": true,
    "data": {
        "connected": true,
        "advertiser_id": "string",
        "start_date": "string",
        "end_date": "string",
        "spend": 0,
        "impressions": 0,
        "clicks": 0,
        "conversions": 0,
        "cost_per_conversion": 0,
        "ctr": 0,
        "error": "string"
    },
    "message": "string"
}

Modified at 2026-09-19 16:39:33

Get TikTok tracking status

Connect TikTok Shop (persist token + shop)