# TikTok Ad Library Search API. Ads matching your search.

Ads by keyword or advertiser, with reach. We handle the proxies, blocks and platform changes.

[Get API key](https://socialtap.dev/signup/?next=%2Fplayground%2F%3Fendpoint%3Dtiktok.search_ads)

## TikTok Ad Library Search API at a glance

Searches TikTok's public ad library, which holds ads shown in Europe, by keyword, exact phrase or advertiser, a page at a time. Each ad has its advertiser, text, media, the days it ran, reach, topic and any takedown. Filter by country, active or inactive and date, and sort by relevance, newest, oldest or popularity.

GET `/v1/tiktok/search_ads`

[Read the API reference](https://socialtap.dev/docs/reference/tiktok/search_ads/index.md)

- **1 credit** per page, $0.75–$1.97 per 1,000 pages
- **20 typed fields** null when unknown
- **12** ads per page, relevance (keywords) or newest
- **`query`** is all it needs, e.g. `coffee`

## Send one request. Get up to 12 ads 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`

`query = coffee`

[Open in playground](https://socialtap.dev/playground/?endpoint=tiktok.search_ads)

cURL:

```shell
curl 'https://socialtap.dev/v1/tiktok/search_ads?query=coffee' \
  -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.searchAds.list({ query: "coffee" });
console.log(res.data);
console.log(res.credits.charged, res.meta.request_id);
```

Node.js (fetch):

```javascript
const params = new URLSearchParams({
  query: "coffee",
});
const res = await fetch(`https://socialtap.dev/v1/tiktok/search_ads?${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, page, meta } = body;
console.log(data, meta.credits_charged);
```

Python (requests):

```python
import os

import requests

res = requests.get(
    "https://socialtap.dev/v1/tiktok/search_ads",
    params={"query": "coffee"},
    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, page, meta = body["data"], body["page"], 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("query", "coffee")
	req, err := http.NewRequest("GET", "https://socialtap.dev/v1/tiktok/search_ads?"+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"`
		Page  json.RawMessage `json:"page"`
		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": null,
        "display_name": "raisedinluxury",
        "id": null,
        "is_verified": null,
        "url": null,
        "username": null
      },
      "approximate_fields": [
        "first_shown_at",
        "last_shown_at",
        "reach"
      ],
      "audience_size": null,
      "country_codes": [],
      "creatives": [
        {
          "body": "Mushroom coffee #coffee",
          "cta_text": null,
          "link_description": null,
          "link_url": null,
          "media": [
            {
              "alt_text": null,
              "duration_ms": null,
              "expires_at": null,
              "height": null,
              "thumbnail_url": "https://p16-common-sign.tiktokcdn.com/tos-alisg-p-37c799-sg/o8UknFBVVDq0iQCOhAzGAS2tQfwxmfEEd3QRkE~tplv-noop.image?dr=18692&refresh_token=d75541c5&x-expires=4070908800&x-signature=SCRUBBED&t=9276707c&ps=14f1eb3e&shp=9e36835a&shcp=0c75dd76&idc=sg1&VideoID=v15025gf0000da547cfog65jp…",
              "type": "video",
              "url": "https://library.tiktok.com/api/v1/cdn/1793574003/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS8yNzFmNGQ5MDI5ZjE0Y2M0M2IxYTU4MWNlNGZjN2EyZi82YWU4MThlNy92aWRlby90b3MvYWxpc2cvdG9zLWFsaXNnLXZlLTM3Yzc5OS1zZy9vWUlyUktBMVJSS1FIaVdvelNxQjlBUUJxNGlmQVl6VUlFRURpUy8=/e4ffaaa5-2a8f-4350-8715-b93e…",
              "width": null
            }
          ],
          "title": null
        }
      ],
      "first_shown_at": "2026-08-23T00:00:00Z",
      "id": "1874320211952658",
      "impressions": null,
      "is_active": null,
      "is_political": null,
      "languages": [],
      "last_shown_at": "2026-08-23T00:00:00Z",
      "paid_by": null,
      "platform": "tiktok",
      "platform_specific": {
        "tiktok": {
          "advertiser_business_id": null,
          "advertiser_registry_location": null,
          "budget": null,
          "category": null,
          "ctr_top_percent": null,
          "is_removed": false,
          "like_count": null,
          "objective": null,
          "rank": null,
          "removal_country_codes": [],
          "removal_reasons": [],
          "targeting": null
        }
      },
      "publisher_platforms": [
        "tiktok"
      ],
      "reach": {
        "lower_bound": 0,
        "upper_bound": 1000
      },
      "spend": null,
      "type": "video",
      "unknown_fields": [
        "country_codes"
      ],
      "url": "https://library.tiktok.com/ads/detail/?ad_id=1874320211952658"
    },
    {
      "advertiser": {
        "avatar_url": null,
        "display_name": "Manea Coffee",
        "id": null,
        "is_verified": null,
        "url": null,
        "username": null
      },
      "approximate_fields": [
        "first_shown_at",
        "last_shown_at",
        "reach"
      ],
      "audience_size": null,
      "country_codes": [],
      "creatives": [
        {
          "body": "Caja de muestras | Manea Coffee",
          "cta_text": null,
          "link_description": null,
          "link_url": null,
          "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/o0QMomDeZefhMFgshsbGeqxAQBA4NRQIDA8W2C~tplv-tiktokx-origin.jpeg?dr=14582&refresh_token=3d9c5080&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/1793574003/video/aHR0cHM6Ly92NzcudGlrdG9rY2RuLmNvbS84NjM5ZjgxN2VlZTkzMzk2N2U2YjgzNjY3YzE3ZGNlNy82YWU4MThmNi92aWRlby90b3MvdXNlYXN0MmEvdG9zLXVzZWFzdDJhLXZlLTAwNTFjNzk5LWV1dHRwL293VEF3Q0VRZDRERWJGQUl0V0xWRnNtRGZ2Z1FnVUVHaGZJZkI3Lw==/2683c39b-6f1…",
              "width": null
            }
          ],
          "title": null
        }
      ],
      "first_shown_at": "2026-06-08T00:00:00Z",
      "id": "1867421334452290",
      "impressions": null,
      "is_active": null,
      "is_political": null,
      "languages": [],
      "last_shown_at": "2026-06-19T00:00:00Z",
      "paid_by": null,
      "platform": "tiktok",
      "platform_specific": {
        "tiktok": {
          "advertiser_business_id": null,
          "advertiser_registry_location": null,
          "budget": null,
          "category": null,
          "ctr_top_percent": null,
          "is_removed": false,
          "like_count": null,
          "objective": null,
          "rank": null,
          "removal_country_codes": [],
          "removal_reasons": [],
          "targeting": null
        }
      },
      "publisher_platforms": [
        "tiktok"
      ],
      "reach": {
        "lower_bound": 1000,
        "upper_bound": 10000
      },
      "spend": null,
      "type": "video",
      "unknown_fields": [
        "country_codes"
      ],
      "url": "https://library.tiktok.com/ads/detail/?ad_id=1867421334452290"
    },
    {
      "advertiser": {
        "avatar_url": null,
        "display_name": "Manea Coffee",
        "id": null,
        "is_verified": null,
        "url": null,
        "username": null
      },
      "approximate_fields": [
        "first_shown_at",
        "last_shown_at",
        "reach"
      ],
      "audience_size": null,
      "country_codes": [],
      "creatives": [
        {
          "body": "Caja de muestras | Manea Coffee",
          "cta_text": null,
          "link_description": null,
          "link_url": null,
          "media": [],
          "title": null
        }
      ],
      "first_shown_at": "2026-06-08T00:00:00Z",
      "id": "1867423264630914",
      "impressions": null,
      "is_active": null,
      "is_political": null,
      "languages": [],
      "last_shown_at": "2026-06-09T00:00:00Z",
      "paid_by": null,
      "platform": "tiktok",
      "platform_specific": {
        "tiktok": {
          "advertiser_business_id": null,
          "advertiser_registry_location": null,
          "budget": null,
          "category": null,
          "ctr_top_percent": null,
          "is_removed": false,
          "like_count": null,
          "objective": null,
          "rank": null,
          "removal_country_codes": [],
          "removal_reasons": [],
          "targeting": null
        }
      },
      "publisher_platforms": [
        "tiktok"
      ],
      "reach": {
        "lower_bound": 0,
        "upper_bound": 1000
      },
      "spend": null,
      "type": "image",
      "unknown_fields": [
        "country_codes"
      ],
      "url": "https://library.tiktok.com/ads/detail/?ad_id=1867423264630914"
    }
  ],
  "page": {
    "has_more": true,
    "next_cursor": "c1.EXAMPLE_CURSOR",
    "next_cursor_expires_at": "2026-10-26T12:00:00Z",
    "end_reason": null
  },
  "meta": {
    "request_id": "req_3f9c2a7d1e8b4c6a9f0e2d4b6a8c0e1f",
    "platform": "tiktok",
    "source": "api",
    "is_cached": false,
    "credits_charged": 1,
    "latency_ms": 2510,
    "fetched_at": "2026-10-25T12:00:00Z",
    "input": null,
    "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/search_ads/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

  Keywords, a "quoted phrase", or (search_by=advertiser) an advertiser's name.
- ### 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 Search API.

- ### Monitor competitors' TikTok ads
- ### List an advertiser's ads in Europe
- ### Find ads TikTok took down

## 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.
- is_active is set only when you filter by status active or inactive, and is null otherwise.
- A page can hold fewer ads than limit while more follow, and ads TikTok ranks equally can be skipped or repeated across pages.

## 1 credit per page. 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/search_ads/index.md#pricing) · [How credits work](https://socialtap.dev/docs/credits/index.md)

| Source | Price per successful page | Per 1,000 pages |
| --- | --- | --- |
| 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 Search API.

More in the [API reference](https://socialtap.dev/docs/reference/tiktok/search_ads/index.md).

**Can I search ads shown in the US?**

No. TikTok's ad library holds only ads shown in Europe. For the US and other markets, the TikTok Top Ads API returns Creative Center's best-performing ads by country.

**How much does the TikTok Ad Library Search API cost?**

A page of up to 12 ads costs 1 credit. Every successful page is charged, empty pages included. SocialTap credits cost $0.75–$1.97 per 1,000, depending on the plan or pack.

**How do I get the next page?**

Repeat the same request with cursor set to page.next_cursor from the previous response, keeping the other parameters. When page.has_more is false there are no more pages. Cursors expire after 24 hours.

Other platforms

## Ads on 3 more platforms.

- [Facebook Ad Library Search API](https://socialtap.dev/apis/facebook/search_ads/index.md) (1 credit / page · `GET /v1/facebook/search_ads`)
- [Google Ads Transparency Center Ads by Website API](https://socialtap.dev/apis/google/search_ads/index.md) (1 credit / page · `GET /v1/google/search_ads`)
- [LinkedIn Ad Library Search API](https://socialtap.dev/apis/linkedin/search_ads/index.md) (1 credit / page · `GET /v1/linkedin/search_ads`)

More TikTok Ad Library

## TikTok Ad Library API. 3 endpoints, one key.

- [TikTok Ad Library Ad API](https://socialtap.dev/apis/tiktok/ad/index.md) (1 credit · `GET /v1/tiktok/ad`)
- [TikTok Top Ads API](https://socialtap.dev/apis/tiktok/top_ads/index.md) (1 credit / page · `GET /v1/tiktok/top_ads`)

## Try it with your own search.

Type 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/search_ads/) · [Docs index for AI agents](https://socialtap.dev/llms.txt) · [All docs in one file](https://socialtap.dev/llms-full.txt)