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.
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.
The Ad object
Every endpoint above returns these fields, with the same names and types.
idtextID; pass it unchanged to the ad's get endpointurllinkThe ad's page in the platform's ad libraryformattextFormat of the creative; other is a format of the platform's owntitletextHeadlinetexttextBody textlanding_urllinkWhere a click on the ad leadsadvertiser.idtextAdvertiser IDadvertiser.nametextAdvertiser's nameadvertiser.urllinkThe advertiser's page on the platformadvertiser.avatar_urllinkThe advertiser's picture or logoimageslist of linkAddresses of the ad's imagesvideoslist of linkAddresses of the ad's videos; they expirefirst_shown_attimeWhen the ad was first shownlast_shown_attimeWhen the ad was last shown; for an ad still running, when the platform last saw itWhich 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.
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'
{
"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.
Ad creatives
“What ads are competitors running?”
The Ad object
What every field means, which number each platform puts in it, and where it is missing.
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.