Clip any video. From your code, or from any AI assistant.

Resolve an action (see the table below) to its URL and hand-off instructions.

Input ?action=<action>&platform=&plan=&accountId=

Returns { action, url, external, desktopOnly, instructions, alternates?: { storeUrl?, zipUrl? }, pollWith: "autoclip_get_setup_status", expectChecklistItem? }

The signed-in account.

Returns { id, email, displayName, plan: { tier, status, renewsAt, trialEndsAt, cancelAtPeriodEnd }, credits: { balance, monthlyAllowance, unlimited }, timezone, apiAccess, createdAt }

Credit, storage, concurrency and channel usage.

Returns { credits: { balance, monthlyAllowance, unlimited, usedThisPeriod, periodEndsAt, nextExpiresAt }, storage: { usedBytes, quotaBytes }, concurrentJobs: { active, max }, channels: { used, max } }

The setup checklist: the same rows the web, iOS and Android apps show on the Earn tab, with English copy and an action link per row, plus two informative extras.

Returns { earnState, globalPaused, checklist: [{ id, tier, status, title, detail, fixAction?, actionLink, tool?, desktopOnly, missingPlatforms? }], extras: [{ id, done, detail }], nextStep, complete }

Credit ledger, newest first.

Input ?limit=&cursor=

Returns { data: [{ at, delta, reason, kind, jobId? }], nextCursor }

Saved submit defaults (null when never saved).

Returns { reframeMode, layoutMode, outputAspect, captionStyle, clipLengthPreference, maxClips, autoHook, autoEnhance, seriesDetection }

Merge new submit defaults into the saved ones.

Input any of the /me/defaults fields

Returns the updated defaults

Posting time zone, notification and watermark preferences.

Input { timezone?: IANA zone, notifications?: { notifyOnNewUpload? }, watermark?: { watermarkForCredits? } }

Returns { timezone, notifications, watermark }

Export your account data, returned inline.

Input {}

Returns { status: "ready", data }

The plan and credit-pack catalog the pricing page uses.

Returns { plans: [{ id, name, priceUsdMonthly, priceUsdYearly, creditsMonthly, features[] }], topups: [{ id, credits, priceUsd }] }

The whole Earn screen: state, checklist, extension status, Content Rewards money, the away digest and settings.

Returns { state, globalPaused, topIssueId?, checklist[], machine, money, digest?, settings }

The activity feed: posted, submitted, approved, rejected, missed, attention, joined, skipped.

Input ?limit= (≤100, default 30) &campaignId=

Returns { data: [{ kind, at, campaignId, campaignName, platform?, handle?, amountCents?, reason?, submissionId?, enrollmentId?, deadlineAt?, fixAction? }], nextCursor: null }

Auto-Earn on/off, footage consent, settings and the exact consent text to show.

Returns { enabled, footageConsented, globalPaused, settings, consentText, platformsAvailable[], limits: { maxActiveHardCap: 10 } }

Change settings and/or turn Auto-Earn on or off. Settings and turning it off work on any plan; turning it on needs a paid plan (403 paid_plan_required) and footage consent the first time (428 consent_required). Confirmation is only asked when turning it on.

Input { enabled?, footageConsent?, maxActiveCampaigns? (1-10), dailyCreditBudget? (number | null = auto), minCpmCents?, platforms?: ("tiktok"|"instagram"|"youtube")[], offlinePolicy?: "wait_then_untagged"|"wait_forever", confirm? }

Returns { enabled, footageConsented, settings }

Campaigns Auto-Earn is running (or ran) for you.

Input ?status=running|paused|skipped|ended|all

Returns { data: [{ enrollmentId, campaignId, campaignName, cpmCents, platforms[], status, origin: "autopilot"|"pinned", skipReason, skipDetail, endReason, sourceHint, sources[], submissionsCount, earnedCents, firstActiveAt, updatedAt }], nextCursor: null }

Stop running a campaign. Auto-Earn stops clipping and submitting for it.

Input { confirm: true }

Returns { stopped }

Campaigns recommended for Auto-Earn, with expected value per clip and why any are blocked.

Input ?limit= (≤50, default 12)

Returns { data: [{ campaignId, name, cpmCents, platforms[], evCentsPerClip, sourceHint?, eligible, blocker?, blockerText? }], nextCursor: null }

Whether Auto-Earn can run a campaign for you, check by check.

Returns { eligible, checks: [{ label, ok }], enrollment | null }

Auto-earn this campaign: pin a campaign so Auto-Earn runs it. Errors: 409 campaign_ineligible / max_active / autopilot_paused, 403 paid_plan_required, 428 consent_required.

Input {}

Returns { enrollmentId, autopilotEnabled }

Email the user the desktop setup link (for someone on a phone). Up to 3 a day (429 after that); 409 when the account has no email.

Input {}

Returns { sent: true, remainingToday, url: "https://autoclip.dev/dashboard/earn?setup=1" }

The optional Whop wallet connection that shows your Content Rewards payout balance inside AutoClip.

Input ?include=memberships

Returns { connected, account: { username, connectedAt, status } | null, memberships? }

Disconnect the Whop wallet view. Payouts on Content Rewards are not affected.

Input { confirm: true }

Returns 204

Browse campaigns.

Input ?origin=catalog|manual &platform= &minRatePer1k= &q= &sort=opportunity|rate|budget|new &limit= &cursor=

Returns { data: [{ id, origin, contentRewardsUrl, name, brand, platforms[], ratePer1kViewsUsd, budgetTotalUsd, budgetRemainingUsd, minViews?, maxPayoutPerClipUsd?, requiresOwnAssets, payoutType?, status, endsAt?, sourceHint?, rules, autopilot | null }], nextCursor }

One campaign, with rules and requirements.

Returns Campaign

Add a campaign by link (a contentrewards.com/discover/<id> URL or a private campaign URL).

Input { url, name?, cpmRate?, specs?, contentSource? }

Returns 201 Campaign

Edit the specs of a campaign you added by link.

Input { specs }

Returns Campaign

Which campaigns each clip fits, with a score and reasons.

Input ?clipIds=a,b,c (≤50) or ?channelId=

Returns { data: [{ clipId, campaigns: [{ id, name, score, reasons[] }] }] }

Footage you uploaded for a campaign.

Returns { data: footage[] }

Attach an uploaded file (from POST /api/v1/uploads) as campaign footage.

Input { uploadKey, filename? }

Returns footage row

Remove campaign footage.

Input { confirm: true }

Returns 204

Submission history, with the Content Rewards status when it has synced.

Input ?status=ready|submitted|pending|approved|rejected|failed|refused|expired|all &clipId= &campaignId= &limit= &cursor=

Returns { data: [{ id, clipId, campaignId, status, crStatus, crSyncedAt, submissionUrl, … }], nextCursor }

Queue a clip for a campaign.

Input { clipId, campaignId, postUrl? }

Returns 201 Submission

Mark as submitted after you submitted it on Content Rewards yourself ({ status: "submitted" }), or correct a record. Records synced from Content Rewards cannot be corrected (409 conflict).

Input { status: "submitted", externalSubmissionId? } or { status: "pending"|"approved"|"rejected", estimatedViews? }

Returns Submission

Retry a failed automatic submission.

Returns { reset }

Where a clip was posted, and whether each post is still inside the 30-minute submit window.

Input ?clipId=

Returns { data: [{ platform, postUrl, postedAt, withinSubmitWindow }] }

Search YouTube channels.

Input ?q= &limit= (≤25)

Returns { data: [{ youtubeChannelId, title, handle, subscriberCount, thumbnailUrl, recentUploadCadence }] }

Preview a channel URL before monitoring it.

Input ?url=

Returns { platform, externalId, title, handle, subscriberCount, recentVideos[] }

Monitor a channel. Confirmation is required when autoClip is true, because every new upload spends credits. Plan channel limits return 403 plan_limit.

Input { url, autoClip?, autoPost?, socialAccountIds?, campaignId?, settings? }

Returns 201 Channel

Your monitored channels.

Input ?limit= &cursor=

Returns { data: [{ id, platform, externalId, title, handle, thumbnailUrl, managedBy: "user"|"autopilot", autoClip, autoPost, socialAccountIds[], campaign, settings, lastCheckedAt, lastVideoDetectedAt, jobsCreated7d, createdAt }], nextCursor }

One channel.

Returns Channel

Change auto-clip, auto-post, accounts or clip settings. Confirmation is required when turning autoClip on.

Input { autoClip?, autoPost?, socialAccountIds?, settings? }

Returns Channel

Link a channel to a campaign (or unlink with null). 409 campaign_blocked when the campaign doesn't allow it.

Input { campaignId: string | null }

Returns Channel

Stop monitoring a channel.

Input { confirm: true }

Returns 204

Jobs created from a channel.

Input ?limit= &cursor=

Returns { data: Job[] }

Apply recommended settings to every channel.

Input {}

Returns { updated, channels[] }

Your weekly posting slots.

Returns { timezone, data: [{ id, socialAccountId, dayOfWeek: 0-6, time: "HH:mm" }] }

Replace one account's slots.

Input { socialAccountId, slots: [{ dayOfWeek, time }] }

Returns same as GET

Add clips to the posting queue. They publish publicly, so confirmation is required.

Input { clipIds[], socialAccountIds[], confirm: true }

Returns { scheduled: [{ clipId, socialAccountId, scheduledFor, publishScheduleId }] }

Scheduled posts in a date range (up to 62 days).

Input ?from=&to= (ISO dates)

Returns { data: ScheduledPost[] }

Earnings by campaign or by clip. real is true when the figure synced from Content Rewards, false for an estimate.

Input ?groupBy=campaign|clip &from= &to=

Returns { totalUsd, pendingUsd, paidUsd, real, data: [{ key, name, views, earningsUsd, real, submissions }] }

Your Whop wallet balance, when the optional Whop view is connected. Withdrawals happen on Content Rewards and Whop.

Returns { connected, availableUsd?, pendingUsd?, currency?, withdrawActionLink: "withdraw_earnings" }

Views, likes, posts, top clips, per-platform split and best posting hours.

Input ?days=7|30|90

Returns { views, likes, posts, topClips[], byPlatform[], bestPostingHours[], growth[] }

Return on each monitored channel.

Input ?days=

Returns { data: [{ channelId, clips, views, earningsUsd, roi }] }

Apply an AutopilotPlan. Confirmation is required when it turns Auto-Earn on or adds an auto-clip channel; the first enable also needs earn.footageConsent: true. It stops on the first hard error (plan, consent, pause) and reports per-step results. Caps: 20 channels, 20 accounts, 10 pins.

Input { plan: { timezone?, defaults?, earn?: { enabled, footageConsent?, settings?, pinCampaignIds? }, channels?: [{ url, autoClip, autoPost, socialAccountIds?, campaignId?, settings? }], queueSlots?: [{ socialAccountId, slots[] }] }, dryRun?, confirm? }

Returns { applied, results: [{ step, key?, ok, error? }], estimate: { dailyCreditBudget, maxActiveCampaigns, autoClipChannels, creditsBalance }, setup: SetupStatus }

Get a presigned upload URL for a local file.

Input { filename, contentType, sizeBytes }

Returns { uploadUrl, videoKey, expiresAt }

Submit up to 10 jobs at once.

Input { jobs: SubmitJobBody[] }

Returns results per job

Check a source URL and estimate its credit cost before submitting.

Input ?url=

Returns { platform, durationSec, title, estimatedCredits, supported }

Rename or save a project.

Input { name?, saved? }

Returns Project

Duplicate a project. Also /dismiss and /more-clips (find more clips in the same source).

Returns Project

Your clips.

Input ?status= &campaignId= &jobId=

Returns { data: Clip[], nextCursor }

One clip.

Returns Clip

Set a clip's title.

Input { title }

Returns Clip

Approve a clip. Also /discard and /regenerate-title.

Returns Clip

Label a connected account. GET /social-accounts also returns needsReconnect and reconnectActionLink.

Input { label }

Returns SocialAccount

Disconnect a social account.

Input { confirm: true }

Returns 204

Create a brand template. Also PATCH and DELETE (confirm) /brand-templates/{id}.

Returns BrandTemplate

Send a ping event to an endpoint.

Returns { delivered, status }

Submit a video for clipping. Jobs respect your plan's monthly quota exactly like in-app submissions (including stacked subscriptions and team pooling).

Body fields

• url (required) — public video URL (YouTube, Vimeo, Rumble, Loom, StreamYard, Dailymotion, Facebook, X, or direct .mp4/.mov)
• maxClips — integer 1-30 (defaults to your plan's per-video cap)
• reframeMode — smart_crop | blur_fill | letterbox
• layoutMode — fill | fit | split | screenshare | gameplay | three | four (split/screenshare/gameplay/three/four are Scale-only)
• outputAspect — 16:9 (default) | 9:16 | 1:1 | 4:5 (1:1 and 4:5 need a multi-aspect plan)
• clipLengthPreference — auto | under_30 | 30_60 | 60_90 | 3_5m | 5_10m | 10_15m
• genre, topicKeywords — steer the AI's clip selection
• visualAnalysis — true adds a frame-sampling visual pass so prompts can target on-screen moments (Pro and Scale plans)
• processStartSec / processEndSec — clip only a window of the source
• jobType — clip (default) | captions_only
• autoEnhance, autoHook — booleans; AI filler-cut and burned-in hook line
• audioEnhance — boolean; studio-sound speech enhancement (denoise, de-ess, loudness normalize) on every clip

Returns 201 with { id, status }, 402 when quota is exhausted, 400 on validation errors.

Your most recent jobs, newest first — same shape as the single-job endpoint. ?limit= accepts 1-25 (default 10). Handy for dashboards and the AutoClip Chrome extension's recent-jobs view.

Job status. status is one of queued, processing, complete, failed, with progressPct, clipCount, and a human-readable error on failure.

Finished clips ranked by virality score. Each clip includes title, hookText, viralityScore, durationSec, aspect, a presigned downloadUrl (valid 1 hour — re-request for fresh links), and a thumbnailUrl.

Alias of POST /api/v1/jobs — identical body and 201 { id, status: "queued" } response. Use whichever noun fits your integration; both create a clipping project.

Project status — same shape as GET /api/v1/jobs/{id}: status, progressPct, videoTitle, clipCount, error. 404 if it isn't found or isn't yours.

The same ranked-clips payload as GET /api/v1/jobs/{id}/clips, wrapped as { projectId, clips[] }. Each clip carries a 1-hour presigned downloadUrl and thumbnailUrl.

Permanently delete a project and its clips. Returns { ok: true, deletedClips }. 404 if it isn't found or isn't yours.

Documented divergence: AutoClip has no public whole-project share link, so this returns 200 with { "divergence": "unsupported", "message": … } rather than a 404. Clips are shared individually after rendering.

Duplicate a finished clip (counts as one clip against your quota). Returns { clipId, sourceClipId }. 409 clip_not_ready if the source clip hasn't finished rendering.

Re-render a finished clip.

• op (required) — trim | extend | fix_captions | set_caption_text
• startSec / endSec — required for trim/extend (with endSec > startSec); ignored for the caption ops
• segmentIndex / wordIndex / text — for set_caption_text: the caption to rewrite (index from the captions endpoint below), optionally one word inside it, and the corrected text

Returns { clipId, status: "reframing" } and re-runs the render pipeline. 404 unknown clip · 409 clip_not_ready · 400 on bad params.

set_caption_text writes the same word-level correction the in-app transcript editor writes, and costs the same re-render credit. Replacement text may not have fewer words than the caption it replaces — caption words are rewritten in place, never deleted, so use trim to cut a passage. A replacement identical to the current text returns 409 no_change and is not charged.

The captions burnt into a finished clip, in order. Returns { clipId, captions[], wordCount, maxWordsPerCaption, transcriptSource } where each caption carries index, text, startSec/endSec and its words[] (each with wordIndex, the original ASR text and whether it has been corrected). The index is what set_caption_text takes.

Captions are grouped exactly as the renderer groups them — at the clip's own caption-template width, which is 2 to 6 words depending on the style (and on the Brand Kit "Lines" setting), not a fixed number. maxWordsPerCaption reports the width used, so always take indices from this endpoint instead of counting words yourself. The list covers only the words that reach the screen: a clip with cuts (AI Enhance, filler or bad-take removal, a fine cut, a compilation) or with caption-removed spans has fewer caption words than its transcript, and the indices skip the dropped words exactly as the render does.

Word-level transcript for a project, grouped into paragraphs on ≥1.2s silence gaps. Returns { projectId, paragraphs[], wordCount } where each paragraph has startMs, endMs, text, and a words[] array of { text, startMs, endMs }. 400 if projectId is missing.

Generate an AI thumbnail for a clip. Body { clipId, kind?: "thumbnail" } (thumbnail is the only kind). Costs 7 credits, auto-refunded on failure. Runs synchronously: 200 { status: "complete", creditsCharged: 7, thumbnailKey } on success, or 200 { status: "failed", error, creditsCharged: 0 } if generation fails. 402 if you lack the 7 credits · 404 unknown clip.

Read a clip's thumbnail state: { clipId, status: "complete" | "none", thumbnailKey }.

Generate per-platform post copy (title, description, hashtags) for a clip.

• clipId (required)
• platforms (required) — 1-12 of tiktok, youtube, instagram, facebook, linkedin, x, threads, pinterest, snapchat, reddit, bluesky, twitch (unknown names are ignored)
• tone — punchy (default) | professional | casual | clickbait | informative

Returns 200 { jobId, status: "complete", results: { <platform>: { title, description, hashtags[] } } }. 404 unknown clip · 422 generation_failed if no supported platforms or the model returns nothing.

Re-read cached copy for a clip and tone (default punchy). Same results shape; returns an empty results object (still 200) if nothing has been generated for that tone yet.

List connected social accounts. ?q= is mine (all) or byPlatform (add &platform=tiktok). Each account: { id, platform, handle, label, status, connectedAt }. Use the id as socialAccountId when publishing.

Publish a clip to a connected account now. Body { clipId, socialAccountId, caption? } (caption ≤4000 chars). X/Twitter posts cost +1 credit. Returns 201 { id, platform, status: "pending", xSurchargeCharged }. Errors: 402 insufficient_credits · 409 account_not_connected · 409 clip_not_ready · 404 not_found.

List recent publish tasks. ?q= is findByPeriodPage or findByProjectId (requires &projectId=). Each: { id, clipId, platform, status, scheduledFor, createdAt }.

Schedule a clip to post later. Body { clipId, socialAccountId, scheduledAt, caption? } where scheduledAt is a future unix-ms timestamp. Returns 201 { id, status: "pending" }. 400 if the time is in the past · 402 insufficient credits · 409 account not connected.

Schedule up to 200 at once. Body { entries: [ { clipId, socialAccountId, scheduledAt, caption? } ] }. Non-atomic — returns 201 { created, results[] } with one { ok, id?, code? } per entry, in order.

Reschedule a pending post. Body { scheduledAt }. Returns { id, scheduledFor }. 409 if the post is no longer pending.

Cancel a pending scheduled post (marks it cancelled). Returns { ok: true, id }.

List schedules. ?q= is byPage or findByProjectAndClip (with &projectId= / &clipId=). Each: { id, clipId, platform, status, scheduledFor }.

List your brand kits (surfaced as brand templates): { id, name, primaryColor, …, hasLogo, hasIntro, hasOutro, createdAt }. An empty workspace returns an empty list (never 404). Create, edit and delete them with the brand-template routes under clip management.

Re-render a finished clip with your workspace's censored-word list applied. Body { clipId }. Returns { clipId, status: "reframing", censoredWordCount }. 404 unknown clip · 409 clip_not_ready.

Poll a censor re-render: { clipId, status: "complete" | "processing" }.

Register an HTTPS callback URL: { "url": "https://..." }. Returns the endpoint id and a secret (shown once) used to sign deliveries. Re-registering the same URL is idempotent. Up to 3 endpoints per account.

List registered endpoints with last-delivery status.

Remove a callback endpoint.