# Ad fields and sources

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

Canonical page: https://datanavoapi.com/en/docs/objects/ad/

This is a local simulation. Program-generated samples are not live platform data and do not establish provider availability.

## 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.

## 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 path | Type | Requirement | Declaring platforms |

| --- | --- | --- | --- |

| id | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| url | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| format | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| title | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| text | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| landing_url | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| advertiser | object \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| advertiser.id | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| advertiser.name | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| advertiser.url | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| advertiser.avatar_url | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| images | array \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| videos | array \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| first_shown_at | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| last_shown_at | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| approximate | array \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| approximate[].field | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| approximate[].kind | string \| null | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| ext | object | Optional in contract | Google Ads, LinkedIn, Meta Ad Library, TikTok |

| ext.regions | array \| null | Optional in contract | Google Ads, TikTok |

| ext.impressions_min | integer \| null | Optional in contract | Google Ads |

| ext.impressions_max | integer \| null | Optional in contract | Google Ads |

| ext.variations | array \| null | Optional in contract | Google Ads |

| ext.variations[].title | string \| null | Optional in contract | Google Ads |

| ext.variations[].text | string \| null | Optional in contract | Google Ads |

| ext.variations[].destination | string \| null | Optional in contract | Google Ads |

| ext.variations[].image_url | string \| null | Optional in contract | Google Ads |

| ext.variations[].video_url | string \| null | Optional in contract | Google Ads |

| ext.format_label | string \| null | Optional in contract | LinkedIn, Meta Ad Library |

| ext.cta | string \| null | Optional in contract | LinkedIn, Meta Ad Library |

| ext.impressions_range | string \| null | Optional in contract | LinkedIn |

| ext.targeting_language | string \| null | Optional in contract | LinkedIn |

| ext.targeting_location | string \| null | Optional in contract | LinkedIn |

| ext.active | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms | object \| null | Optional in contract | Meta Ad Library |

| ext.platforms.facebook | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms.instagram | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms.messenger | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms.audience_network | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms.threads | boolean \| null | Optional in contract | Meta Ad Library |

| ext.platforms.whatsapp | boolean \| null | Optional in contract | Meta Ad Library |

| ext.cards | array \| null | Optional in contract | Meta Ad Library |

| ext.cards[].title | string \| null | Optional in contract | Meta Ad Library |

| ext.cards[].text | string \| null | Optional in contract | Meta Ad Library |

| ext.cards[].landing_url | string \| null | Optional in contract | Meta Ad Library |

| ext.cards[].image_url | string \| null | Optional in contract | Meta Ad Library |

| ext.cards[].video_url | string \| null | Optional in contract | Meta Ad Library |

| ext.likes | integer \| null | Optional in contract | TikTok |

| ext.comments | integer \| null | Optional in contract | TikTok |

| ext.shares | integer \| null | Optional in contract | TikTok |

| ext.duration | number \| null | Optional in contract | TikTok |

| ext.cover_url | string \| null | Optional in contract | TikTok |

| ext.objective | string \| null | Optional in contract | TikTok |

| ext.audience_range | string \| null | Optional in contract | TikTok |

| ext.category | string \| null | Optional in contract | TikTok |

| ext.industry | string \| null | Optional in contract | TikTok |

## Capabilities returning this object

| Capability | Object | Shape | Pagination |

| --- | --- | --- | --- |

| google.ads.get | Ad | item | No cursor |

| google.advertisers.ads.list | Ad | items | Explicit cursor |

| linkedin.ads.get | Ad | item | No cursor |

| linkedin.ads.search | Ad | items | Explicit cursor |

| meta.ads.get | Ad | item | No cursor |

| meta.ads.search | Ad | items | Explicit cursor |

| meta.advertisers.ads.list | Ad | items | Explicit cursor |

| tiktok.ads.search | Ad | items | Explicit cursor |

| tiktok.ads.get | Ad | item | No cursor |

| tiktok.creative_center.ads.get | Ad | item | No cursor |

| tiktok.creative_center.ads.search | Ad | items | Explicit cursor |

- [Google ad detail](https://datanavoapi.com/en/apis/google/ads/get/)
- [Google advertiser's ads](https://datanavoapi.com/en/apis/google/advertisers/ads/list/)
- [LinkedIn ad detail](https://datanavoapi.com/en/apis/linkedin/ads/get/)
- [LinkedIn Ad Library search](https://datanavoapi.com/en/apis/linkedin/ads/search/)
- [Meta ad detail](https://datanavoapi.com/en/apis/meta/ads/get/)
- [Meta Ad Library search](https://datanavoapi.com/en/apis/meta/ads/search/)
- [Meta advertiser's ads](https://datanavoapi.com/en/apis/meta/advertisers/ads/list/)
- [TikTok Ads Library search](https://datanavoapi.com/en/apis/tiktok/ads/search/)
- [TikTok Ads Library ad detail](https://datanavoapi.com/en/apis/tiktok/ads/get/)
- [TikTok Creative Center Top Ad detail](https://datanavoapi.com/en/apis/tiktok/creative_center/ads/get/)
- [TikTok Creative Center Top Ads search](https://datanavoapi.com/en/apis/tiktok/creative_center/ads/search/)

## Related pages

- [Google ad detail](https://datanavoapi.com/en/apis/google/ads/get/)
- [Google advertiser's ads](https://datanavoapi.com/en/apis/google/advertisers/ads/list/)
- [LinkedIn ad detail](https://datanavoapi.com/en/apis/linkedin/ads/get/)
- [LinkedIn Ad Library search](https://datanavoapi.com/en/apis/linkedin/ads/search/)
- [How do I organize Google advertising transparency data?](https://datanavoapi.com/en/answers/google-ads-transparency-center-api/)
- [Which APIs support LinkedIn ad research?](https://datanavoapi.com/en/answers/linkedin-ad-library-api/)
- [Ad creative research workflow](https://datanavoapi.com/en/skills/ads/)

[中文](https://datanavoapi.com/docs/objects/ad/)
