---
title: "Search the TikTok Ad Library"
method: GET
path: "/v1/tiktok/ads/search"
tags: ["TikTok Ads"]
---

# Search the TikTok Ad Library

`GET /v1/tiktok/ads/search`

Search TikTok's Commercial Content Library (EU Digital Services Act ad transparency) by keyword or advertiser id. EU regions only.

## Query parameters

- `query` string
- `advertiser_id` string
- `region` string
- `days` integer
- `sort` string
- `offset` integer
- `search_id` string
- `count` integer

## Response `200`

Ad Library results

- AdLibrarySearchResponse
  - `ads` TikTokAd[]
    - `id` string, required
    - `name` string — Advertiser name.
    - `audit_status` string
    - `type` string
    - `first_shown_date` integer — Epoch milliseconds.
    - `last_shown_date` integer — Epoch milliseconds.
    - `videos` TikTokAdVideo[]
      - `video_url` string
      - `cover_img` string
  - `pagination` AdLibraryPage, required — Pagination metadata for Ad Library search.
    - `has_more` boolean
    - `total` integer
    - `search_id` string — Pass to the next page request.
    - `offset` integer
  - `region` string, required

---

[API](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api.md) · [All operations](https://skmtc.net/scrapebadger/apis/scrapebadger-account-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/scrapebadger/scrapebadger-account-api/revisions/4a1ef8777baf/schema)