For AI

Ad library search API

4 endpoints on 3 platforms return the same Ad object. The ads of a public ad library that match a keyword. Every call costs $0.0020; a failed call is free.

Run it in the PlaygroundSee the callSign in to run it; it runs on your own balance.
Platforms3 platforms
Endpoints4 endpointssome platforms have more than one
PriceFrom $0.0020per call. A failed call is free
ReturnsAd12 to 30 a page, with a cursor for the next

Ad library search on each platform

One row per endpoint: what it is called, how much comes back in a call, and what a call costs.

PlatformEndpointA pageReturnsPrice
TikTokTikTok Ads Library searchGET/v1/tiktok/ads/search12Ad list$0.0020
TikTokTikTok Creative Center Top Ads searchGET/v1/tiktok/creative_center/ads/search20Ad list$0.0020
LinkedInLinkedIn Ad Library searchGET/v1/linkedin/ads/search24Ad list$0.0020
Meta Ad LibraryMeta Ad Library searchGET/v1/meta/ads/search30Ad list$0.0020
Prices are the prices in force. A call that fails, or whose result is uncertain, costs nothing.Live status →

The Ad object

Every endpoint above returns these fields, with the same names and types.

The object's own page →
idtextID; pass it unchanged to the ad's get endpoint
urllinkThe ad's page in the platform's ad library
formattextFormat of the creative; other is a format of the platform's own
titletextHeadline
texttextBody text
landing_urllinkWhere a click on the ad leads
advertiser.idtextAdvertiser ID
advertiser.nametextAdvertiser's name
advertiser.urllinkThe advertiser's page on the platform
advertiser.avatar_urllinkThe advertiser's picture or logo
imageslist of linkAddresses of the ad's images
videoslist of linkAddresses of the ad's videos; they expire
first_shown_attimeWhen the ad was first shown
last_shown_attimeWhen the ad was last shown; for an ad still running, when the platform last saw it

Which platform fills which field

A field an endpoint cannot give is listed in meta.unavailable on every answer, so a gap is never a surprise.

Platformtitletextlanding_urladvertiser.idadvertiser.urladvertiser.avatar_urlimagesfirst_shown_atlast_shown_at
TikTok Ads Library search
TikTok Creative Center Top Ads search
LinkedIn
Meta Ad Library

The same call on two platforms

Same parameter names, same paging, same answer. Only the path changes.

# TikTok
curl -G "https://api.dataxapi.com/v1/tiktok/ads/search" \
  --data-urlencode "query=running shoes" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# LinkedIn: one word changes
curl -G "https://api.dataxapi.com/v1/linkedin/ads/search" \
  --data-urlencode "query=cloud security" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"
// TikTok
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.tiktok.ads.search({ query: "running shoes" });
console.log(result.data.items);

// LinkedIn: one word changes
const other = await dx.linkedin.ads.search({ query: "cloud security" });
console.log(other.data.items);
# TikTok
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.tiktok.ads.search(query="running shoes")
print(result["data"]["items"])

# LinkedIn: one word changes
other = dx.linkedin.ads.search(query="cloud security")
print(other["data"]["items"])
# TikTok
dataxapi call tiktok.ads.search 'query=running shoes'

# LinkedIn: one word changes
dataxapi call linkedin.ads.search 'query=cloud security'
200 · application/json · charged $0.0020
{
  "code": "ok",
  "request_id": "4027347a-c186-4fd2-b351-135ff44aaeaf",
  "data": {
    "items": [
      {
        "id": "1886449558577687",
        "url": "https://library.tiktok.com/ads/detail/?ad_id=1886449558577687",
        "format": null,
        "title": "Start running shoes with the kit made for beginners",
        "advertiser": { "id": null, "name": "Brightline Studio" },
        "images": [],
        "first_shown_at": "2026-09-29T00:00:00.000Z",
        "last_shown_at": "2026-09-30T00:00:00.000Z"
      },
      // … 11 more
    ]
  },
  "page": {
    "next_cursor": "c1.QHmJKPGo-4D_X_E5o958QhS78uUkRXNlMJwkTH1J",
    "cursor_expires_at": "2026-10-12T23:12:45.000Z",
    "has_more": true,
    "returned": 12
  },
  "warnings": [],
  "meta": {
    "capability": "tiktok.ads.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T22:12:45.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": {
      "text": "capability",
      "landing_url": "capability",
      "advertiser.url": "platform",
      "advertiser.avatar_url": "platform"
    },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}

TikTok Ads Library search: From a response recorded 2026-10-12 22:12 UTC. Names, text and IDs are examples, and so are the links: none is the recorded one (the page shows no one's personal data); the figures are as recorded. Long lists are cut. The request ID, cursor and balance are made up.

Ready to use

Skills your AI can run on these endpoints, with what one run costs, and the objects every answer comes back as.

All skills →

Questions about the Ad library search API

Short answers. Each endpoint's page has its own limits and examples.

TikTok Ads Library search API →
How much does it cost?

$0.0020 a call on TikTok, LinkedIn, Meta Ad Library. You are charged when data comes back; a failed call costs nothing. No subscription, no monthly minimum.

How do I get every page?

Pass page.next_cursor back as cursor until page.has_more is false. Each page is one call at the same price.

Does every platform fill every field?

No. 9 of the 14 fields are missing on at least one platform; the table on this page says which. A field an endpoint cannot give is named in meta.unavailable on every answer, never filled with a guess.

Do I need an account on the platform?

No. One DataXAPI key reads all 3 platforms. No platform account and no cookie.

Other data types

The same idea everywhere: one action, every platform that has it.

Start with one key.

207 endpoints on 21 platforms, from $0.0003 a call. Errors and timeouts are not charged.

Start free