> ## 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.