Key takeaways
- Instagram exposes is_ai_generated (AI disclosure), branded_content_sponsor_ids (up to 2 sponsor ids), and is_paid_partnership (enables the "Paid partnership" label) directly on its Content Publishing API.
- TikTok exposes brand_content_toggle (paid partnership), brand_organic_toggle (own-business promotion) and is_aigc (AI-generated, auto-adds a labeled tag) on its Direct Post reference.
- X exposes paid_partnership and made_with_ai directly in its post-creation request schema — a notable positive finding, since these are API-settable rather than UI-only on X.
- Facebook Pages, Threads, LinkedIn, Pinterest, Bluesky and Telegram either have no confirmed API-settable disclosure field, or the field exists only as a UI/product feature with no equivalent found in the publish API payload.
TikTok branded content toggle API: platforms with confirmed API-settable disclosure fields
Instagram's Content Publishing reference confirms three fields: is_ai_generated (boolean), branded_content_sponsor_ids (an array holding up to 2 sponsor ids), and is_paid_partnership (boolean, enables the visible "Paid partnership" label). TikTok's Direct Post reference confirms brand_content_toggle (third-party paid promotion), brand_organic_toggle (promoting the poster's own business), and is_aigc (AI-generated content, which auto-adds a "Creator labeled as AI-generated" tag). X's post-creation request schema confirms both paid_partnership and made_with_ai as directly settable fields — notable since these are API-settable on X rather than restricted to the X app's own UI.
YouTube's videos.insert settable-properties list includes status.containsSyntheticMedia, confirming the field exists and is API-writable — but its full definition, allowed values, and exact constraints were not fully obtained during this research; treat its EXISTENCE as confirmed and its precise semantics as unconfirmed pending a closer read of Google's reference.
Platforms with no confirmed API field
Facebook Pages' sponsor_id field for branded-content tagging is documented only under the Marketing API guide, not the core Pages API — whether it works via a plain Pages /feed post outside a Marketing API/ad-account context is unconfirmed. Threads has no branded-content or AI-disclosure field found in its current API documentation. LinkedIn has none either on its Posts/UGC API; the only ads-adjacent field found (adContext/dscStatus) is campaign-tracking metadata for LinkedIn Ads, not a consumer-facing disclosure toggle — disclosure on LinkedIn appears to be UI-only.
Pinterest's paid-partnership tagging and its "Gen AI" content label both exist as real product/Help-Center features, but neither was found exposed as a settable field on the Pins API v5 create/update payload — a confirmed negative from the specific pages checked, though not every field in Pinterest's API was individually enumerated. Bluesky has no ready-made paid-partnership or AI-generated label; its general-purpose labels architecture (self-labels plus third-party labeler services) could theoretically support this kind of disclosure, but self-labels are constrained to a Bluesky-defined allow-list rather than free text, and no first-party AI/paid-partnership labeler was found. Telegram has no disclosure fields on any send method — any disclosure has to be manual, written into the message text itself.
FAQ
- Can a scheduling tool set an AI-generated-content disclosure through Instagram's API?
- Yes — is_ai_generated is a confirmed boolean field on Instagram's Content Publishing API, directly settable at publish time.
- Does TikTok's API let you mark a post as AI-generated?
- Yes — the is_aigc field on TikTok's Direct Post reference marks content as AI-generated and automatically adds a "Creator labeled as AI-generated" tag to the published post.
- Can paid-partnership disclosure be set through X's API?
- Yes — paid_partnership is a confirmed field directly in X's post-creation request schema, alongside a separate made_with_ai field, both API-settable rather than restricted to X's own app UI.
- Does LinkedIn's API expose a paid-partnership disclosure field?
- No confirmed field was found on LinkedIn's Posts/UGC API — disclosure on LinkedIn appears to be a UI-only feature with no equivalent settable field in the publish API payload.
- Can Telegram bots disclose paid partnerships or AI content through a dedicated field?
- No — Telegram's send methods have no disclosure fields at all; any such disclosure has to be written manually into the message text itself.
- Does Pinterest have paid-partnership tagging?
- As a product feature in Pinterest's own app, yes — but it was not found exposed as a settable field on the Pins API v5 create or update payload, so a third-party integration cannot currently set it through the API.