# Per-creative performance inside TikTok Smart+ ads

Returns the per-creative performance inside TikTok Smart+ ads, one page at a time. Works with TikTok Ads.

```http
GET https://api.pozy.ai/v1/ads/tiktok-smart-plus-materials
```

- Area: Ads / Ad Insights
- Auth: Authorization: Bearer pz_live_...

## Query parameters

- `accountId` (string, required)
- `adAccountId` (string, required)
- `startDate` (string (date), required)
- `endDate` (string (date), required)
- `level` (string): one of ad, adGroup
- `smartPlusAdIds` (string)
- `adGroupIds` (string)
- `page` (integer)
- `pageSize` (integer)

## Example request

```bash
curl -X GET "https://api.pozy.ai/v1/ads/tiktok-smart-plus-materials?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f&startDate=2026-10-01&endDate=2026-10-01" \
  -H "Authorization: Bearer $POZY_API_KEY"
```

```ts
const res = await fetch("https://api.pozy.ai/v1/ads/tiktok-smart-plus-materials?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f&startDate=2026-10-01&endDate=2026-10-01", {
  headers: { Authorization: `Bearer ${process.env.POZY_API_KEY}` },
});
const data = await res.json();
if (!res.ok) throw new Error(data?.error ?? `Request failed with status ${res.status}`);
console.log(data);
```

```python
import os
import requests

resp = requests.get(
    "https://api.pozy.ai/v1/ads/tiktok-smart-plus-materials",
    headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
    params={
        "accountId": "696e0b682d0a31188e7a2ba9",
        "adAccountId": "666219aad7bab67ace411e4f",
        "startDate": "2026-10-01",
        "endDate": "2026-10-01",
    },
    timeout=30,
)
resp.raise_for_status()
print(resp.json())
```

## Response 200

- `adAccountId`, string
- `level`, string: One of `ad`, `adGroup`
- `startDate`, string
- `endDate`, string
- `page`, integer
- `pageSize`, integer
- `totalRows`, integer
- `totalPages`, integer
- `missingRows`, integer
- `rows`, array of object
  - `materialId`, string
  - `materialType`, string: Can be null
  - `tiktokItemId`, string: Can be null
  - `name`, string: Can be null
  - `smartPlusAdId`, string: Can be null
  - `adGroupId`, string: Can be null
  - `metrics`, object
    - `spend`, number: Can be null
    - `impressions`, number: Can be null
    - `clicks`, number: Can be null
    - `cpc`, number: Can be null
    - `addToCart`, number: Can be null
    - `initiateCheckout`, number: Can be null
    - `addPaymentInfo`, number: Can be null
    - `purchases`, number: Can be null
    - `purchaseValue`, number: Can be null
    - `roas`, number: Can be null

```json
{
  "adAccountId": "666219aad7bab67ace411e4f",
  "level": "ad",
  "startDate": "string",
  "endDate": "string",
  "page": 1,
  "pageSize": 1,
  "totalRows": 42,
  "totalPages": 42,
  "missingRows": 1,
  "rows": [
    {
      "materialId": "651e8a21ab6f7db5c340a60e",
      "materialType": "string",
      "tiktokItemId": "6194c6395799073f3c47a197",
      "name": "Acme",
      "smartPlusAdId": "6e8904b1093cf559921b85fe",
      "adGroupId": "6ad180be375f36f2c328e52b",
      "metrics": {
        "spend": 12.5,
        "impressions": 12.5,
        "clicks": 12.5,
        "cpc": 12.5,
        "addToCart": 12.5,
        "initiateCheckout": 12.5,
        "addPaymentInfo": 12.5,
        "purchases": 12.5,
        "purchaseValue": 12.5,
        "roas": 12.5
      }
    }
  ]
}
```