跳转到主要内容
GET
Review status of every TikTok Smart+ ad of an advertiser

请求规范

  • 方法与路径: GET /apis/v1/ads/tiktok-smart-plus-reviews
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/ads/tiktok-smart-plus-reviews
  • connectionId: query; 必填
  • adAccountId: query; 必填
  • includeDeleted: query; 可选
  • maxAgeSeconds: query; 可选
  • page: query; 可选
  • pageSize: query; 可选
  • Runtime 事实版本: fe60122939c67dc98a3a6ac6b97bd5c326b526105150c8959304dd2160d4dd09
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

当前未提供请求参考价格;请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

connectionId
string
必填

The ads connection (adc_...) the request runs on: one of yours, from GET /apis/v1/ads/connections. On a request with a JSON body it may be sent as a top-level body member instead.

Pattern: ^adc_[0-9A-Za-z]+$
adAccountId
string
必填

TikTok advertiser ID

includeDeleted
boolean
默认值:false

Also return Smart+ ads deleted on TikTok (listed with primary_status: STATUS_ALL).

maxAgeSeconds
integer
默认值:3600

Freshness window in seconds. Reviews, refusals and the listing read within it are served without calling TikTok; older ones are still returned but read again, oldest first.

必填范围: 600 <= x <= 86400
page
integer
默认值:1
必填范围: x >= 1
pageSize
integer
默认值:500
必填范围: 1 <= x <= 1000

响应

The reviews of one page of the advertiser's Smart+ ads. Check incomplete: when true, some Smart+ ads of the page were never read. allFresh says whether every review is within maxAgeSeconds.

adAccountId
string
allFresh
boolean

True when every item and refusal of this page was read within maxAgeSeconds and nothing is pending.

counts
object

The Smart+ ads on this page split by state; the four counts add up to the Smart+ ads on this page (fewer than pageSize on the last page).

failedSmartPlusAds
object[]

Smart+ ads of this page whose review TikTok refused on its own (e.g. an ad deleted on TikTok since the listing was read). Empty when none.

includeDeleted
boolean
incomplete
boolean

True while some Smart+ ads of this page were never read (counts.pending > 0). Stale items alone keep it false.

items
object[]
listing
object

The Smart+ ad listing this page was cut from.

maxAgeSeconds
integer

The freshness window this page was read with.

oldestReadAt
string<date-time> | null

The oldest readAt in items. Null when items is empty.

page
integer
pageSize
integer
pendingSmartPlusAdIds
string[]

Smart+ ads of this page never read. Empty when every ad has a stored review or refusal.

refreshState
enum<string>

Whether this request could refresh the due (stale or pending) Smart+ ads of the page. Carries retryAfterSeconds.

可用选项:
ok,
paused,
refused,
error
retryAfterSeconds
integer | null

Set exactly when refreshState is paused or refused, including stale items with nothing pending. Always equals the Retry-After header, which is sent exactly when this is not null. Client rule:

reviewError
object | null

Set when TikTok refused both halves of a review batch the same way (for example a permission error) and the page was served from stored reviews instead of being refreshed. Null otherwise.

totalPages
integer
totalSmartPlusAds
integer

Smart+ ads of the advertiser across all pages.