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.

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

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

GET /v1/tiktok/adTry in

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);

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"])

require "json"
require "net/http"

uri = URI("https://socialtap.dev/v1/tiktok/ad")
uri.query = URI.encode_www_form('url' => 'https://library.tiktok.com/ads/detail/?ad_id=1874500065342865')
req = Net::HTTP::Get.new(uri)
req["x-api-key"] = ENV.fetch("SOCIALTAP_API_KEY")
res = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") { |http| http.request(req) }
body = JSON.parse(res.body)
raise "#{body["error"]["code"]}: #{body["error"]["message"]}" unless res.is_a?(Net::HTTPSuccess)
pp body["data"]
puts body["meta"]["credits_charged"]

<?php

$query = http_build_query([
    'url' => 'https://library.tiktok.com/ads/detail/?ad_id=1874500065342865',
]);
$ch = curl_init('https://socialtap.dev/v1/tiktok/ad?' . $query);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['x-api-key: ' . getenv('SOCIALTAP_API_KEY')],
]);
$body = json_decode(curl_exec($ch), true);
if (curl_getinfo($ch, CURLINFO_RESPONSE_CODE) >= 400) {
    throw new RuntimeException($body['error']['code'] . ': ' . $body['error']['message']);
}
print_r($body['data']);
echo $body['meta']['credits_charged'], PHP_EOL;

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

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"

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

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);

import java.net.URI;
import java.net.URLEncoder;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;

public class Main {
    public static void main(String[] args) throws Exception {
        String query = "url=" + encode("https://library.tiktok.com/ads/detail/?ad_id=1874500065342865");
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://socialtap.dev/v1/tiktok/ad?" + query))
            .header("x-api-key", System.getenv("SOCIALTAP_API_KEY"))
            .GET()
            .build();
        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        // An error is {"error": {"code", "message", ...}}; success is {data, meta}, meta.credits_charged its price.
        if (response.statusCode() >= 400) throw new RuntimeException(response.body());
        System.out.println(response.body());
    }

    static String encode(String value) {
        return URLEncoder.encode(value, StandardCharsets.UTF_8);
    }
}

using System.Text.Json;

using var http = new HttpClient();
http.DefaultRequestHeaders.Add("x-api-key", Environment.GetEnvironmentVariable("SOCIALTAP_API_KEY"));

var query = string.Join("&",
    "url=" + Uri.EscapeDataString("https://library.tiktok.com/ads/detail/?ad_id=1874500065342865"));
var res = await http.GetAsync("https://socialtap.dev/v1/tiktok/ad?" + query);
using var body = JsonDocument.Parse(await res.Content.ReadAsStringAsync());
if (!res.IsSuccessStatusCode)
{
    var error = body.RootElement.GetProperty("error");
    throw new Exception($"{error.GetProperty("code")}: {error.GetProperty("message")}");
}
Console.WriteLine(body.RootElement.GetProperty("data"));
Console.WriteLine(body.RootElement.GetProperty("meta").GetProperty("credits_charged"));

// Cargo.toml: reqwest = { version = "0.12", features = ["blocking", "json"] }, serde_json = "1"
use std::env;

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let res = reqwest::blocking::Client::new()
        .get("https://socialtap.dev/v1/tiktok/ad")
        .query(&[("url", "https://library.tiktok.com/ads/detail/?ad_id=1874500065342865")])
        .header("x-api-key", env::var("SOCIALTAP_API_KEY")?)
        .send()?;
    let ok = res.status().is_success();
    let body: serde_json::Value = res.json()?;
    if !ok {
        return Err(format!("{}: {}", body["error"]["code"], body["error"]["message"]).into());
    }
    println!("{} {}", body["data"], body["meta"]["credits_charged"]);
    Ok(())
}

200 OK · GET https://socialtap.dev/v1/tiktok/adLong arrays and strings are shortened here. Real responses are complete.Docs

One schema on 4 platforms.

The response reference lists every field, its type and when it is null. See the full schema.

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.

platformstring: Library owner's platform ID (facebook for Meta's library, tiktok, google, linkedin).
idstring: Library ad ID (string).
urlstring: Public library page of the ad.
advertiserobject: The advertising page, business or account.
paid_bystring: Disclosed payer ("Paid for by").
is_activeboolean: True while the ad is running.
first_shown_atstring: First delivery, RFC 3339 UTC (often date-only: see approximate_fields).
last_shown_atstring: Last delivery, RFC 3339 UTC; null while active.

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 How this endpoint is priced How credits work

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.

Try it on a link you already have.

Paste it in the playground, or copy the request into your code.

free credits

No credit card
Failed requests are free
Works on all 218 endpoints

Start for free Read the docs

TikTok Ad Library Ad API. Send an ad link or ID.

TikTok Ad Library Ad API at a glance

Send one request. Get 20 fields back.

One schema on 4 platforms.

Null means unknown

What it accepts

Write one parser

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.

1 credit per request. Failed requests are free.

Questions about the TikTok Ad Library Ad API.

Ads on 3 more platforms.

TikTok Ad Library API. 3 endpoints, one key.

Try it on a link you already have.