---
title: "TikTok ad library tools"
description: "Search the TikTok EU DSA public ad repository by registered advertiser name and fetch creative, landing page and country targeting per ad."
---

## search_tiktok_ads

| Parameter | Type | Notes |
| --- | --- | --- |
| `advertiser_name` | string | Exact match, case-sensitive |
| `cursor` | string | From the previous page |

:::note
`advertiser_name` must match the name registered with TikTok. "Anysphere" works; "Cursor" and "anysphere" return nothing. On zero results the assistant retries with the legal or parent company name.
:::

Covers EU-delivered ads only, but global brands advertising in the EU appear. Results carry first and last shown dates and a `has_more` cursor. Trust `has_more`, not `total`.

## get_tiktok_ad_details

| Parameter | Type | Notes |
| --- | --- | --- |
| `ad_id` | string or string[] | IDs from search, or library.tiktok.com URLs |

Returns body, `brand_name`, `video_url`, `cover`, `landing_page`, `country_code` and dates. `landing_page` is the most reliable brand signal. Signed media URLs expire in hours, so pass `tiktok_id` to [analyze_ad_video](/docs/tools/analysis#analyze_ad_video) instead of the URL.

## Credits

Search costs one credit per upstream page fetched, up to five per call (about 12 ads per page). Details cost one credit per ID.