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

# Tag Stats

> Get campaign statistics for a specific tag

## Endpoint

`GET https://api.apifycloud.io/api/v1/analytics/{appId}/tags/{tag}/stats`

## Authentication

Bearer token required.

Scope: `analytics:read`

## Path parameters

* `appId` (UUID, required)
* `tag` (string, required) URL-encoded tag value

## Response

```json theme={null}
{
  "data": {
    "campaign_count": 0,
    "sent": 0,
    "delivered": 0,
    "read": 0,
    "failed": 0,
    "last_used": "2024-01-01T00:00:00.000Z"
  },
  "meta": {
    "timestamp": "2024-01-01T00:00:00.000Z"
  }
}
```

## Errors

* `403 forbidden` unauthorized for app or missing scope
* `400 validation_error` invalid path parameters
* `429 rate_limit_exceeded`
* `500 server_error`

## Example

```bash theme={null}
curl "https://api.apifycloud.io/api/v1/analytics/{appId}/tags/vip/stats" \
  -H "Authorization: Bearer {access_token}"
```