Ads · Ad Campaigns

Review status of every TikTok Smart+ ad of an advertiser

Returns the review status of every TikTok Smart+ ad of an advertiser, one page at a time. Works with TikTok Ads.

GEThttps://api.pozy.ai/v1/ads/tiktok-smart-plus-reviews

TikToklistTikTokSmartPlusReviews

Request

Send your API key as Authorization: Bearer pz_live_.... Read-only keys can call it. Keys with the ads resource group disabled get 403 resource_group_disabled. Authentication

Query parameters

Name	Type	Notes
`accountId`required	string
`adAccountId`required	string
`includeDeleted`	boolean	Default `false`
`maxAgeSeconds`	integer	Default `3600`600 to 86400
`page`	integer	Default `1`At least 1
`pageSize`	integer	Default `500`1 to 1000

Example

curl -X GET "https://api.pozy.ai/v1/ads/tiktok-smart-plus-reviews?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f" \
  -H "Authorization: Bearer $POZY_API_KEY"

const res = await fetch("https://api.pozy.ai/v1/ads/tiktok-smart-plus-reviews?accountId=696e0b682d0a31188e7a2ba9&adAccountId=666219aad7bab67ace411e4f", {
  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);

import os
import requests

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

Response

200 on success

adAccountIdstring
includeDeletedboolean
maxAgeSecondsinteger
pageinteger
pageSizeinteger
totalPagesinteger
totalSmartPlusAdsinteger
listingobject
- readAtstring (date-time)
- sourcestring
  One of fresh, fallback.
- errorobject
  Can be null.
  2 child fields
  - tiktokCodeinteger
    Can be null.
  - messagestring
reviewErrorobject
Can be null.
- tiktokCodeinteger
  Can be null.
- messagestring
countsobject
- freshinteger
- staleinteger
- pendinginteger
- failedinteger
oldestReadAtstring (date-time)
Can be null.
itemsarray of object
- smartPlusAdIdstring
- adGroupIdstring
  Can be null.
- campaignIdstring
  Can be null.
- reviewobject
  Can be null.
  7 child fields
  - reviewStatusstring
    One of approved, partially_approved, rejected, unknown.
  - rawReviewStatusstring
    Can be null.
  - rejectReasonsarray of string
  - passedLocationsarray of string
  - appealStatusstring
    Can be null.
  - appealRejectReasonsarray of string
  - rejectionsarray of object
    6 child fields
    reasonsarray of string
    suggestionstring
    Can be null.
    forbiddenPlacementsarray of string
    forbiddenAgesarray of string
    forbiddenLocationsarray of string
    contentobject
    Can be null.
    5 child fields
    typestring
    Can be null.
    textstring
    Can be null.
    imageIdstring
    Can be null.
    videoIdstring
    Can be null.
    musicIdstring
    Can be null.
- materialsarray of object
  11 child fields
  - adMaterialIdstring
  - materialTypestring
    One of spark_post, video, carousel, catalog_carousel. Can be null.
  - tiktokItemIdstring
    Can be null.
  - videoIdstring
    Can be null.
  - namestring
    Can be null.
  - operationStatusstring
    Can be null.
  - reviewStatusstring
    One of approved, partially_approved, rejected, unknown.
  - rawReviewStatusstring
    Can be null.
  - rejectReasonsarray of string
  - passedLocationsarray of string
  - rejectionsarray of object
    6 child fields
    reasonsarray of string
    suggestionstring
    Can be null.
    forbiddenPlacementsarray of string
    forbiddenAgesarray of string
    forbiddenLocationsarray of string
    contentobject
    Can be null.
    5 child fields
    typestring
    Can be null.
    textstring
    Can be null.
    imageIdstring
    Can be null.
    videoIdstring
    Can be null.
    musicIdstring
    Can be null.
- readAtstring (date-time)
failedSmartPlusAdsarray of object
- smartPlusAdIdstring
- adGroupIdstring
  Can be null.
- campaignIdstring
  Can be null.
- errorobject
  2 child fields
  - tiktokCodeinteger
    Can be null.
  - messagestring
- refusedAtstring (date-time)
  Can be null.
incompleteboolean
allFreshboolean
pendingSmartPlusAdIdsarray of string
retryAfterSecondsinteger
Can be null.
refreshStatestring
One of ok, paused, refused, error.

200 response

{
  "adAccountId": "666219aad7bab67ace411e4f",
  "includeDeleted": true,
  "maxAgeSeconds": 1,
  "page": 1,
  "pageSize": 1,
  "totalPages": 42,
  "totalSmartPlusAds": 42,
  "listing": {
    "readAt": "2026-10-02T09:00:00.000Z",
    "source": "fresh",
    "error": {
      "tiktokCode": 1,
      "message": "Hello from Pozy"
    }
  },
  "reviewError": {
    "tiktokCode": 1,
    "message": "Hello from Pozy"
  },
  "counts": {
    "fresh": 1,
    "stale": 1,
    "pending": 1,
    "failed": 1
  },
  "oldestReadAt": "2026-10-02T09:00:00.000Z",
  "items": [
    {
      "smartPlusAdId": "6e8904b1093cf559921b85fe",
      "adGroupId": "6ad180be375f36f2c328e52b",
      "campaignId": "65a3737dd8b11ea61f199e6e",
      "review": {
        "reviewStatus": "approved",
        "rawReviewStatus": "active",
        "rejectReasons": [
          "string"
        ],
        "passedLocations": [
          "string"
        ],
        "appealStatus": "active",
        "appealRejectReasons": [
          "string"
        ],
        "rejections": [
          {
            "reasons": [
              "string"
            ],
            "suggestion": "string",
            "forbiddenPlacements": [
              "string"
            ],
            "forbiddenAges": [
              "string"
            ],
            "forbiddenLocations": [
              "string"
            ],
            "content": {
              "type": "string",
              "text": "Hello from Pozy",
              "imageId": "6d4f8076f189e3caf170dc65",
              "videoId": "65fd297a0da74ab358dd11e9",
              "musicId": "6f984cc4c4966c468da0cfd5"
            }
          }
        ]
      },
      "materials": [
        {
          "adMaterialId": "6dbb84467421295a1ae43473",
          "materialType": "spark_post",
          "tiktokItemId": "6194c6395799073f3c47a197",
          "videoId": "65fd297a0da74ab358dd11e9",
          "name": "Acme",
          "operationStatus": "active",
          "reviewStatus": "approved",
          "rawReviewStatus": "active",
          "rejectReasons": [
            "string"
          ],
          "passedLocations": [
            "string"
          ],
          "rejections": [
            {
              "reasons": [
                "string"
              ],
              "suggestion": "string",
              "forbiddenPlacements": [
                "string"
              ],
              "forbiddenAges": [
                "string"
              ],
              "forbiddenLocations": [
                "string"
              ],
              "content": {
                "type": "string",
                "text": "Hello from Pozy",
                "imageId": "6d4f8076f189e3caf170dc65",
                "videoId": "65fd297a0da74ab358dd11e9",
                "musicId": "6f984cc4c4966c468da0cfd5"
              }
            }
          ]
        }
      ],
      "readAt": "2026-10-02T09:00:00.000Z"
    }
  ],
  "failedSmartPlusAds": [
    {
      "smartPlusAdId": "6e8904b1093cf559921b85fe",
      "adGroupId": "6ad180be375f36f2c328e52b",
      "campaignId": "65a3737dd8b11ea61f199e6e",
      "error": {
        "tiktokCode": 1,
        "message": "Hello from Pozy"
      },
      "refusedAt": "2026-10-02T09:00:00.000Z"
    }
  ],
  "incomplete": true,
  "allFresh": true,
  "pendingSmartPlusAdIds": [
    "string"
  ],
  "retryAfterSeconds": 1,
  "refreshState": "ok"
}

Errors

Errors use one shape: { error, type, code, param?, details? }. The ones you are most likely to see here:

400	invalid_request_error	A parameter or body field is missing or invalid. `param` names it.
401	authentication_error	The API key is missing, revoked or expired.
403	permission_error	The key is scoped to other profiles or has this resource group disabled.
429	rate_limit_error	Too many requests this minute. Wait for `Retry-After` seconds.

Every code is listed in Errors.

More in Ad Campaigns

GETList ads GETList Google Ads recommendations POSTApply Google Ads recommendations POSTDismiss Google Ads recommendations GETList portfolio bid strategies POSTCreate portfolio bid strategy PATCHUpdate portfolio bid strategy GETList shared budgets POSTCreate a shared budget GETList Search keywords POSTAdd Search ad-group keywords PATCHPause or enable a Search keyword DELRemove a Search keyword GETList campaigns POSTCreate a standalone campaign PUTPause or resume a campaign GETRead a campaign's ad schedule (dayparting)PUTReplace a campaign's ad schedule (dayparting)GETRead a campaign's current bidding GETGet live campaign details PUTUpdate a campaign DELDelete a campaign GETList campaign-level negative keywords PUTReplace campaign-level negative keywords POSTPause or resume many campaigns POSTDuplicate a campaign GETRead a Google campaign's device, location, excluded location, and language targeting PUTEdit a Google campaign's device, location, excluded location, or language targeting GETList ad sets POSTCreate a standalone ad group POSTDuplicate an ad set POSTDuplicate an ad GETGet live ad-set details PUTUpdate an ad set DELDelete an ad set GETRead a Reddit ad group's targeting and schedule PUTPause or resume a single ad set GETGet campaign tree GETGet daily account metrics GETGet ad details PUTUpdate ad DELCancel an ad PUTPause or resume a single ad GETList campaign assets POSTAttach campaign assets PUTUpdate campaign assets DELRemove campaign assets GETList ad-group assets POSTAttach ad-group assets PUTUpdate ad-group assets DELRemove ad-group assets GETRead the platform's review verdict for an ad GETReview status of each creative in a TikTok Smart+ ad GETList ads that need attention POSTDismiss an ads alert GETList campaign negative lists PUTReplace campaign negative lists POSTBoost post as ad GETList Performance Max asset groups POSTCreate a Performance Max asset group GETGet a Performance Max asset group PATCHUpdate a Performance Max asset group DELRemove a Performance Max asset group POSTLink or unlink asset group assets PUTReplace an asset group's listing-group tree POSTCreate standalone ad GETGet campaign conversion goals PATCHUpdate campaign conversion goals