Ads · Ad Campaigns
Returns the review status of each creative in a TikTok Smart+ ad. Works with TikTok Ads.
https://api.pozy.ai/v1/ads/{adId}/tiktok-smart-plus-reviewGuide: TikTok Ads
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
Path parameters
| Name | Type | Notes |
|---|---|---|
adIdrequired | string |
Example
curl -X GET "https://api.pozy.ai/v1/ads/6f40fa2fb0a7e728dd1a73b7/tiktok-smart-plus-review" \
-H "Authorization: Bearer $POZY_API_KEY"const res = await fetch("https://api.pozy.ai/v1/ads/6f40fa2fb0a7e728dd1a73b7/tiktok-smart-plus-review", {
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/6f40fa2fb0a7e728dd1a73b7/tiktok-smart-plus-review",
headers={"Authorization": f"Bearer {os.environ['POZY_API_KEY']}"},
timeout=30,
)
resp.raise_for_status()
print(resp.json())Response
200 on success
adIdstringplatformstringOne of
tiktok.platformAdIdstringsmartPlusAdIdstringreviewobjectCan be null.
7 child fields
reviewStatusstringOne of
approved,partially_approved,rejected,unknown.rawReviewStatusstringCan be null.
rejectReasonsarray of stringpassedLocationsarray of stringappealStatusstringCan be null.
appealRejectReasonsarray of stringrejectionsarray of object6 child fields
reasonsarray of stringsuggestionstringCan be null.
forbiddenPlacementsarray of stringforbiddenAgesarray of stringforbiddenLocationsarray of stringcontentobjectCan be null.
5 child fields
typestringCan be null.
textstringCan be null.
imageIdstringCan be null.
videoIdstringCan be null.
musicIdstringCan be null.
materialsarray of object11 child fields
adMaterialIdstringmaterialTypestringOne of
spark_post,video,carousel,catalog_carousel. Can be null.tiktokItemIdstringCan be null.
videoIdstringCan be null.
namestringCan be null.
operationStatusstringCan be null.
reviewStatusstringOne of
approved,partially_approved,rejected,unknown.rawReviewStatusstringCan be null.
rejectReasonsarray of stringpassedLocationsarray of stringrejectionsarray of object6 child fields
reasonsarray of stringsuggestionstringCan be null.
forbiddenPlacementsarray of stringforbiddenAgesarray of stringforbiddenLocationsarray of stringcontentobjectCan be null.
5 child fields
typestringCan be null.
textstringCan be null.
imageIdstringCan be null.
videoIdstringCan be null.
musicIdstringCan be null.
readAtstring (date-time)
{
"adId": "6f40fa2fb0a7e728dd1a73b7",
"platform": "tiktok",
"platformAdId": "64149c3e561c1c5ac800f87a",
"smartPlusAdId": "6e8904b1093cf559921b85fe",
"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"
}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. |
| 404 | not_found | Nothing with that id exists in your workspace. |
| 429 | rate_limit_error | Too many requests this minute. Wait for Retry-After seconds. |
Every code is listed in Errors.