DataNavoAPI / DOCS

Ad fields and sources

Ad fields and sources. Follow concrete contracts, examples and reviewable steps using Google Ads, LinkedIn, Meta Ad Library, TikTok.

LOCAL SIMULATIONAll displayed records are fictional fixtures. Live APIs, payments and external email are disabled.中文版 ↗
01

Object and null semantics

Ad (ad) is referenced by 11 capabilities across 4 platforms. Shared names help organize records; they do not guarantee identical data coverage.

Preserve identifiers as strings. Null, absent, zero and empty arrays mean different things. Fields under ext are platform extensions, not universal guarantees.

02

Complete field paths

Field facts come from the preserved public contracts. The table merges platform extensions and identifies the platforms whose contracts declare each field.

Field pathTypeRequirementDeclaring platforms
idstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
urlstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
formatstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
titlestring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
textstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
landing_urlstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
advertiserobject | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
advertiser.idstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
advertiser.namestring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
advertiser.urlstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
advertiser.avatar_urlstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
imagesarray | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
videosarray | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
first_shown_atstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
last_shown_atstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
approximatearray | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
approximate[].fieldstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
approximate[].kindstring | nullOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
extobjectOptional in contractGoogle Ads, LinkedIn, Meta Ad Library, TikTok
ext.regionsarray | nullOptional in contractGoogle Ads, TikTok
ext.impressions_mininteger | nullOptional in contractGoogle Ads
ext.impressions_maxinteger | nullOptional in contractGoogle Ads
ext.variationsarray | nullOptional in contractGoogle Ads
ext.variations[].titlestring | nullOptional in contractGoogle Ads
ext.variations[].textstring | nullOptional in contractGoogle Ads
ext.variations[].destinationstring | nullOptional in contractGoogle Ads
ext.variations[].image_urlstring | nullOptional in contractGoogle Ads
ext.variations[].video_urlstring | nullOptional in contractGoogle Ads
ext.format_labelstring | nullOptional in contractLinkedIn, Meta Ad Library
ext.ctastring | nullOptional in contractLinkedIn, Meta Ad Library
ext.impressions_rangestring | nullOptional in contractLinkedIn
ext.targeting_languagestring | nullOptional in contractLinkedIn
ext.targeting_locationstring | nullOptional in contractLinkedIn
ext.activeboolean | nullOptional in contractMeta Ad Library
ext.platformsobject | nullOptional in contractMeta Ad Library
ext.platforms.facebookboolean | nullOptional in contractMeta Ad Library
ext.platforms.instagramboolean | nullOptional in contractMeta Ad Library
ext.platforms.messengerboolean | nullOptional in contractMeta Ad Library
ext.platforms.audience_networkboolean | nullOptional in contractMeta Ad Library
ext.platforms.threadsboolean | nullOptional in contractMeta Ad Library
ext.platforms.whatsappboolean | nullOptional in contractMeta Ad Library
ext.cardsarray | nullOptional in contractMeta Ad Library
ext.cards[].titlestring | nullOptional in contractMeta Ad Library
ext.cards[].textstring | nullOptional in contractMeta Ad Library
ext.cards[].landing_urlstring | nullOptional in contractMeta Ad Library
ext.cards[].image_urlstring | nullOptional in contractMeta Ad Library
ext.cards[].video_urlstring | nullOptional in contractMeta Ad Library
ext.likesinteger | nullOptional in contractTikTok
ext.commentsinteger | nullOptional in contractTikTok
ext.sharesinteger | nullOptional in contractTikTok
ext.durationnumber | nullOptional in contractTikTok
ext.cover_urlstring | nullOptional in contractTikTok
ext.objectivestring | nullOptional in contractTikTok
ext.audience_rangestring | nullOptional in contractTikTok
ext.categorystring | nullOptional in contractTikTok
ext.industrystring | nullOptional in contractTikTok
03

Capabilities returning this object

CapabilityObjectShapePagination
google.ads.getAditemNo cursor
google.advertisers.ads.listAditemsExplicit cursor
linkedin.ads.getAditemNo cursor
linkedin.ads.searchAditemsExplicit cursor
meta.ads.getAditemNo cursor
meta.ads.searchAditemsExplicit cursor
meta.advertisers.ads.listAditemsExplicit cursor
tiktok.ads.searchAditemsExplicit cursor
tiktok.ads.getAditemNo cursor
tiktok.creative_center.ads.getAditemNo cursor
tiktok.creative_center.ads.searchAditemsExplicit cursor
TRY THE CONTRACT

Clear inputs. Inspectable output.

Each click runs a local fixture. Advanced JSON inputs are checked against the selected method. Editing does not execute a request.

Copying does not execute. CLI quote is read-only and needs a local customer TEST key. Configure MCP in demo mode first. GET and POST batches both return only fictional local fixtures.

Download contract example (no execution) ↗

For TEST budgets, Key scopes or failure scenarios, open the account console. Customer sandbox ↗