API de TikTok

API de TikTok: Búsqueda en la biblioteca de anuncios

Busca en la biblioteca pública de anuncios de TikTok por palabra clave o anunciante (anunciante, título, rango de audiencia, fechas de publicación, enlace a la biblioteca y video).

Empieza gratisDescargar muestrao JSON

US$0.80/1k solic., pagas por solicitud, sin suscripción.

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

Lo que devolvió la APIads[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 campos más
}
Disponibilidad
98.13%
30d · 16,370 llamadas
Solicitudes
16,373
30d · semanal, últimas 12 sem.
Respuesta
2.1s
mediana · 30d

Precios y proveedores

Precios del endpoint Búsqueda en la biblioteca de anuncios de la API de TikTok: una API, 2 proveedores intercambiables

El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.

Pagas
US$8.00
US$0.80/1k solic., solo por lo que usas. Sin plan mensual.
Tus primeras 125 solicitudes son gratis con el saldo inicial de US$0.10.

Pruébalo

Obtén Búsqueda en la biblioteca de anuncios de TikTok en una sola solicitud

Abrir en
Obtén una clave gratis
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

Este ejemplo muestra 17 de 18 campos. Ver todos los campos

{
  "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"
      }
    ]
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • advertiserNamestring

    Nombre del anunciante cuyos anuncios quieres listar (p. ej., Spotify). Indica advertiserName o query, nunca ambos.

  • cursorstring

    Cursor opaco del nextCursor de una respuesta anterior. Omítelo para la primera página.

  • querystring

    spotify

    Palabra clave para buscar en los títulos y el contenido de los anuncios (p. ej., spotify). Indica query o advertiserName, nunca ambos.

  • regionstring

    DE

    Código de región de dos letras de la Commercial Content Library de TikTok, como DE, FR, GB o IT. Cada región contiene un conjunto distinto de anuncios. Omítelo para usar la región predeterminada de la propia biblioteca, DE. La cobertura es la UE y el EEE; un código fuera de la UE, como US, no se atiende.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

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.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Búsqueda en la biblioteca de anuncios de la API de TikTok

El endpoint Búsqueda en la biblioteca de anuncios de AnyAPI para TikTok devuelve datos de TikTok como JSON normalizado con una sola llamada POST a /v1/run/tiktok.ad_library_search. Busca en la biblioteca pública de anuncios de TikTok por palabra clave o anunciante (anunciante, título, rango de audiencia, fechas de publicación, enlace a la biblioteca y video). AnyAPI enruta cada solicitud entre 2 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$0.80 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 98.1% de las llamadas al endpoint Búsqueda en la biblioteca de anuncios de la API de TikTok a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.1 segundos en 16.370 llamadas medidas.

Cuesta desde US$0.80 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca en la biblioteca pública de anuncios de TikTok por palabra clave o anunciante (anunciante, título, rango de audiencia, fechas de publicación, enlace a la biblioteca y video). La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 98.1% de las llamadas al endpoint Búsqueda en la biblioteca de anuncios de la API de TikTok a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.1 segundos en 16.370 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 125 llamadas a Búsqueda en la biblioteca de anuncios de TikTok a US$0.0008 cada una.

AnyAPI consulta la siguiente de sus 2 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/tiktok.ad_library_search con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.
Más para llamar

Otros endpoints de TikTok

Perfildesde US$0.40 /1k solic.Videos del perfildesde US$0.60 /1k solic.Transcripción del videodesde US$1.10 /1k solic.Búsqueda por palabra clavedesde US$0.60 /1k solic.Videodesde US$0.40 /1k solic.Comentarios del videodesde US$0.60 /1k solic.Búsqueda de usuariosdesde US$0.60 /1k solic.Anuncio de la biblioteca de anunciosdesde US$1.20 /1k solic.Búsqueda de transparencia de anunciosdesde US$0.80 /1k solic.Datos demográficos de la audienciadesde US$16.00 /1k solic.Respuestas a comentariosdesde US$0.60 /1k solic.Seguidoresdesde US$0.80 /1k solic.Seguidosdesde US$0.80 /1k solic.Videos de un hashtagdesde US$1.20 /1k solic.En vivodesde US$1.20 /1k solic.Fotosdesde US$1.20 /1k solic.Videos de una playlistdesde US$1.20 /1k solic.Contacto del perfildesde US$3.52 /1k solic.Playlists del perfildesde US$1.20 /1k solic.Región del perfildesde US$1.20 /1k solic.Reposts del perfildesde US$1.20 /1k solic.Buscar hashtagdesde US$1.20 /1k solic.Buscar fotosdesde US$1.20 /1k solic.Sugerencias de búsquedadesde US$0.80 /1k solic.Buscar resultados principalesdesde US$0.60 /1k solic.Cancióndesde US$0.60 /1k solic.Videos de una cancióndesde US$0.60 /1k solic.Búsqueda de anuncios destacadosdesde US$1.20 /1k solic.Feed de tendenciasdesde US$0.80 /1k solic.Hashtags en tendenciadesde US$1.20 /1k solic.User storiesdesde US$1.10 /1k solic.Descarga de videodesde US$0.80 /1k solic.Transcripción del video (completo)desde US$5.94 /1k minutos de audio