> ## 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

> Analysieren Sie die Anzeigen Ihrer Wettbewerber auf TikTok als JSON: Durchsuchen Sie die TikTok-Werbebibliothek nach den Anzeigen, die ein Werbetreibender in Europa, im Vereinigten Königreich, in der Schweiz, in Türkiye und in Brasilien schaltet, mit Impressionen und Targeting, und lesen Sie das Creative Center für die leistungsstärksten Anzeigen eines Landes.

Lesen Sie die Werbequellen von TikTok über die asynchrone Task-API als JSON. ADS ist eine eigene Engine: Senden Sie `taskType` `ADS` mit einer von zwei Plattformen, und `action` wählt, was gelesen wird. Zur Auswahl zwischen den Werbebibliotheken siehe [Werbebibliotheken im Vergleich](https://docs.querying.ai/de/engines/ad-libraries.md).

* `tiktok_ad_library` liest die TikTok-Werbebibliothek (die Commercial Content Library). Sie listet die Anzeigen auf, die in 34 Regionen ausgespielt wurden: den EU- und EWR-Ländern, dem Vereinigten Königreich, der Schweiz, Türkiye und Brasilien. Jede Anzeige enthält ihren ersten und letzten Ausspielungstag und eine Impressionen-Spanne, und `ad` ergänzt die Zielseite, den Zahler, das Targeting und die Impressionen nach Land, Alter und Geschlecht. Nutzen Sie sie, um alle Anzeigen eines Wettbewerbers zu sehen.
* `tiktok_creative_center` liest die Top-Anzeigen des TikTok Creative Center. Es listet die Anzeigen auf, die in einem Land in den letzten 7, 30 oder 180 Tagen am besten abgeschnitten haben, mit Klickrate, Likes und Branche, für 28 Länder, darunter die USA, Korea und Japan. Nutzen Sie es, um zu sehen, welche Creatives in einem Markt funktionieren.

Eine Suche kostet **0.5 Credits je 30 Anzeigen**, die sie auf beiden Plattformen liefert. `advertisers` und `ad` kosten je 0.5 Credits.

## TikTok-Werbebibliothek

### Anfrage

```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 } }'
```

Senden Sie den Task ab und fragen Sie dann `GET /v1/async/task/{id}` ab oder empfangen Sie den Webhook. Siehe [Asynchrone Tasks](https://docs.querying.ai/de/concepts/async-tasks.md). Eine Suche nach 300 Anzeigen dauert etwa eine Minute.

### Anzeigen eines Wettbewerbers analysieren

Drei Anfragen decken eine Wettbewerbsanalyse ab:

1. `advertisers` mit dem Anfang des Namens des Wettbewerbers liefert die genauen Namen und IDs, die die Bibliothek kennt.
2. `search` mit diesem Namen in `advertiserName` listet die Anzeigen des Werbetreibenden auf. `sortBy` ordnet sie nach Veröffentlichungsdatum, Datum der letzten Ausspielung oder Impressionen, `activeStatus` behält die laufenden oder die beendeten Anzeigen, und `summary` zählt die Formate und die Anzeigen, die in jeder Woche gestartet sind.
3. `ad` mit der `libraryId` einer Anzeige liefert die Zielseite, wer bezahlt hat, das Targeting, die Zielgruppengröße und die Impressionen nach Land, Alter und Geschlecht.

Um Anzeigen nach ihrem Inhalt zu finden, nutzen Sie `query` statt `advertiserName`: Es durchsucht den Text, die Hashtags und die Namen der Werbetreibenden.

### Parameter

* `action`: `search` (Standard), `advertisers` oder `ad`.
* `country`: Bei jeder Aktion erforderlich. Eines von `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` und `TR`. `ALL` und Länder außerhalb der Liste, etwa `US`, `KR` und `JP`, werden mit `400 VALIDATION_ERROR` abgelehnt, weil die Bibliothek nur diese Regionen abdeckt.
* `query`: Ein Stichwort. Bei `search` passt es nach Relevanz auf Text, Hashtags und Werbetreibende, und die Bibliothek zählt höchstens 5,000 Anzeigen. Bei `advertisers` ist es der Anfang des Namens eines Werbetreibenden und erforderlich. `search` braucht `query` oder `advertiserName`, aber nicht beides.
* `advertiserName`: Der genaue Name eines Werbetreibenden, etwa `NIKE Retail B.V.`. Die Bibliothek zählt alle seine Anzeigen.
* `libraryId`: Die numerische ID einer Anzeige, etwa `1879578148398450`. `ad` verlangt sie.
* `activeStatus`: `all` (Standard), `active` oder `inactive`.
* `mediaType`: `all` (Standard), `video` oder `image`.
* `startDate`, `endDate`: `YYYY-MM-DD`. Behält die Anzeigen, die zwischen den beiden Tagen ausgespielt wurden. Standard sind die letzten 365 Tage.
* `sortBy`: `published_desc` (Standard), `published_asc`, `last_shown_desc`, `last_shown_asc`, `impressions_desc` oder `impressions_asc`. Es gilt für eine Suche mit `advertiserName`, und eine Suche mit `query` folgt immer der Relevanz.
* `limit`: 1 bis 300 Anzeigen. Standard 30.
* `cursor`: Der `nextCursor` einer früheren Antwort, um die darauffolgenden Anzeigen zu lesen.

`search` liest alle Felder oben außer `libraryId`. `advertisers` liest `query` und `country`, und `ad` liest `libraryId` und `country`. Ein Wert, den die Bibliothek nicht durchsuchen kann, oder ein Feld, das die Aktion nicht liest, wird mit `400 VALIDATION_ERROR` abgelehnt, und `details` nennt das Feld.

### Weitere Anzeigen lesen

Eine Antwort mit weiteren zu lesenden Anzeigen enthält `nextCursor`. Senden Sie ihn mit derselben Suche als `cursor`, um die nächsten Anzeigen zu erhalten, wieder bis zu `limit`. `nextCursor` ist `null`, sobald die Bibliothek keine weiteren hat. Ein Cursor funktioniert nur mit der Suche, die ihn geliefert hat: Eine andere `query`, `advertiserName`, `country`, `activeStatus`, `mediaType`, ein anderer Datumsbereich oder `sortBy` wird mit `400 VALIDATION_ERROR` abgelehnt, während sich `limit` ändern darf. Bei einer `query`-Suche, die die Bibliothek nach Relevanz ordnet, können einige Anzeigen an der Grenze zweier Seiten doppelt vorkommen oder fehlen; `libraryId` unterscheidet die Duplikate.

### Werbetreibenden finden

`action` `advertisers` liefert bis zu 20 Werbetreibende, deren Namen mit `query` beginnen. Senden Sie den genauen Namen als `advertiserName`, um die Anzeigen dieses Werbetreibenden zu suchen.

```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
    }
  ]
}
```

Jeder Werbetreibende hat `advertiserId` und `advertiserName`. `country`, `adCount` und `verified` sind `null`, weil die Vorschläge der Bibliothek nicht mehr liefern. Eine Werbetreibenden-Suche kostet 0.5 Credits.

### Such-Antwort

```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
  }
}
```

* Die Antwort gibt `platform`, `action`, `country`, `query` oder `advertiserName`, `activeStatus`, `mediaType` und `sortBy` zurück. `totalCount` ist die Zählung der Bibliothek für die passenden Anzeigen, die bei einer `query`-Suche bei 5,000 endet. `returnedCount` zählt die Anzeigen in `ads`, `hasMore` ist `true`, wenn die Bibliothek mehr hat, die `nextCursor` liest, und `libraryUrl` öffnet dieselbe Suche in der Werbebibliothek.
* Jede Anzeige hat `position`, `libraryId`, `libraryUrl`, `advertiserName`, `title`, `format` (`VIDEO`, `IMAGE` oder `TEXT`), `images`, `videos` (`url`, `previewUrl`), `startDate`, `endDate`, `activeDays`, `impressions` (`min`, `max`), `estimatedAudience` (die Spanne der Bibliothek, etwa `400K-500K`) und `platforms` (`TIKTOK`).
* `startDate` und `endDate` sind der erste und der letzte Tag, an dem die Bibliothek die Anzeige zeigt (Tage in UTC). `activeDays` zählt die Tage von `startDate` bis `endDate`, beide mitgezählt. Die Bibliothek liefert keine Ausgaben.
* `isActive` ist `true` oder `false`, wenn `activeStatus` `active` oder `inactive` ist, und `null`, wenn es `all` ist.
* `advertiserId`, `payer`, `linkUrl`, `landingDomain`, `utm` und `targeting` sind in einer Suche `null`. `ad` füllt sie.
* `summary` zählt die Anzeigen dieser Antwort: `ads`, `activeAds`, `advertisers` (die 10 mit den meisten Anzeigen), `formats`, `platforms`, `oldestStartDate`, `newestStartDate` und `medianActiveDays`, mit `launchesByWeek` (die Anzeigen, die in jeder ISO-Woche starteten) und `longestRunning` (die 5 Anzeigen mit den meisten `activeDays`). Es enthält weder `landingDomains` noch `utmCampaigns`, weil eine Suche keine Zielseiten enthält.
* Bild- und Video-URLs sind signiert und laufen etwa 5 bis 6 Stunden nach dem Lesen ab. Speichern Sie die Dateien, die Sie brauchen.
* Eine Suche ohne passende Anzeigen endet mit leerem `ads` und einer `summary` mit `0` Anzeigen.

### Was die Bibliothek aufbewahrt

Die Bibliothek zeigt in ihren 34 Regionen ausgespielte Anzeigen und bewahrt sie etwa 13 Monate auf. Sie liefert zu jeder Anzeige den ersten und letzten Ausspielungstag und eine Impressionen-Spanne. Ausgaben veröffentlicht sie nicht.

### Eine Anzeige öffnen

`action` `ad` öffnet die Anzeige mit der `libraryId` und dem `country`, die Sie senden.

```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` enthält die Felder einer Suchanzeige sowie `linkUrl`, `landingDomain`, `payer` (wer die Anzeige bezahlt hat), `category`, `objective`, `ctaText`, `advertiserId`, `reachedCountries` und `targeting`.
* `targeting` enthält `byCountry` (die `ages` und `genders` jedes Landes), `provinces`, `cities`, `languages`, `interests`, `targetAudienceSize` (die Spanne der Bibliothek, etwa `15.5M-18.9M`), `customAudience`, `excludesAudience`, `highSpendingPower`, `operatingSystems`, `deviceModels`, `videoInteractions` und `creatorInteractions`. Ein Teil, den die Bibliothek für die Anzeige nicht veröffentlicht, ist `null` oder leer.
* `advertiser` enthält `advertiserId`, `advertiserName`, `payer`, `registryCountry` und das TikTok-`account` hinter den Anzeigen (`username`, `displayName`, `verified`, `followers`, `accountType`, `profileUrl`, `avatarUrl`).
* `transparency` enthält `totalImpressions` und `byCountry`: die `impressions` jedes Landes und ihre `breakdowns` nach `age` und `gender`.
* Eine `libraryId`, zu der die Bibliothek keine Anzeige hat, schlägt mit `PAGE_UNAVAILABLE` fehl.

## TikTok Creative Center

Das Creative Center listet die leistungsstärksten Anzeigen eines Landes auf, die Anzeigen, die TikTok für die letzten 7, 30 oder 180 Tage auswählt. Es ist eine gereihte Stichprobe, nicht die vollständige Anzeigenmenge eines Werbetreibenden: Der Name des Werbetreibenden ist oft leer, und die Bibliothek liefert weder Daten noch Ausgaben noch Impressionen. Sie liefert Klickrate, Likes, Kostenniveau, Branche und Ziele jeder Anzeige. Nutzen Sie es, um herauszufinden, welche Hooks, Formate und Produkte in einem Markt funktionieren.

### Anfrage

```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 } }'
```

### Parameter

* `action`: `search` (Standard) oder `ad`. `advertisers` wird mit `400 VALIDATION_ERROR` abgelehnt, weil das Creative Center keine Suche nach Werbetreibenden bietet.
* `country`: Bei `search` erforderlich. Eines von `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` und `ZA`. `ALL` wird abgelehnt.
* `query`: Ein Stichwort.
* `period`: `7`, `30` (Standard) oder `180` Tage.
* `industry`: Eine Branchen-ID, etwa `21103000000` (Hardware & Electrical), wie sie die `industry.id` einer Anzeige nennt.
* `objective`: `traffic`, `app_installs`, `conversions`, `video_views`, `reach`, `lead_generation`, `product_sales` oder `app_promotion`.
* `adLanguage`: Ein Sprachcode: `en`, `es`, `ar`, `vi`, `th`, `de`, `id`, `pt`, `fr`, `ms`, `nl`, `ja`, `it`, `ro`, `zh-Hant` oder `ko`.
* `adFormat`: `spark` (Anzeigen, die den Beitrag eines Creators bewerben) oder `non_spark`.
* `sortBy`: `for_you` (Standard), `impression`, `ctr`, `play_2s_rate`, `play_6s_rate`, `cvr` oder `like`.
* `limit`: 1 bis 200 Anzeigen. Standard 30.
* `cursor`: Der `nextCursor` einer früheren Antwort.
* `libraryId`: Die numerische ID einer Top-Anzeige. `ad` verlangt sie.

`search` liest alle Felder oben außer `libraryId`, und `ad` liest nur `libraryId`. Das Creative Center listet für ein Land, einen Zeitraum und einen Filtersatz höchstens etwa 400 bis 500 Anzeigen auf (`totalCount`).

### Such-Antwort

```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
  }
}
```

* Die Antwort gibt `platform`, `action`, `country`, `period`, `sortBy` und die erhaltenen Filter zurück. `totalCount` ist die Zahl der Top-Anzeigen für diese Kombination.
* Jede Anzeige hat `position`, `libraryId`, `title`, `advertiserName` (oft `null`), `format`, `ctrPercent` (die Klickrate in Prozent), `costLevel`, `likes`, `industry` (`id`, `name`), `objectives`, `durationSeconds`, `width`, `height`, `voiceOver`, `images`, `videos` und `videoUrls` (die Videodatei je Auflösung, etwa `360p` und `1080p`).
* Das Creative Center liefert weder `startDate` noch `endDate`, `impressions` oder `libraryUrl`, daher sind diese `null`, und `summary` zählt nur die Formate, Werbetreibenden und Plattformen.
* Video- und Bild-URLs sind signiert und laufen etwa 5 bis 6 Stunden nach dem Lesen ab.

### Eine Anzeige öffnen

`action` `ad` öffnet eine Top-Anzeige über `libraryId` und ergänzt `linkUrl`, `landingDomain`, `reachedCountries`, `comments`, `shares` und `source` (wo die Anzeige erstellt wurde, etwa `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
  }
}
```

Eine `libraryId`, zu der das Creative Center keine Anzeige hat, schlägt mit `PAGE_UNAVAILABLE` fehl.

## Preis

Eine Suche reserviert 0.5 Credits je 30 Anzeigen, die ihr `limit` verlangt, und berechnet 0.5 Credits je 30 gelieferte Anzeigen, mindestens 0.5 Credits. Die Standardsuche mit 30 Anzeigen kostet 0.5 Credits, und eine Suche mit `limit` 300 in der Werbebibliothek reserviert 5 Credits. `advertisers` und `ad` kosten je 0.5 Credits. Nur abgeschlossene Anfragen werden berechnet.

## Siehe auch

* [Werbebibliotheken im Vergleich](https://docs.querying.ai/de/engines/ad-libraries.md)
* [Meta-Werbebibliothek](https://docs.querying.ai/de/engines/meta-ad-library.md)
* [Engine-Übersicht](https://docs.querying.ai/de/engines/overview.md)
* [Credits und Limits](https://docs.querying.ai/de/concepts/credits-and-limits.md)


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