Skip to content

Aggregated event stats for a tracking tag (Meta Pixel)

Returns aggregated event counts for the pixel (GET /{pixel_id}/stats). Rows are passed through from Meta as-is — their shape depends on the aggregation requested. Meta only (platform metaads); other platforms return 405.

GET /v1/accounts/{accountId}/tracking-tags/{tagId}/stats

Returns aggregated event counts for the pixel (GET /{pixel_id}/stats). Rows are passed through from Meta as-is — their shape depends on the aggregation requested. Meta only (platform metaads); other platforms return 405.

Parameters

  • accountId (path, string) required

  • tagId (path, string) required — Pixel id.

  • aggregation (query, string) — Aggregation dimension. Defaults to event.

  • startTime (query, integer) — Unix seconds lower bound.

  • endTime (query, integer) — Unix seconds upper bound.

Responses

200 — Stats fetched

  • platform (string) (enum: metaads)
  • stats (object)

400 — Invalid query parameter.

401

403 — Ads access required (Ads add-on on legacy plans, included on usage-based plans), or the Meta token lacks ads permissions (reconnect required).

404 — Account or tracking tag not found.

405 — Platform does not support tracking-tag stats.