> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Pixel Stats

> Get TikTok pixel event counts by browser/server source for tracking diagnostics

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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.