Get Pixel Stats

Get TikTok pixel event counts by browser/server source for tracking diagnostics. Requires Pixel Management > Pixel Level Reporting permission. Returns UTC aggregates, not individual lead receipts or Test Events logs; empty statistics do not prove tracking failed.


App	TikTok Ads
Operation ID	`tiktok_ads_get_pixel_stats`
Type	Action
Connection	`tiktok_ads` (required)
Credits per run	1
Agent / MCP tool	Yes

Inputs

Field	Type	Required	Default	Description
`account`	DynamicAccount	Yes	-	TikTok advertiser account with access to the selected pixels.
`pixel_ids`	string or array of string	Yes	-	One or more pixel_id values from tiktok_ads_list_pixels, not pixel_code. Accepts an ID, a list, a JSON array string, or comma-separated IDs. Markifact batches requests for more than 10 pixels.
`date_range`	PixelStatsDateRange	Yes	-	Date range for received-event statistics, interpreted in UTC. Use start/end or a standard preset. Longer ranges are split into non-overlapping windows of up to 30 days, returned separately. Counts are aggregates, not individual event receipts, exact arrival timestamps, or unique leads; empty statistics do not prove tracking failed.

PixelStatsDateRange

Field	Type	Required	Default	Description
`start`	string	No	-	Inclusive start date, YYYY-MM-DD. Required without a preset.
`end`	string	No	-	Inclusive end date, YYYY-MM-DD. Required without a preset.
`preset`	string	No	-	Optional standard date preset such as TODAY, YESTERDAY, LAST_7_DAYS, or LAST_30_DAYS. Presets override start/end; FIXED or CUSTOM uses the supplied dates. LAST_7_DAYS excludes today; use LAST_7_DAYS_INCL_TODAY to include it.

Output

Type: List[Dict] One row per pixel and date window, with start_date/end_date (inclusive UTC dates), pixel_id, and TikTok’s native statistics array. Statistics include pixel_event_type or custom_event_type, total_count, browser_event_total_count, server_event_total_count, attributed_count, and preview_count. An empty statistics array is preserved. Ranges longer than 30 days produce separate non-overlapping windows; counts are not automatically summed or deduplicated.

Get Started

Guides

Operations

Inputs

PixelStatsDateRange

Output

​Inputs

​PixelStatsDateRange

​Output

Inputs

PixelStatsDateRange

Output