Docs
Docs
Everything you need to post your first video, slideshow or image through the API.
QuickstartGet an API key, connect a TikTok or Instagram account, and publish your first video or slideshow with UGC API. Examples in curl, JavaScript and Python.AuthenticationHow to authenticate with UGC API: create ugc_live_ API keys in the dashboard, send them as Bearer tokens, rotate them safely, and handle unauthorized errors.Connect accountsConnect TikTok, Instagram, Facebook Page and YouTube accounts with connect links. Map them to your users with external_id, list them and disconnect them.MediaUpload videos and images to UGC API with POST /v1/media, or use your own public URLs. Retention rules, formats that work everywhere and common media errors.Create a postReference for creating, listing, reading and cancelling posts with UGC API: every request field, per-account results, scheduling and external IDs.Formats and optionsEvery UGC API format and option per platform: slideshow, video and image rules for TikTok, Instagram, Facebook and YouTube, drafts, music, Stories, AI labels.CampaignsPOST /v1/campaigns spreads many posts over many accounts on a per-account cadence: round-robin assignment, local posting times, staggered minutes per account.WebhooksUGC API webhooks for post.published, post.failed and account.disconnected. Set your endpoint, read payloads and verify the X-UGCAPI-Signature HMAC-SHA256.ErrorsUGC API error format and codes: unauthorized, insufficient_credits, invalid_request, account_not_found, media_unreachable, platform_rejected, rate_limited.LimitsPosting limits that apply when publishing via API: TikTok creator caps, Instagram's 24-hour publishing limit, Facebook Reels limits and YouTube upload quota.Pricing and creditsHow UGC API credits work: 1 post is one piece of content on one account, Story frames count individually, 50 free posts, $10 per 1,000, credits never expire.