POST /v1/tiktok/ads/get_top_ads_spotlight
Get top ads spotlight
stable · 2 credits per success
Get top ads spotlight for specific industries, showcasing the most popular ad cases；Analyze creative trends and excellent cases within the industry；Provide inspiration and reference for ad creative production；industry: Industry ID, optional, returns cross-industry list if omitted, e.g., Education: 25000000000；page: Page number, default 1；limit: Items per page, default 20；cookie: Custom Cookie str…
Request parameters
| Name | Type | In | Required | Description | Example |
|---|---|---|---|---|---|
| page | integer | body | no | 页码 | demo |
| limit | integer | body | no | 每页数量 | 20 |
| cookie | string | body | no | 自定义Cookie字符串（可选） | demo |
| industry | string | body | no | 行业ID(可选，不传返回跨行业聚合) | demo |
Response fields
Field dictionary coming soon — the executable panel shows the live shape.
Errors
| code | HTTP | Meaning | Billed |
|---|---|---|---|
| 40001 | 400 | Invalid parameters | no |
| 40102 | 401 | Invalid or revoked API Key | no |
| 40201 | 402 | Insufficient credits | no |
| 40402 | 404 | Resource not found | no |
| 42201 | 422 | Quality gate failed | no |
| 42901 | 429 | Rate limit exceeded | no |
| 50401 | 504 | Upstream timeout | no |
| 50201 | 502 | Upstream error | no |
Billing
Success costs 2 credits. Any failure — including a 200 from upstream that fails the quality gate — costs 0.