> ## Documentation Index
> Fetch the complete documentation index at: https://docs.querying.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Ads API

> Analyze competitor ads on TikTok as JSON: search the TikTok Ad Library for the ads an advertiser runs in Europe, the UK, Switzerland, Türkiye and Brazil with impressions and targeting, and read the Creative Center for the top-performing ads of a country.

Read TikTok's ad sources as JSON through the async task API. ADS is its own engine: send `taskType` `ADS` with one of two platforms, and `action` picks what to read. To choose between the ad libraries, see [Ad libraries compared](https://docs.querying.ai/engines/ad-libraries.md).

* `tiktok_ad_library` reads the TikTok Ad Library (the Commercial Content Library). It lists the ads shown in 34 regions: the EU and EEA countries, the UK, Switzerland, Türkiye and Brazil. Each ad carries its first and last shown day and an impressions range, and `ad` adds the landing page, who paid, the targeting and the impressions by country, age and gender. Use it to see all ads of a competitor.
* `tiktok_creative_center` reads the TikTok Creative Center top ads. It lists the ads that performed best in a country over the last 7, 30 or 180 days, with their click-through rate, likes and industry, for 28 countries including the US, Korea and Japan. Use it to see which creatives work in a market.

A search costs **0.5 credits for every 30 ads** it returns on both platforms. `advertisers` and `ad` cost 0.5 credits each.

## TikTok Ad Library

### Request

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "tiktok_ad_library", "advertiserName": "NIKE Retail B.V.", "country": "DE", "sortBy": "published_asc", "limit": 14 } }'
```

Submit the task, then poll `GET /v1/async/task/{id}` or receive its webhook. See [Async tasks](https://docs.querying.ai/concepts/async-tasks.md). A search of 300 ads takes about a minute.

### Analyze a competitor's ads

Three requests cover a competitor analysis:

1. `advertisers` with the start of the competitor's name returns the exact names and IDs the library knows.
2. `search` with that name in `advertiserName` lists the advertiser's ads. `sortBy` orders them by publish date, last shown date or impressions, `activeStatus` keeps the running or the stopped ads, and `summary` counts the formats and the ads that started in each week.
3. `ad` with an ad's `libraryId` returns the landing page, who paid, the targeting, the audience size and the impressions by country, age and gender.

To find ads by what they say, use `query` instead of `advertiserName`: it searches the text, the hashtags and the advertisers' names.

### Parameters

* `action`: `search` (default), `advertisers` or `ad`.
* `country`: Required on every action. One of `AT`, `BE`, `BG`, `BR`, `CH`, `CY`, `CZ`, `DE`, `DK`, `EE`, `ES`, `FI`, `FR`, `GB`, `GR`, `HR`, `HU`, `IE`, `IS`, `IT`, `LI`, `LT`, `LU`, `LV`, `MT`, `NL`, `NO`, `PL`, `PT`, `RO`, `SE`, `SI`, `SK` and `TR`. `ALL` and countries outside the list, such as `US`, `KR` and `JP`, are rejected with `400 VALIDATION_ERROR`, because the library covers these regions only.
* `query`: A keyword. On `search` it matches the text, hashtags and advertisers in order of relevance, and the library counts at most 5,000 ads. On `advertisers` it is the start of an advertiser's name and is required. `search` needs `query` or `advertiserName`, and not both.
* `advertiserName`: An advertiser's exact name, such as `NIKE Retail B.V.`. The library counts all of its ads.
* `libraryId`: The numeric ID of an ad, such as `1879578148398450`. `ad` requires it.
* `activeStatus`: `all` (default), `active` or `inactive`.
* `mediaType`: `all` (default), `video` or `image`.
* `startDate`, `endDate`: `YYYY-MM-DD`. Keeps the ads shown between the two days. The default is the last 365 days.
* `sortBy`: `published_desc` (default), `published_asc`, `last_shown_desc`, `last_shown_asc`, `impressions_desc` or `impressions_asc`. It applies to an `advertiserName` search, and a `query` search is always in order of relevance.
* `limit`: 1 to 300 ads. Default 30.
* `cursor`: The `nextCursor` of an earlier response, to read the ads after it.

`search` reads every field above except `libraryId`. `advertisers` reads `query` and `country`, and `ad` reads `libraryId` and `country`. A value the library cannot search or a field the action does not read is rejected with `400 VALIDATION_ERROR`, and `details` names the field.

### Read more ads

A response with more ads to read carries `nextCursor`. Send it as `cursor` with the same search to receive the next ads, again up to `limit`. `nextCursor` is `null` once the library has no more. A cursor works only with the search that returned it: a different `query`, `advertiserName`, `country`, `activeStatus`, `mediaType`, date range or `sortBy` is rejected with `400 VALIDATION_ERROR`, while `limit` can change. In a `query` search, which the library orders by relevance, a few ads at the edge of two pages can repeat or be missed; `libraryId` tells the repeats apart.

### Find an advertiser

`action` `advertisers` returns up to 20 advertisers whose names start with `query`. Send the exact name as `advertiserName` to search that advertiser's ads.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "tiktok_ad_library", "action": "advertisers", "query": "nike", "country": "DE" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "tiktok_ad_library",
  "action": "advertisers",
  "country": "DE",
  "query": "nike",
  "returnedCount": 5,
  "advertisers": [
    {
      "advertiserId": "7587573238117498896",
      "advertiserName": "NIKE COM SRL",
      "country": null,
      "verified": null,
      "adCount": null
    }
  ]
}
```

Each advertiser has `advertiserId` and `advertiserName`. `country`, `adCount` and `verified` are `null`, because the library's suggestions give no more. An advertiser search costs 0.5 credits.

### Search response

```json theme={"theme":"css-variables"}
{
  "platform": "tiktok_ad_library",
  "action": "search",
  "country": "DE",
  "advertiserName": "NIKE Retail B.V.",
  "activeStatus": "all",
  "mediaType": "all",
  "sortBy": "published_asc",
  "totalCount": 20862,
  "returnedCount": 14,
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJoIjoiRDBZOVVUcnFNamhOQkhXVyIsImMiOiJleUpzWVhOMFgzTnZjblFpT2xzeE56WXdOakF5TVRnM01EQXdYU3dpYm1WNGRGOWpkWEp6YjNJaU9qRXlmUT09IiwicyI6MiwicCI6MTR9",
  "libraryUrl": "https://library.tiktok.com/ads?region=DE&start_time=1763856000000&end_time=1795391999000&adv_name=NIKE%20Retail%20B.V.&adv_biz_ids=&query_type=2&sort_type=create_time%2Casc&ad_type=0&ad_status=0",
  "ads": [
    {
      "position": 1,
      "libraryId": "1845598948737025",
      "libraryUrl": "https://library.tiktok.com/ads/detail/",
      "advertiserId": null,
      "advertiserName": "NIKE Retail B.V.",
      "isActive": null,
      "startDate": "2025-10-22",
      "endDate": "2025-12-21",
      "activeDays": 61,
      "platforms": ["TIKTOK"],
      "format": "VIDEO",
      "title": "Built to Move Different.",
      "body": null,
      "ctaText": null,
      "ctaType": null,
      "linkUrl": null,
      "landingDomain": null,
      "utm": null,
      "payer": null,
      "impressions": { "min": 400000, "max": 500000 },
      "estimatedAudience": "400K-500K",
      "targeting": null,
      "reachedCountries": null,
      "images": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oUghNK4doIQWDyBoVB8FvvvEQmDDPMAupgfSf8~tplv-tiktokx-origin.jpeg"
      ],
      "videos": [
        {
          "previewUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oUghNK4doIQWDyBoVB8FvvvEQmDDPMAupgfSf8~tplv-tiktokx-origin.jpeg",
          "url": "https://library.tiktok.com/api/v1/cdn/1795365691/video/aHR0cHM6Ly92NTgudGlrdG9rY2RuLmNvbS92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXZlLTAwNTFjMDAxLXNnL29rbWhwZ2c4ZkFReU52UHJnRE5vOGZCNFZFQlFGRHZ1UEtHSWlvLw==/3cddf31b-4bd3-44fc-b813-42e1897d9536"
        }
      ],
      "category": null,
      "objective": null
    }
  ],
  "summary": {
    "ads": 14,
    "activeAds": 0,
    "advertisers": [
      { "advertiserName": "NIKE Retail B.V.", "ads": 14 }
    ],
    "formats": { "IMAGE": 2, "VIDEO": 12 },
    "platforms": { "TIKTOK": 14 },
    "ctaTypes": {},
    "landingDomains": [],
    "utmCampaigns": [],
    "launchesByWeek": [
      { "week": "2025-W42", "ads": 4 }
    ],
    "longestRunning": [
      {
        "libraryId": "1845598948737025",
        "advertiserName": "NIKE Retail B.V.",
        "isActive": null,
        "activeDays": 61,
        "title": "Built to Move Different."
      }
    ],
    "oldestStartDate": "2025-10-16",
    "newestStartDate": "2025-11-11",
    "medianActiveDays": 61
  }
}
```

* The response echoes `platform`, `action`, `country`, `query` or `advertiserName`, `activeStatus`, `mediaType` and `sortBy`. `totalCount` is the library's count of the matching ads, which stops at 5,000 for a `query` search. `returnedCount` counts the ads in `ads`, `hasMore` is `true` when the library has more, which `nextCursor` reads, and `libraryUrl` opens the same search in the Ad Library.
* Each ad has `position`, `libraryId`, `libraryUrl`, `advertiserName`, `title`, `format` (`VIDEO`, `IMAGE` or `TEXT`), `images`, `videos` (`url`, `previewUrl`), `startDate`, `endDate`, `activeDays`, `impressions` (`min`, `max`), `estimatedAudience` (the library's range, such as `400K-500K`) and `platforms` (`TIKTOK`).
* `startDate` and `endDate` are the first and last day the library shows the ad (days in UTC). `activeDays` counts the days from `startDate` to `endDate`, both counted. The library gives no spend.
* `isActive` is `true` or `false` when `activeStatus` is `active` or `inactive`, and `null` when it is `all`.
* `advertiserId`, `payer`, `linkUrl`, `landingDomain`, `utm` and `targeting` are `null` in a search. `ad` fills them.
* `summary` counts the ads of this response: `ads`, `activeAds`, `advertisers` (the 10 with the most ads), `formats`, `platforms`, `oldestStartDate`, `newestStartDate` and `medianActiveDays`, with `launchesByWeek` (the ads that started in each ISO week) and `longestRunning` (the 5 ads with the most `activeDays`). It has no `landingDomains` or `utmCampaigns`, because a search carries no landing pages.
* Image and video URLs are signed and expire about 5 to 6 hours after the read. Save the files you need.
* A search with no matching ads completes with an empty `ads` and a `summary` of `0` ads.

### What the library keeps

The library shows ads delivered in its 34 regions and keeps them for about 13 months. It gives the first and last shown day and an impressions range for each ad. It publishes no spend.

### Open one ad

`action` `ad` opens the ad with the `libraryId` and `country` you send.

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "tiktok_ad_library", "action": "ad", "libraryId": "1879578148398450", "country": "DE" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "tiktok_ad_library",
  "action": "ad",
  "country": "DE",
  "libraryId": "1879578148398450",
  "ad": {
    "position": 1,
    "libraryId": "1879578148398450",
    "libraryUrl": "https://library.tiktok.com/ads/detail/",
    "advertiserId": "6876453864464188162",
    "advertiserName": "NIKE Retail B.V.",
    "isActive": null,
    "startDate": "2026-10-20",
    "endDate": "2026-11-08",
    "activeDays": 20,
    "platforms": ["TIKTOK"],
    "format": "VIDEO",
    "title": "Neue Winterausrüstung in Nike Factory Stores.",
    "body": null,
    "ctaText": "Learn more",
    "ctaType": null,
    "linkUrl": "https://www.nike.com/de/retail",
    "landingDomain": "nike.com",
    "utm": null,
    "payer": "INITIATIVE MEDIA B.V.",
    "impressions": { "min": 300000, "max": 400000 },
    "estimatedAudience": "300K-400K",
    "targeting": {
      "byCountry": [
        { "country": "DE", "ages": ["18-24"], "genders": ["FEMALE"] }
      ],
      "cities": [],
      "creatorInteractions": null,
      "customAudience": "No",
      "deviceModels": [],
      "excludesAudience": "No",
      "highSpendingPower": "No",
      "interests": null,
      "languages": [],
      "operatingSystems": ["ALL"],
      "provinces": ["Berlin"],
      "targetAudienceSize": "15.5M-18.9M",
      "videoInteractions": null
    },
    "reachedCountries": ["DE"],
    "images": [
      "https://p16-common-sign.tiktokcdn.com/ad-site-i18n-sg/20261013c7c72a61615657cc4f6482cd~tplv-tiktokx-origin.jpeg"
    ],
    "videos": [
      {
        "previewUrl": "https://p16-common-sign.tiktokcdn.com/ad-site-i18n-sg/20261013c7c72a61615657cc4f6482cd~tplv-tiktokx-origin.jpeg",
        "url": "https://library.tiktok.com/api/v1/cdn/1795365698/video/aHR0cHM6Ly92NTgudGlrdG9rY2RuLmNvbS92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXZlLTUxYzc5OS1zZy9vc21jZFFBbjhBZ1BlRWVWQU1iVmRVQ2tzUUQ0WEdrUlVMRVJoZi8=/9aa37923-f585-4393-b635-1409c7ce6656"
      }
    ],
    "category": "Apparel & Accessories",
    "objective": "Traffic"
  },
  "advertiser": {
    "advertiserId": "6876453864464188162",
    "advertiserName": "NIKE Retail B.V.",
    "payer": "INITIATIVE MEDIA B.V.",
    "account": {
      "verified": true,
      "accountType": "VERIFIED_BA",
      "avatarUrl": "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/e0b0ac7b6ad6447a8e923fd1eb162f2c~tplv-tiktokx-cropcenter:168:168.jpeg",
      "displayName": "Nike",
      "followers": "9.4M",
      "profileUrl": "https://www.tiktok.com/share/user/208464585232822272",
      "username": "nike"
    },
    "registryCountry": "Netherlands"
  },
  "transparency": {
    "byCountry": [
      {
        "country": "DE",
        "impressions": "357K",
        "breakdowns": [
          { "impressions": "44K", "age": "18-24", "gender": "MALE" }
        ]
      }
    ],
    "totalImpressions": "300K-400K"
  }
}
```

* `ad` has the fields of a search ad, plus `linkUrl`, `landingDomain`, `payer` (who paid for the ad), `category`, `objective`, `ctaText`, `advertiserId`, `reachedCountries` and `targeting`.
* `targeting` holds `byCountry` (each country's `ages` and `genders`), `provinces`, `cities`, `languages`, `interests`, `targetAudienceSize` (the library's range, such as `15.5M-18.9M`), `customAudience`, `excludesAudience`, `highSpendingPower`, `operatingSystems`, `deviceModels`, `videoInteractions` and `creatorInteractions`. A part the library does not publish for the ad is `null` or empty.
* `advertiser` has `advertiserId`, `advertiserName`, `payer`, `registryCountry` and the TikTok `account` behind the ads (`username`, `displayName`, `verified`, `followers`, `accountType`, `profileUrl`, `avatarUrl`).
* `transparency` has `totalImpressions` and `byCountry`: each country's `impressions` and its `breakdowns` by `age` and `gender`.
* A `libraryId` the library has no ad for fails with `PAGE_UNAVAILABLE`.

## TikTok Creative Center

The Creative Center lists the top-performing ads of a country, the ads TikTok selects for the last 7, 30 or 180 days. It is a ranked sample, not an advertiser's full set of ads: the advertiser's name is often empty, and the library gives no dates, spend or impressions. It gives each ad's click-through rate, likes, cost level, industry and objectives. Use it to find which hooks, formats and products work in a market.

### Request

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "tiktok_creative_center", "country": "US", "limit": 25 } }'
```

### Parameters

* `action`: `search` (default) or `ad`. `advertisers` is rejected with `400 VALIDATION_ERROR`, because the Creative Center has no advertiser lookup.
* `country`: Required on `search`. One of `AE`, `AR`, `AU`, `BR`, `CA`, `CO`, `DE`, `ES`, `FR`, `GB`, `ID`, `IT`, `JP`, `KR`, `MX`, `MY`, `NL`, `PH`, `PK`, `RO`, `SA`, `SE`, `SG`, `TH`, `TR`, `US`, `VN` and `ZA`. `ALL` is rejected.
* `query`: A keyword.
* `period`: `7`, `30` (default) or `180` days.
* `industry`: An industry ID, such as `21103000000` (Hardware & Electrical), as the `industry.id` of an ad names it.
* `objective`: `traffic`, `app_installs`, `conversions`, `video_views`, `reach`, `lead_generation`, `product_sales` or `app_promotion`.
* `adLanguage`: A language code: `en`, `es`, `ar`, `vi`, `th`, `de`, `id`, `pt`, `fr`, `ms`, `nl`, `ja`, `it`, `ro`, `zh-Hant` or `ko`.
* `adFormat`: `spark` (ads that boost a creator's post) or `non_spark`.
* `sortBy`: `for_you` (default), `impression`, `ctr`, `play_2s_rate`, `play_6s_rate`, `cvr` or `like`.
* `limit`: 1 to 200 ads. Default 30.
* `cursor`: The `nextCursor` of an earlier response.
* `libraryId`: The numeric ID of a top ad. `ad` requires it.

`search` reads every field above except `libraryId`, and `ad` reads `libraryId` only. The Creative Center lists at most about 400 to 500 ads for one country, period and filter set (`totalCount`).

### Search response

```json theme={"theme":"css-variables"}
{
  "platform": "tiktok_creative_center",
  "action": "search",
  "country": "US",
  "period": 30,
  "sortBy": "for_you",
  "totalCount": 183,
  "returnedCount": 25,
  "hasMore": true,
  "nextCursor": "eyJ2IjoxLCJoIjoiUzJCUk5GZ2V4bkNsM1NXcyIsImciOjIsInMiOjYsInAiOjI1fQ",
  "libraryUrl": "https://ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en",
  "ads": [
    {
      "position": 1,
      "libraryId": "7705106910069080084",
      "libraryUrl": null,
      "advertiserId": null,
      "advertiserName": null,
      "isActive": null,
      "startDate": null,
      "endDate": null,
      "activeDays": null,
      "platforms": ["TIKTOK"],
      "format": "VIDEO",
      "width": 720,
      "height": 1280,
      "title": "No-BS Tool Video 103: Northern Tool + Equipment Wide Truck Toolbox",
      "body": null,
      "ctaText": null,
      "ctaType": null,
      "linkUrl": null,
      "landingDomain": null,
      "utm": null,
      "payer": null,
      "impressions": null,
      "targeting": null,
      "reachedCountries": null,
      "images": [
        "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-51c799-sg/oAQ4uJuVEAkCTi0B2YczHAViMtauDHIKBpPBA~tplv-noop.image"
      ],
      "videos": [
        {
          "previewUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-51c799-sg/oAQ4uJuVEAkCTi0B2YczHAViMtauDHIKBpPBA~tplv-noop.image",
          "url": "https://v16m-default.tiktokcdn.com/dd86ec10034c2f4740daf53e9bd6c280/6b036fbb/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAMlOqB0IiATEFAdXQioXCBIAywNfmmu18gjwb/"
        }
      ],
      "aiSummary": null,
      "comments": null,
      "costLevel": 0,
      "ctrPercent": 0.66,
      "durationSeconds": 19.834,
      "industry": { "id": "21103000000", "name": "Hardware & Electrical" },
      "keywords": null,
      "likes": 787,
      "objectives": ["video_views"],
      "shares": null,
      "source": null,
      "videoUrls": {
        "1080p": "https://v16m-default.tiktokcdn.com/dd86ec10034c2f4740daf53e9bd6c280/6b036fbb/video/tos/alisg/tos-alisg-ve-0051c001-sg/oAMlOqB0IiATEFAdXQioXCBIAywNfmmu18gjwb/",
        "360p": "https://v16m-default.tiktokcdn.com/b36269b95476575962b9c114fc501dc3/6b036fbb/video/tos/alisg/tos-alisg-ve-0051c001-sg/o0NvZBpNAk4I2gfqugQFEnK7QB5fuCkcAgDEDZ/",
        "480p": "https://v16m-default.tiktokcdn.com/59590e737aed92b6a688cb20125bb307/6b036fbb/video/tos/alisg/tos-alisg-ve-0051c001-sg/ogfcNqEZ7n5EDE34BAIB2knfpNgg7FQDgKQBug/",
        "540p": "https://v16m-default.tiktokcdn.com/16951456d88cf46000321fb9be66eaa0/6b036fbb/video/tos/alisg/tos-alisg-ve-51c799-sg/oUfDB7pQBIAg2F65KQEncfgougEkZBDvqQNNpF/",
        "720p": "https://v16m-default.tiktokcdn.com/7be67d46e9a7a041e395d2bfabd195f2/6b036fbb/video/tos/alisg/tos-alisg-ve-51c799-sg/osfGceBcVAqbGTPRAaIIATCgED3LgJryVtPzNf/"
      },
      "voiceOver": null
    }
  ],
  "summary": {
    "ads": 25,
    "activeAds": 0,
    "advertisers": [
      { "advertiserName": "Marco Seven", "ads": 1 }
    ],
    "formats": { "VIDEO": 25 },
    "platforms": { "TIKTOK": 25 },
    "ctaTypes": {},
    "landingDomains": [],
    "utmCampaigns": [],
    "launchesByWeek": [],
    "longestRunning": [],
    "oldestStartDate": null,
    "newestStartDate": null,
    "medianActiveDays": null
  }
}
```

* The response echoes `platform`, `action`, `country`, `period`, `sortBy` and the filters it was given. `totalCount` is the number of top ads for that combination.
* Each ad has `position`, `libraryId`, `title`, `advertiserName` (often `null`), `format`, `ctrPercent` (the click-through rate in percent), `costLevel`, `likes`, `industry` (`id`, `name`), `objectives`, `durationSeconds`, `width`, `height`, `voiceOver`, `images`, `videos` and `videoUrls` (the video file by resolution, such as `360p` and `1080p`).
* The Creative Center gives no `startDate`, `endDate`, `impressions` or `libraryUrl`, so these are `null`, and `summary` counts the formats, advertisers and platforms only.
* Video and image URLs are signed and expire about 5 to 6 hours after the read.

### Open one ad

`action` `ad` opens a top ad by `libraryId` and adds `linkUrl`, `landingDomain`, `reachedCountries`, `comments`, `shares` and `source` (where the ad was made, such as `TikTok Ads Manager`).

```bash theme={"theme":"css-variables"}
curl -X POST https://api.querying.ai/v1/async/task \
  -H "Authorization: Bearer $QUERYING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskType": "ADS", "payload": { "platform": "tiktok_creative_center", "action": "ad", "libraryId": "7699613362636095496" } }'
```

```json theme={"theme":"css-variables"}
{
  "platform": "tiktok_creative_center",
  "action": "ad",
  "libraryId": "7699613362636095496",
  "ad": {
    "position": 1,
    "libraryId": "7699613362636095496",
    "libraryUrl": null,
    "advertiserId": null,
    "advertiserName": "Bob Mills Furniture",
    "isActive": null,
    "startDate": null,
    "endDate": null,
    "activeDays": null,
    "platforms": ["TIKTOK"],
    "format": "VIDEO",
    "width": 720,
    "height": 1280,
    "title": "Better Sleep Starts with the Right Mattress",
    "body": null,
    "ctaText": null,
    "ctaType": null,
    "linkUrl": "https://www.bobmillsfurniture.com/sleep-experts",
    "landingDomain": "bobmillsfurniture.com",
    "utm": null,
    "payer": null,
    "impressions": null,
    "targeting": null,
    "reachedCountries": ["US"],
    "images": [
      "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o47taaAAR0LVnI7BhqzPAuKziAYczLByGJi4E~tplv-noop.image"
    ],
    "videos": [
      {
        "previewUrl": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/o47taaAAR0LVnI7BhqzPAuKziAYczLByGJi4E~tplv-noop.image",
        "url": "https://v16m-default.tiktokcdn.com/474b4bf87f62a54743f28d85725bcaf2/6b036fca/video/tos/alisg/tos-alisg-ve-0051c001-sg/oE9AQRij1FVAIezCN8Q3CWtGbD2MUAsgqg8e3f/"
      }
    ],
    "aiSummary": null,
    "comments": 0,
    "costLevel": 1,
    "ctrPercent": 0.2,
    "durationSeconds": 30.55,
    "industry": { "id": "23123000000", "name": "Sports & Fitness" },
    "keywords": null,
    "likes": 28,
    "objectives": ["traffic"],
    "shares": 0,
    "source": "TikTok Ads Manager",
    "videoUrls": {
      "1080p": "https://v16m-default.tiktokcdn.com/474b4bf87f62a54743f28d85725bcaf2/6b036fca/video/tos/alisg/tos-alisg-ve-0051c001-sg/oE9AQRij1FVAIezCN8Q3CWtGbD2MUAsgqg8e3f/",
      "360p": "https://v16m-default.tiktokcdn.com/93487026a84b0472c46d3ff9471ee8f7/6b036fca/video/tos/alisg/tos-alisg-ve-0051c001-sg/oo1kCLCbgGVGt1GsCACGAAzbQefjqmDIfyIXQg/",
      "480p": "https://v16m-default.tiktokcdn.com/49d6ee93d4fc380675d41954037c55d1/6b036fca/video/tos/alisg/tos-alisg-ve-51c799-sg/okfRtfZroqDRIgEzhatFVDwDBABy2ENaWhQAQB/",
      "540p": "https://v16m-default.tiktokcdn.com/ce0699fb34b5ba3ccaa5251fba131ce2/6b036fca/video/tos/alisg/tos-alisg-ve-0051c001-sg/oUCWfxEEIBgqR32fDhFQapDtyZWaEDAVDBoNQh/",
      "720p": "https://v16m-default.tiktokcdn.com/d27a8eba19586eacc4784887cdd649e3/6b036fca/video/tos/alisg/tos-alisg-ve-0051c001-sg/o0fNIDWVyhREjDDafOB4EzahgQFZBqAo2tDQhE/"
    },
    "voiceOver": false
  }
}
```

A `libraryId` the Creative Center has no ad for fails with `PAGE_UNAVAILABLE`.

## Price

A search holds 0.5 credits for every 30 ads its `limit` asks for, and is charged 0.5 credits for every 30 ads it returns, at least 0.5 credits. The default search of 30 ads costs 0.5 credits, and a search with `limit` 300 on the Ad Library holds 5 credits. `advertisers` and `ad` cost 0.5 credits each. Only completed requests are charged.

## Related

* [Ad libraries compared](https://docs.querying.ai/engines/ad-libraries.md)
* [Meta Ad Library](https://docs.querying.ai/engines/meta-ad-library.md)
* [Engine overview](https://docs.querying.ai/engines/overview.md)
* [Credits and limits](https://docs.querying.ai/concepts/credits-and-limits.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.