Ad object
11 endpoints on 4 platforms return the Ad object with the same 14 fields, so code written for one platform reads the others unchanged. A call costs $0.0020. It is a preview structure and may still change.
An Ad is one ad as a platform's public ad library, or TikTok's Creative Center showcase, lists it: format, headline, text, images and videos, where it leads and who ran it, and in the libraries when it was first and last shown. Nothing in its standard fields says what the ad cost; impression ranges, engagement counts and targeting, where a platform gives them, are under ext.
advertiser names who ran it, with an id on the libraries that keep one, and an Advertiser found by name leads to its ads. What is said in a Meta Ad Library ad's video is its Transcript.
Fields
A field the platform cannot give is left out of the item and named in meta.unavailable. It is never filled with a guess or a zero.
ID; pass it unchanged to the ad's get endpoint
The ad's page in the platform's ad library
Format of the creative; other is a format of the platform's own: video image carousel text other
Headline
Body text
Where a click on the ad leads
Advertiser
Advertiser ID
Advertiser's name
The advertiser's page on the platform
The advertiser's picture or logo
Addresses of the ad's images
Addresses of the ad's videos; they expire
When the ad was first shown
When the ad was last shown; for an ad still running, when the platform last saw it
What a platform cannot give
A platform stands against a field when none of its endpoints gives it.
advertiser.urlTikTokGoogle Adsadvertiser.avatar_urlTikTokGoogle Adsmeta.unavailable.Endpoints that return Ad
The number beside each platform is how many of its endpoints return it.
Example
One item from tiktok.ads.search, as recorded 2026-10-12 22:12 UTC. Names, text, IDs and links are examples; the figures are as recorded.
{
"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"
}