# TikTok Ad Library Ad API. Send an ad link or ID. Targeting, reach by country and takedowns. We handle the proxies, blocks and platform changes. [Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.ad) ## TikTok Ad Library Ad API at a glance Returns one ad from TikTok's public ad library, which holds ads shown in Europe, from its library link or ad ID. You get the advertiser and its TikTok account, who paid, the text, media and landing page, the days it ran, reach by country, age and gender, its topic and objective, and any takedown with TikTok's reason. GET `/v1/tiktok/ad` [Read the API reference](https://socialtap.dev/docs/reference/tiktok/ad/index.md) - **1 credit** per request, $0.75–$1.97 per 1,000 requests - **20 typed fields** null when unknown - **`url`** is all it needs, e.g. `https://library.tiktok.com/ads/detail/?ad_id=1874500065342865` - **100 credits** free when you sign up, no card, so you can build before you spend ## Send one request. Get 20 fields back. Copy the request in your language, or hand it to your agent. Sign up for an API key and your first 100 credits are free. `$ npm install socialtap` `url = https://library.tiktok.com/ads/detail/?ad_id=1874500065342865` [Open in playground](https://socialtap.dev/playground/?endpoint=tiktok.ad) cURL: ```shell curl -G 'https://socialtap.dev/v1/tiktok/ad' \ --data-urlencode 'url=https://library.tiktok.com/ads/detail/?ad_id=1874500065342865' \ -H "x-api-key: $SOCIALTAP_API_KEY" ``` TypeScript SDK: ```typescript import { SocialTap } from "socialtap"; const client = new SocialTap(); // apiKey defaults to process.env.SOCIALTAP_API_KEY const res = await client.tiktok.ad.get({ url: "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865" }); console.log(res.data); console.log(res.credits.charged, res.meta.request_id); ``` Node.js (fetch): ```javascript const params = new URLSearchParams({ url: "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865", }); const res = await fetch(`https://socialtap.dev/v1/tiktok/ad?${params}`, { headers: { "x-api-key": process.env.SOCIALTAP_API_KEY ?? "" }, }); const body = await res.json(); if (!res.ok) throw new Error(`${body.error.code}: ${body.error.message}`); const { data, meta } = body; console.log(data, meta.credits_charged); ``` Python (requests): ```python import os import requests res = requests.get( "https://socialtap.dev/v1/tiktok/ad", params={"url": "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865"}, headers={"x-api-key": os.environ["SOCIALTAP_API_KEY"]}, ) body = res.json() if not res.ok: raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}") data, meta = body["data"], body["meta"] print(data, meta["credits_charged"]) ``` Go (net/http): ```go package main import ( "encoding/json" "fmt" "log" "net/http" "net/url" "os" ) func main() { q := url.Values{} q.Set("url", "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865") req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/ad?"+q.Encode(), nil) if err != nil { log.Fatal(err) } req.Header.Set("x-api-key", os.Getenv("SOCIALTAP_API_KEY")) res, err := http.DefaultClient.Do(req) if err != nil { log.Fatal(err) } defer res.Body.Close() var body struct { Data json.RawMessage `json:"data"` Meta map[string]any `json:"meta"` Error *struct { Code string `json:"code"` Message string `json:"message"` } `json:"error"` } if err := json.NewDecoder(res.Body).Decode(&body); err != nil { log.Fatal(err) } if body.Error != nil { log.Fatalf("%s: %s", body.Error.Code, body.Error.Message) } fmt.Println(string(body.Data), body.Meta["credits_charged"]) } ``` 200 OK: ```json { "data": { "advertiser": { "avatar_url": "https://p16-common-sign.tiktokcdn-eu.com/tos-useast2a-avt-0068-giso/376d42e4d2d431dde2bedc5acba5ac67~tplv-tiktokx-cropcenter:168:168.jpeg?dr=10397&refresh_token=45674133&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=a5d48078&shcp=8aecc5ac&idc=no1a", "display_name": "Hilti Deutschland AG", "id": "7084134349806142470", "is_verified": true, "url": "https://www.tiktok.com/@hiltideutschland", "username": "hiltideutschland" }, "approximate_fields": [ "audience_size", "first_shown_at", "last_shown_at" ], "audience_size": { "lower_bound": 2000, "upper_bound": 2000 }, "country_codes": [ "DE" ], "creatives": [ { "body": "Du baust unser Morgen. Danke für deinen Einsatz!", "cta_text": "Learn more", "link_description": null, "link_url": "https://www.hilti.de/content/landing-page/local/brand-thanks?cinfo=pro_all_all_all_mixed_na&utm_source=tiktok&utm_medium=paid_social&utm_campaign=regional_e3_de_de_ciab-brand-image_awareness_main&utm_term=_cid_&utm_content=awareness_15sekv2_video_in-feed_int_workers", "media": [ { "alt_text": null, "duration_ms": null, "expires_at": null, "height": null, "thumbnail_url": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-0051c001-sg/oYAcmEB9C43fo29cW0sko2kiAXziEB1IAIwAEp~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=fd54107a&x-expires=4070908800&x-signature=SCRUBBED&t=4d5b0474&ps=13740610&shp=0c75dd76&shcp=9b759fb9&idc=sg1", "type": "video", "url": "https://library.tiktok.com/api/v1/cdn/1793762729/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS80N2UzMzc2NDg0YmQ2NDRmYzYxMDFmYjJlNDQ0YjIzYi82YWVhZmExOC92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNTFjNzk5LWV1dHRwL293Y0JpQUFpSUlMek1tUXcwQ0JDcG9FM1pYOWtCZkZBb0ZtMWtXLw==/9cd6d7ed-99d…", "width": null } ], "title": null } ], "first_shown_at": "2026-09-01T00:00:00Z", "id": "1874500065342865", "impressions": null, "is_active": null, "is_political": false, "languages": [], "last_shown_at": "2026-11-02T00:00:00Z", "paid_by": "Hilti Germany AG", "platform": "tiktok", "platform_specific": { "tiktok": { "advertiser_business_id": "7417792849774788624", "advertiser_registry_location": "Germany", "budget": null, "category": "Home Improvement", "ctr_top_percent": null, "is_removed": false, "like_count": null, "objective": "Reach", "rank": null, "removal_country_codes": [], "removal_reasons": [], "targeting": { "cities": [], "countries": [ { "age_ranges": [ "18-24", "25-34" ], "breakdown": [ { "age_range": "18-24", "gender": "male", "reach": { "lower_bound": 59000, "upper_bound": 59000 } }, { "age_range": "18-24", "gender": "female", "reach": { "lower_bound": 94000, "upper_bound": 94000 } }, { "age_range": "18-24", "gender": "unknown", "reach": { "lower_bound": 0, "upper_bound": 1000 } } ], "country_code": "DE", "genders": [ "female", "male", "unknown" ], "reach": { "lower_bound": 313000, "upper_bound": 313000 } } ], "creator_interactions": [], "device_models": [], "interests": [ "Building" ], "is_audience_excluded": false, "is_custom_audience": false, "is_high_spending_power": false, "operating_systems": [], "provinces": [], "video_interactions": [] } } }, "publisher_platforms": [ "tiktok" ], "reach": { "lower_bound": 300000, "upper_bound": 400000 }, "spend": null, "type": "video", "unknown_fields": [], "url": "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865" }, "meta": { "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f", "platform": "tiktok", "source": "api", "is_cached": false, "credits_charged": 1, "latency_ms": 1293, "fetched_at": "2026-10-25T12:00:00Z", "input": { "kind": "ad", "id": "1874500065342865", "url": "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865" }, "credits_remaining": 9999, "client_request_id": null, "warnings": [] } } ``` Long arrays and strings are shortened here. Real responses are complete. ## One schema on 4 platforms. The [response reference](https://socialtap.dev/docs/reference/tiktok/ad/index.md#response) lists every field, its type and when it is `null`. [See the full schema](https://socialtap.dev/resources/ad/index.md). - ### Null means unknown A field TikTok Ad Library doesn't show is null, never zero or an empty string, so a real zero always means zero. - ### What it accepts The ad's TikTok Ad Library link (library.tiktok.com/ads/detail/?ad_id=…) or its ad ID. - ### Write one parser TikTok Ad Library, Facebook Ad Library, Google Ads Transparency Center and LinkedIn Ad Library answer in these fields, so the code that reads one reads them all. - **`platform`string**: Library owner's platform ID (facebook for Meta's library, tiktok, google, linkedin). - **`id`string**: Library ad ID (string). - **`url`string**: Public library page of the ad. - **`advertiser`object**: The advertising page, business or account. - **`paid_by`string**: Disclosed payer ("Paid for by"). - **`is_active`boolean**: True while the ad is running. - **`first_shown_at`string**: First delivery, RFC 3339 UTC (often date-only: see approximate_fields). - **`last_shown_at`string**: Last delivery, RFC 3339 UTC; null while active. Live data from 33 platforms. [TikTok](https://socialtap.dev/apis/tiktok/index.md) · [Instagram](https://socialtap.dev/apis/instagram/index.md) · [Facebook](https://socialtap.dev/apis/facebook/index.md) · [YouTube](https://socialtap.dev/apis/youtube/index.md) · [Reddit](https://socialtap.dev/apis/reddit/index.md) · [Threads](https://socialtap.dev/apis/threads/index.md) · [Spotify](https://socialtap.dev/apis/spotify/index.md) · [Amazon](https://socialtap.dev/apis/amazon/index.md) · [Apple Music](https://socialtap.dev/apis/applemusic/index.md) · [Pinterest](https://socialtap.dev/apis/pinterest/index.md) · [Rumble](https://socialtap.dev/apis/rumble/index.md) · [X](https://socialtap.dev/apis/x/index.md) · [Bluesky](https://socialtap.dev/apis/bluesky/index.md) · [Twitch](https://socialtap.dev/apis/twitch/index.md) · [LinkedIn](https://socialtap.dev/apis/linkedin/index.md) · [Telegram](https://socialtap.dev/apis/telegram/index.md) · [TikTok Shop](https://socialtap.dev/apis/tiktokshop/index.md) · [Kwai](https://socialtap.dev/apis/kwai/index.md) · [Snapchat](https://socialtap.dev/apis/snapchat/index.md) · [SoundCloud](https://socialtap.dev/apis/soundcloud/index.md) · [Truth Social](https://socialtap.dev/apis/truthsocial/index.md) · [Kick](https://socialtap.dev/apis/kick/index.md) · [Komi](https://socialtap.dev/apis/komi/index.md) · [Lnk.Bio](https://socialtap.dev/apis/linkbio/index.md) · [Linkme](https://socialtap.dev/apis/linkme/index.md) · [Linktree](https://socialtap.dev/apis/linktree/index.md) · [Pillar](https://socialtap.dev/apis/pillar/index.md) · [TikTok Ad Library](https://socialtap.dev/apis/tiktok-ad-library/index.md) · [Facebook Ad Library](https://socialtap.dev/apis/facebook-ad-library/index.md) · [Facebook Events](https://socialtap.dev/apis/facebook-events/index.md) · [Facebook Marketplace](https://socialtap.dev/apis/facebook-marketplace/index.md) · [Google Ads Transparency Center](https://socialtap.dev/apis/google-ads-transparency/index.md) · [LinkedIn Ad Library](https://socialtap.dev/apis/linkedin-ad-library/index.md) ## What teams build with the TikTok Ad Library Ad API. - ### See whom a competitor's TikTok ad targets - ### Check why TikTok took an ad down - ### Add targeting and reach to search results ## Good to know before you build. - The library holds only ads shown in the EU, EEA, Switzerland or UK, and shows no spend or impressions: reach counts unique users. - Reach figures are TikTok's rounded ranges. - is_active is null because the ad page shows no status, and last_shown_at says when the ad last ran. - Takedown reasons are in English, or in German when TikTok gives them only in German. ## 1 credit per request. Failed requests are free. Buy credits once and spend them on any endpoint, on any platform. [Plans and packs](https://socialtap.dev/pricing/index.md) · [How this endpoint is priced](https://socialtap.dev/docs/reference/tiktok/ad/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md) | Source | Price per successful request | Per 1,000 requests | | --- | --- | --- | | Platform API `api` | 1 credit | $0.75–$1.97 | - Cache hits are free. - Credits from packs and top-ups never expire. - A monthly plan's credits are spent first, and what is left of them ends at each renewal. - Prices exclude tax: sales tax is added at checkout where it applies. - Outside the US, plans and packs are sold to businesses: checkout asks for your VAT, GST or other business tax ID. ## Questions about the TikTok Ad Library Ad API. More in the [API reference](https://socialtap.dev/docs/reference/tiktok/ad/index.md). **How much does the TikTok Ad Library Ad API cost?** A request costs 1 credit. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack. Other platforms ## Ads on 3 more platforms. - [Facebook Ad Library Ad API](https://socialtap.dev/apis/facebook/ad/index.md) (1 credit · `GET /v1/facebook/ad`) - [Google Ads Transparency Center Ad API](https://socialtap.dev/apis/google/ad/index.md) (1 credit · `GET /v1/google/ad`) - [LinkedIn Ad Library Ad API](https://socialtap.dev/apis/linkedin/ad/index.md) (1 credit · `GET /v1/linkedin/ad`) More TikTok Ad Library ## TikTok Ad Library API. 3 endpoints, one key. - [TikTok Top Ads API](https://socialtap.dev/apis/tiktok/top_ads/index.md) (1 credit / page · `GET /v1/tiktok/top_ads`) - [TikTok Ad Library Search API](https://socialtap.dev/apis/tiktok/search_ads/index.md) (1 credit / page · `GET /v1/tiktok/search_ads`) ## Try it on a link you already have. Paste it in the playground, or copy the request into your code. 100free credits - No credit card - Failed requests are free - Works on all 218 endpoints [Start for free](https://socialtap.dev/signup/) [Read the docs](https://socialtap.dev/docs/index.md) --- [HTML version](https://socialtap.dev/apis/tiktok/ad/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)