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

# API de TikTok Ads

> Analysez les publicités de vos concurrents sur TikTok en JSON : recherchez dans la Bibliothèque publicitaire de TikTok les publicités qu’un annonceur diffuse en Europe, au Royaume-Uni, en Suisse, en Türkiye et au Brésil avec impressions et ciblage, et lisez le Creative Center pour les publicités les plus performantes d’un pays.

Lisez les sources publicitaires de TikTok en JSON via l’API asynchrone de tâches. ADS est un moteur à part entière : envoyez `taskType` `ADS` avec l’une de deux plateformes, et `action` choisit ce qu’il faut lire. Pour choisir entre les bibliothèques publicitaires, voir [Bibliothèques publicitaires comparées](https://docs.querying.ai/fr/engines/ad-libraries.md).

* `tiktok_ad_library` lit la Bibliothèque publicitaire de TikTok (la Commercial Content Library). Elle liste les publicités diffusées dans 34 régions : les pays de l’UE et de l’EEE, le Royaume-Uni, la Suisse, la Türkiye et le Brésil. Chaque publicité indique son premier et son dernier jour de diffusion et une fourchette d’impressions, et `ad` ajoute la page de destination, qui a payé, le ciblage et les impressions par pays, âge et genre. Utilisez-la pour voir toutes les publicités d’un concurrent.
* `tiktok_creative_center` lit les meilleures publicités du TikTok Creative Center. Il liste les publicités les plus performantes d’un pays sur les 7, 30 ou 180 derniers jours, avec leur taux de clics, leurs mentions « J’aime » et leur secteur, pour 28 pays dont les États-Unis, la Corée et le Japon. Utilisez-le pour voir quelles créations fonctionnent sur un marché.

Une recherche coûte **0.5 crédit pour 30 publicités** renvoyées sur les deux plateformes. `advertisers` et `ad` coûtent 0.5 crédit chacun.

## Bibliothèque publicitaire de TikTok

### Requête

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

Soumettez la tâche, puis interrogez `GET /v1/async/task/{id}` ou recevez son webhook. Voir [Tâches asynchrones](https://docs.querying.ai/fr/concepts/async-tasks.md). Une recherche de 300 publicités prend environ une minute.

### Analyser les publicités d’un concurrent

Trois requêtes couvrent une analyse de la concurrence :

1. `advertisers` avec le début du nom du concurrent renvoie les noms exacts et les IDs que connaît la bibliothèque.
2. `search` avec ce nom dans `advertiserName` liste les publicités de l’annonceur. `sortBy` les classe par date de publication, date de dernière diffusion ou impressions, `activeStatus` conserve les publicités en cours ou arrêtées, et `summary` compte les formats et les publicités lancées chaque semaine.
3. `ad` avec le `libraryId` d’une publicité renvoie la page de destination, qui a payé, le ciblage, la taille de l’audience et les impressions par pays, âge et genre.

Pour trouver des publicités d’après ce qu’elles disent, utilisez `query` à la place de `advertiserName` : il recherche dans le texte, les hashtags et les noms des annonceurs.

### Paramètres

* `action` : `search` (par défaut), `advertisers` ou `ad`.
* `country` : obligatoire sur chaque action. L’un de `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` et `TR`. `ALL` et les pays hors de la liste, comme `US`, `KR` et `JP`, sont rejetés avec `400 VALIDATION_ERROR`, car la bibliothèque couvre ces régions uniquement.
* `query` : un mot-clé. Sur `search`, il correspond au texte, aux hashtags et aux annonceurs par ordre de pertinence, et la bibliothèque compte au plus 5,000 publicités. Sur `advertisers`, c’est le début du nom d’un annonceur et il est obligatoire. `search` exige `query` ou `advertiserName`, mais pas les deux.
* `advertiserName` : le nom exact d’un annonceur, comme `NIKE Retail B.V.`. La bibliothèque compte toutes ses publicités.
* `libraryId` : l’ID numérique d’une publicité, comme `1879578148398450`. `ad` l’exige.
* `activeStatus` : `all` (par défaut), `active` ou `inactive`.
* `mediaType` : `all` (par défaut), `video` ou `image`.
* `startDate`, `endDate` : `YYYY-MM-DD`. Conserve les publicités diffusées entre les deux jours. Par défaut, les 365 derniers jours.
* `sortBy` : `published_desc` (par défaut), `published_asc`, `last_shown_desc`, `last_shown_asc`, `impressions_desc` ou `impressions_asc`. Il s’applique à une recherche par `advertiserName`, et une recherche par `query` suit toujours l’ordre de pertinence.
* `limit` : de 1 à 300 publicités. Par défaut 30.
* `cursor` : le `nextCursor` d’une réponse précédente, pour lire les publicités suivantes.

`search` lit tous les champs ci-dessus sauf `libraryId`. `advertisers` lit `query` et `country`, et `ad` lit `libraryId` et `country`. Une valeur que la bibliothèque ne peut pas rechercher ou un champ que l’action ne lit pas est rejeté avec `400 VALIDATION_ERROR`, et `details` nomme le champ.

### Lire plus de publicités

Une réponse qui a encore des publicités à lire contient `nextCursor`. Envoyez-le comme `cursor` avec la même recherche pour recevoir les publicités suivantes, là encore jusqu’à `limit`. `nextCursor` vaut `null` lorsque la bibliothèque n’en a plus. Un curseur ne fonctionne qu’avec la recherche qui l’a renvoyé : un `query`, `advertiserName`, `country`, `activeStatus`, `mediaType`, une plage de dates ou un `sortBy` différents sont rejetés avec `400 VALIDATION_ERROR`, tandis que `limit` peut changer. Dans une recherche par `query`, que la bibliothèque classe par pertinence, quelques publicités à la limite de deux pages peuvent apparaître deux fois ou manquer ; `libraryId` permet de distinguer les doublons.

### Trouver un annonceur

`action` `advertisers` renvoie jusqu’à 20 annonceurs dont le nom commence par `query`. Envoyez le nom exact comme `advertiserName` pour rechercher les publicités de cet annonceur.

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

Chaque annonceur a `advertiserId` et `advertiserName`. `country`, `adCount` et `verified` valent `null`, car les suggestions de la bibliothèque n’en donnent pas davantage. Une recherche d’annonceur coûte 0.5 crédit.

### Réponse de recherche

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

* La réponse reprend `platform`, `action`, `country`, `query` ou `advertiserName`, `activeStatus`, `mediaType` et `sortBy`. `totalCount` est le compte de la bibliothèque pour les publicités correspondantes, qui s’arrête à 5,000 pour une recherche par `query`. `returnedCount` compte les publicités dans `ads`, `hasMore` vaut `true` lorsque la bibliothèque en a davantage, ce que `nextCursor` lit, et `libraryUrl` ouvre la même recherche dans la Bibliothèque publicitaire.
* Chaque publicité a `position`, `libraryId`, `libraryUrl`, `advertiserName`, `title`, `format` (`VIDEO`, `IMAGE` ou `TEXT`), `images`, `videos` (`url`, `previewUrl`), `startDate`, `endDate`, `activeDays`, `impressions` (`min`, `max`), `estimatedAudience` (la fourchette de la bibliothèque, comme `400K-500K`) et `platforms` (`TIKTOK`).
* `startDate` et `endDate` sont le premier et le dernier jour où la bibliothèque montre la publicité (jours en UTC). `activeDays` compte les jours de `startDate` à `endDate`, les deux inclus. La bibliothèque ne donne pas les dépenses.
* `isActive` vaut `true` ou `false` lorsque `activeStatus` est `active` ou `inactive`, et `null` lorsqu’il est `all`.
* `advertiserId`, `payer`, `linkUrl`, `landingDomain`, `utm` et `targeting` valent `null` dans une recherche. `ad` les remplit.
* `summary` compte les publicités de cette réponse : `ads`, `activeAds`, `advertisers` (les 10 qui ont le plus de publicités), `formats`, `platforms`, `oldestStartDate`, `newestStartDate` et `medianActiveDays`, avec `launchesByWeek` (les publicités lancées chaque semaine ISO) et `longestRunning` (les 5 publicités avec le plus de `activeDays`). Il ne contient ni `landingDomains` ni `utmCampaigns`, car une recherche ne porte aucune page de destination.
* Les URL d’images et de vidéos sont signées et expirent environ 5 à 6 heures après la lecture. Enregistrez les fichiers dont vous avez besoin.
* Une recherche sans publicité correspondante se termine avec `ads` vide et un `summary` de `0` publicité.

### Ce que la bibliothèque conserve

La bibliothèque montre les publicités diffusées dans ses 34 régions et les conserve environ 13 mois. Elle donne le premier et le dernier jour de diffusion et une fourchette d’impressions pour chaque publicité. Elle ne publie pas les dépenses.

### Ouvrir une publicité

`action` `ad` ouvre la publicité avec le `libraryId` et le `country` que vous envoyez.

```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` contient les champs d’une publicité de recherche, plus `linkUrl`, `landingDomain`, `payer` (qui a payé la publicité), `category`, `objective`, `ctaText`, `advertiserId`, `reachedCountries` et `targeting`.
* `targeting` contient `byCountry` (les `ages` et `genders` de chaque pays), `provinces`, `cities`, `languages`, `interests`, `targetAudienceSize` (la fourchette de la bibliothèque, comme `15.5M-18.9M`), `customAudience`, `excludesAudience`, `highSpendingPower`, `operatingSystems`, `deviceModels`, `videoInteractions` et `creatorInteractions`. Un élément que la bibliothèque ne publie pas pour la publicité vaut `null` ou est vide.
* `advertiser` contient `advertiserId`, `advertiserName`, `payer`, `registryCountry` et le `account` TikTok derrière les publicités (`username`, `displayName`, `verified`, `followers`, `accountType`, `profileUrl`, `avatarUrl`).
* `transparency` contient `totalImpressions` et `byCountry` : les `impressions` de chaque pays et leurs `breakdowns` par `age` et `gender`.
* Un `libraryId` pour lequel la bibliothèque n’a aucune publicité échoue avec `PAGE_UNAVAILABLE`.

## TikTok Creative Center

Le Creative Center liste les publicités les plus performantes d’un pays, celles que TikTok sélectionne pour les 7, 30 ou 180 derniers jours. C’est un échantillon classé, et non l’ensemble des publicités d’un annonceur : le nom de l’annonceur est souvent vide, et la bibliothèque ne donne ni dates, ni dépenses, ni impressions. Elle donne le taux de clics, les mentions « J’aime », le niveau de coût, le secteur et les objectifs de chaque publicité. Utilisez-le pour trouver les accroches, formats et produits qui fonctionnent sur un marché.

### Requête

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

### Paramètres

* `action` : `search` (par défaut) ou `ad`. `advertisers` est rejeté avec `400 VALIDATION_ERROR`, car le Creative Center n’a pas de recherche d’annonceur.
* `country` : obligatoire sur `search`. L’un de `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` et `ZA`. `ALL` est rejeté.
* `query` : un mot-clé.
* `period` : `7`, `30` (par défaut) ou `180` jours.
* `industry` : un ID de secteur, comme `21103000000` (Hardware & Electrical), tel que le nomme le `industry.id` d’une publicité.
* `objective` : `traffic`, `app_installs`, `conversions`, `video_views`, `reach`, `lead_generation`, `product_sales` ou `app_promotion`.
* `adLanguage` : un code de langue : `en`, `es`, `ar`, `vi`, `th`, `de`, `id`, `pt`, `fr`, `ms`, `nl`, `ja`, `it`, `ro`, `zh-Hant` ou `ko`.
* `adFormat` : `spark` (publicités qui boostent la publication d’un créateur) ou `non_spark`.
* `sortBy` : `for_you` (par défaut), `impression`, `ctr`, `play_2s_rate`, `play_6s_rate`, `cvr` ou `like`.
* `limit` : de 1 à 200 publicités. Par défaut 30.
* `cursor` : le `nextCursor` d’une réponse précédente.
* `libraryId` : l’ID numérique d’une publicité du classement. `ad` l’exige.

`search` lit tous les champs ci-dessus sauf `libraryId`, et `ad` lit uniquement `libraryId`. Le Creative Center liste au plus environ 400 à 500 publicités pour un pays, une période et un ensemble de filtres (`totalCount`).

### Réponse de recherche

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

* La réponse reprend `platform`, `action`, `country`, `period`, `sortBy` et les filtres reçus. `totalCount` est le nombre de publicités du classement pour cette combinaison.
* Chaque publicité a `position`, `libraryId`, `title`, `advertiserName` (souvent `null`), `format`, `ctrPercent` (le taux de clics en pourcentage), `costLevel`, `likes`, `industry` (`id`, `name`), `objectives`, `durationSeconds`, `width`, `height`, `voiceOver`, `images`, `videos` et `videoUrls` (le fichier vidéo par résolution, comme `360p` et `1080p`).
* Le Creative Center ne donne ni `startDate`, ni `endDate`, ni `impressions`, ni `libraryUrl`, qui valent donc `null`, et `summary` ne compte que les formats, les annonceurs et les plateformes.
* Les URL de vidéos et d’images sont signées et expirent environ 5 à 6 heures après la lecture.

### Ouvrir une publicité

`action` `ad` ouvre une publicité du classement par `libraryId` et ajoute `linkUrl`, `landingDomain`, `reachedCountries`, `comments`, `shares` et `source` (où la publicité a été créée, comme `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
  }
}
```

Un `libraryId` pour lequel le Creative Center n’a aucune publicité échoue avec `PAGE_UNAVAILABLE`.

## Tarif

Une recherche réserve 0.5 crédit pour 30 publicités que demande son `limit`, et facture 0.5 crédit pour 30 publicités renvoyées, avec un minimum de 0.5 crédit. La recherche par défaut de 30 publicités coûte 0.5 crédit, et une recherche avec `limit` 300 sur la Bibliothèque publicitaire réserve 5 crédits. `advertisers` et `ad` coûtent 0.5 crédit chacun. Seules les requêtes terminées sont facturées.

## Voir aussi

* [Bibliothèques publicitaires comparées](https://docs.querying.ai/fr/engines/ad-libraries.md)
* [Bibliothèque publicitaire de Meta](https://docs.querying.ai/fr/engines/meta-ad-library.md)
* [Vue d’ensemble des moteurs](https://docs.querying.ai/fr/engines/overview.md)
* [Crédits et limites](https://docs.querying.ai/fr/concepts/credits-and-limits.md)


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