# TikTok Creative Center top ads spotlight

Get top ads spotlight for specific industries, showcasing the most popular ad cases. Takes industry, page and limit, all optional. Served by TikHub.

Purpose:
- 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

Parameters:
- 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 string, optional parameter, can be used to fetch more data

Note:
- If you've applied one or more filters and there's no result returned, try adjusting or removing some of them. The TikTok Creator dataset only includes a selection of popular records and may not contain the complete set of data.

Return Description:
- `materials`: Ad materials list
  - `cost`: Cost level
  - `ctr`: Click-through rate
  - `highlight`: Highlight description
  - `id`: Ad ID
  - `like`: Like count
  - `video_info`: Video information
    - `vid`: Video ID
    - `duration`: Duration in seconds
    - `cover`: Cover image URL
    - `video_url`: Video playback URLs in multiple qualities
      - `360p`: 360p quality video URL
      - `480p`: 480p quality video URL
      - `540p`: 540p quality video URL
      - `720p`: 720p quality video URL
    - `width`: Video width
    - `height`: Video height
- `pagination`: Pagination info
  - `page`: Current page
  - `size`: Items per page
  - `total`: Total count
  - `has_more`: Whether there are more items

Example Response:
```json
{
  "code": 200,
  "router": "/api/v1/tiktok/ads/get_top_ads_spotlight",
  "params": {
    "industry": "25

- Tool ID: `tikhub/tiktok-ads-get-top-ads-spotlight`
- Name in the catalog: Tiktok, Get top ads spotlight
- Provider: [TikHub](/providers/tikhub.md)
- Capability: [TikTok Ad Library](/tools/tiktok-ads/ad-library.md)
- Price: $0.001 per call
- Authentication: an authorised Agentik workspace is required for execution, including zero-price tools.

## Pricing contract

The provider’s price, with no markup. Billed for measured usage.


```json
{
  "model": "per_call",
  "amountUsd": 0.001
}
```

Pricing source: [https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info](https://api.tikhub.io/api/v1/tikhub/user/get_all_endpoints_info). Official per-success route price USD 0.001; daily upstream discounts may reduce provider cost. No discount invented for the customer. 10/second.

Price verification date: 2026-10-05.

## Complete input schema


```json
{
  "type": "object",
  "properties": {
    "industry": {
      "type": "string",
      "title": "Industry",
      "description": "行业ID(可选，不传返回跨行业聚合)/Industry ID (optional)"
    },
    "page": {
      "type": "integer",
      "title": "Page",
      "description": "页码/Page number",
      "default": 1
    },
    "limit": {
      "type": "integer",
      "title": "Limit",
      "description": "每页数量/Items per page",
      "default": 20
    }
  },
  "additionalProperties": false,
  "required": []
}
```

## Published example

This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection.


```json
{
  "tool_id": "tikhub/tiktok-ads-get-top-ads-spotlight",
  "input": {
    "page": 1,
    "limit": 20
  }
}
```

## Execute and retrieve

Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative.

A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md).

[Provider documentation](https://api.tikhub.io/#/TikTok-Ads-API/get_top_ads_spotlight_api_v1_tiktok_ads_get_top_ads_spotlight_post)

[REST inspection](https://api.agentik.cc/v1/tools/tikhub/tiktok-ads-get-top-ads-spotlight) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/tikhub/tiktok-ads-get-top-ads-spotlight) · [Agent index](/llms.txt)
