API TikTok

TikTok Recherche dans la bibliothèque publicitaire API

Cherchez dans l’Ads Library publique de TikTok par mot-clé ou annonceur (annonceur, titre, tranche d’audience, dates de diffusion, lien de la bibliothèque et vidéo).

0,80 $US/1k req, paiement à la requête, sans abonnement.

Top Ads Dashboard | TikTok Creative Center
ads.tiktok.com/business/creativecenter/inspiration/topads/pc/en
TikTokCreative CenterLog in

Explore Top Ads on TikTok

spotifySearch

Top Ads Dashboard

GermanyAd FormatObjectiveAd Language

Spotify

Spotify Premium: 3 months free

500K-1M audience · last shown Sep 27, 2025

Ce que l’API a renvoyéads[0]
{
"adId": "7648493525660270600",
"adTitle": "Spotify Premium: 3 months free",
"brandName": "Spotify",
"estimatedAudience": "500K-1M",
"firstShownUtc": 1758067200,
"lastShownUtc": 1758931200,
"url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE",
"videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",
... 3 champs de plus
}
Disponibilité
97,50%
30d · 27 870 appels
Requêtes
27 895
30 j · par semaine, 12 dernières sem.
Réponse
2,4s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API TikTok Recherche dans la bibliothèque publicitaire : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
8,00 $US
0,80 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 125 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez TikTok Recherche dans la bibliothèque publicitaire en une requête

Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 17 champs sur 18. Voir tous les champs

{
  "found": true,
  "data": {
    "nextCursor": "eyJvZmZzZXQiOjIwfQ==",
    "hasMore": true,
    "total": 46,
    "ads": [
      {
        "adId": "7648493525660270600",
        "adTitle": "Spotify Premium: 3 months free",
        "brandName": "Spotify",
        "estimatedAudience": "500K-1M",
        "firstShownUtc": 1758067200,
        "lastShownUtc": 1758931200,
        "url": "https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE",
        "videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4",
        "coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg",
        "status": "active",
        "format": "video"
      },
      {
        "adId": "7648501298817568001",
        "adTitle": "Discover Weekly, reimagined",
        "brandName": "Spotify",
        "estimatedAudience": "1M-2M",
        "firstShownUtc": 1757548800,
        "lastShownUtc": 1758758400,
        "url": "https://library.tiktok.com/ads/detail?ad_id=7648501298817568001&region=DE",
        "videoUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-video.mp4",
        "coverUrl": "https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648501298817568001~tplv-ad-cover.jpeg",
        "status": "active",
        "format": "video"
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • advertiserNamestring

    Nom de l’annonceur dont lister les annonces (p. ex. Spotify). Fournissez advertiserName ou query, jamais les deux.

  • cursorstring

    Curseur opaque issu du nextCursor d’une réponse précédente. Omettez-le pour la première page.

  • daysinteger

    Number of days of library history to search, from 1 to 365.

  • querystring

    spotify

    Mot-clé pour chercher dans les titres et contenus d’annonces (p. ex. spotify). Fournissez query ou advertiserName, jamais les deux.

  • regionstring

    DE

    Code de région à deux lettres de la Commercial Content Library de TikTok, comme DE, FR, GB ou IT. Chaque région contient un ensemble d’annonces différent. Omettez-le pour prendre la région par défaut de la bibliothèque, DE. La couverture est l’UE et l’EEE ; un code hors UE comme US n’est pas servi.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

each addata.ads[]

Populated whenever the provider has data for the entity.

  • adIdstring

    7648493525660270600

    TikTok ad id. Populated whenever the provider has data for the entity.

  • adTitlestring

    Spotify Premium: 3 months free

    Ad title as shown in TikTok's ad library. Populated whenever the provider has data for the entity.

  • brandNamestring

    Spotify

    Advertiser name on the ad.

  • coverUrlstring

    https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-cover.jpeg

    Cover image URL of the ad's first video. Populated whenever the provider has data for the entity.

  • estimatedAudiencestring

    500K-1M

    Audience size band TikTok publishes for the ad, for example "100K-200K".

  • firstShownUtcinteger

    1758067200

    UTC epoch timestamp in seconds (Unix time) when TikTok first showed the ad. Multiply by 1000 for a JS Date in milliseconds.

  • formatstring

    video

    TikTok's creative format code for the ad, as the ad library reports it.

  • lastShownUtcinteger

    1758931200

    UTC epoch timestamp in seconds (Unix time) when TikTok last showed the ad. Multiply by 1000 for a JS Date in milliseconds.

  • statusstring

    active

    TikTok's audit status code for the ad, as the ad library reports it.

  • urlstring

    https://library.tiktok.com/ads/detail?ad_id=7648493525660270600&region=DE

    Link to the ad's detail page in TikTok's public Ads Library.

  • videoUrlstring

    https://p16-ads-sign-useast8.tiktokcdn.com/obj/ad-video/7648493525660270600~tplv-ad-video.mp4

    Playable URL of the ad's first video. Populated whenever the provider has data for the entity.

datadata
  • hasMoreboolean

    true

  • nextCursorstring

    eyJvZmZzZXQiOjIwfQ==

    Opaque cursor for the next page of ads, or null when this lane has no more. Pass it back as cursor to continue.

  • totalinteger

    46

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API TikTok Recherche dans la bibliothèque publicitaire

L’API TikTok Recherche dans la bibliothèque publicitaire d’AnyAPI renvoie des données TikTok en JSON normalisé à partir d’un appel POST à /v1/run/tiktok.ad_library_search. Cherchez dans l’Ads Library publique de TikTok par mot-clé ou annonceur (annonceur, titre, tranche d’audience, dates de diffusion, lien de la bibliothèque et vidéo). AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,80 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 97,5% des appels TikTok Recherche dans la bibliothèque publicitaire passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,4 secondes, sur 27 870 appels mesurés.

Elle coûte à partir de 0,80 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Cherchez dans l’Ads Library publique de TikTok par mot-clé ou annonceur (annonceur, titre, tranche d’audience, dates de diffusion, lien de la bibliothèque et vidéo). La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 97,5% des appels TikTok Recherche dans la bibliothèque publicitaire passés par AnyAPI ont réussi, avec un temps de réponse médian de 2,4 secondes, sur 27 870 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 125 appels TikTok Recherche dans la bibliothèque publicitaire à 0,0008 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/tiktok.ad_library_search avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.
À appeler aussi

Autres endpoints TikTok

Profilà partir de 0,39 $US /1k reqVidéos du profilà partir de 0,40 $US /1k reqTranscription de la vidéoà partir de 1,10 $US /1k reqRecherche par mot-cléà partir de 0,60 $US /1k reqVidéoà partir de 0,40 $US /1k reqCommentaires de la vidéoà partir de 0,60 $US /1k reqRecherche d’utilisateursà partir de 0,60 $US /1k reqAnnonce de la bibliothèque publicitaireà partir de 1,20 $US /1k reqRecherche de transparence publicitaireà partir de 0,80 $US /1k reqDonnées démographiques de l’audienceà partir de 16,00 $US /1k reqRéponses aux commentairesà partir de 0,60 $US /1k reqAbonnésà partir de 0,80 $US /1k reqAbonnementsà partir de 0,80 $US /1k reqVidéos d’un hashtagà partir de 1,20 $US /1k reqEn directà partir de 1,20 $US /1k reqPhotosà partir de 1,20 $US /1k reqVidéos de la playlistà partir de 1,20 $US /1k reqContact du profilà partir de 0,96 $US /1k reqPlaylists du profilà partir de 1,20 $US /1k reqRégion du profilà partir de 1,20 $US /1k reqRepublications du profilà partir de 1,20 $US /1k reqRecherche de hashtagà partir de 1,20 $US /1k reqRecherche de photosà partir de 1,80 $US /1k reqSuggestions de rechercheà partir de 0,80 $US /1k reqRecherche des meilleurs résultatsà partir de 0,60 $US /1k reqMorceauà partir de 0,60 $US /1k reqVidéos du morceauà partir de 0,60 $US /1k reqRecherche des meilleures annoncesà partir de 1,20 $US /1k reqFlux tendanceà partir de 0,80 $US /1k reqHashtags tendanceà partir de 1,20 $US /1k reqUser storiesà partir de 1,10 $US /1k reqTéléchargement de la vidéoà partir de 0,80 $US /1k reqTranscription complète de la vidéoà partir de 5,94 $US /1k minutes audio