Works with the AI Agents you already use

    Claude CodeClaude CodeCursorCursorCodex CLICodex CLIDeepSeekDeepSeekMuseMuse+22 more

    TikTok Content Posting API

    1

    Add "Post to TikTok" to your app and pass TikTok's app review the first time.

    $6.70

    Secure checkout via Stripe

    Money-back guarantee

    Converts to your local currency at checkout

    Security scanned
    TikTok Content Posting API

    TikTok Content Posting API

    Example session with this skill installed

    Our TikTok direct post fails with unaudited_client_can_only_post_to_private_accounts even though we send privacy_level SELF_ONLY. Why, and what do we need to do to post publicly?

    • Read your context and instructions
    • Compiled the tiktok content posting

    Summary

    Your app hasn't passed TikTok's audit, and the

    TikTok account itself is public. Before the audit, TikTok requires both: the post must be SELF_ONLY

    and the posting account must be private. Sending SELF_ONLY alone isn't enough, so /v2/post/publish/video/init/ refuses the request.

    Fix it today (testing)

    1. In the TikTok app for the posting account: Profile → ☰ → Settings and privacy → Privacy → Private account: on.
    2. Make sure the account is a

    Sandbox target user (Developer portal → your app → Sandbox → Target users), or sign-in fails with non_sandbox_target.
    3. Re-run creator_info. A private account returns FOLLOWER_OF_CREATOR, MUTUAL_FOLLOW_FRIENDS, SELF_ONLY. If "Everyone" (PUBLIC_TO_EVERYONE) still appears, the account is still public.
    4. Post again with privacy_level: "SELF_ONLY".

    Show it to users as an action, not a code

    case "unaudited_client_can_only_post_to_private_accounts":
      return "This app can only post privately until TikTok approves it. Choose Only me, and make sure the TikTok account is private.";
    

    Post publicly (permanent fix): pass the audit

    StepWhat to do
    Posting screenFresh creator_info on open, nickname shown, privacy with no default, Comment/Duet/Stitch unchecked, disclosure toggle with "Promotional content" / "Paid partnership" labels, consent line above Post, no upload before the click
    ScopesOnly user.info.basic, video.publish, video.upload. Remove anything "Import from Sandbox" added (user.info.profile, user.info.stats, video.list), or the review stalls
    URLsVerify a URL prefix with a trailing slash (https://app.example.com/); terms and privacy must sit under it
    Demo videoA Sandbox recording of the full flow: connect, posting screen, every toggle, post, the result on TikTok
    SubmitA reason of 120 characters at most, e.g. "First release: Login Kit and Content Posting API (Direct Post and drafts) for creators posting their own videos."

    Next steps

    1. I can check your posting screen against reference/posting-screen.md and list what's missing.
    2. After approval, switch to the

    Production client key and secret and have users reconnect, because Sandbox tokens don't carry over.

    Connects securely to your tools. The creator never sees your data.

    About this skill

    Add "Post to TikTok" to your app and pass TikTok's app review the first time.

    TikTok's Content Posting API has strict rules: a required posting screen with exact wording, chunk-size maths, private-only posting until you're audited, and a review that rejects apps for one unused scope. This skill gives your agent the whole playbook:

    • API flow: Login Kit OAuth (including the hex-encoded PKCE challenge desktop apps need), creator info, Direct Post, drafts to the inbox, the 5/64/128 MB chunk rules, status polling and every rate limit.
    • The required posting screen: every Content Sharing Guidelines rule with TikTok's exact strings for the disclosure labels, hover texts and consent line, plus a dependency-free React component.
    • App review: Sandbox target users, URL-prefix verification (and the trailing-slash trap), the production form, a scope explanation template, a shot-by-shot demo video plan, the 120-character submission reason, and when to recall.
    • Errors: every error and fail_reason code mapped to a fix and a message users understand.
    • Typed Node client: fetch-based, no SDK, calls only TikTok's own endpoints, with server-side checks for consent, privacy options, duration and branded content.

    What's in the zip

    • SKILL.md: when to use it and the step-by-step workflow
    • reference/api-flow.md: endpoints, payloads, chunk maths, polling, limits
    • reference/posting-screen.md: the UX checklist with TikTok's exact strings
    • reference/app-review.md: portal, sandbox, URL verification, the form, the demo video, submitting and recalling
    • reference/errors.md: error codes and fail_reason values, each with a fix
    • examples/tiktok-client.ts: a Node 18+ client (type-checked)
    • examples/PostToTikTok.tsx: the posting screen as a React component (type-checked)

    Written while shipping a real integration through TikTok's review. It includes the mistakes that cost days: scopes added silently by "Import from Sandbox", the 5-drafts-per-day cap, and unaudited apps posting only to private accounts. Facts are checked against TikTok's current docs, and the skill tells your agent to re-check anything time-sensitive. Not affiliated with TikTok.

    Find more skills like this on the Claude Skills Marketplace, the Codex Skills Marketplace and the Gemini Skills Marketplace, or browse Claude Skills for APIs & Backend.

    Client secrets must remain server-side. Direct Post is limited to private accounts and Sandbox users until the app audit passes. TikTok docs change frequently; verify latest rate limits.

    How to use

    1. 1

      Connect your agent to the Agensi MCP

      Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup

    2. 2

      Sign in to Agensi

      Your agent shows a sign-in link. Sign in and click Allow.

    3. 3

      Ask for what you need

      Your agent loads this skill and uses it on your task. It always asks before buying a skill.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill goes through the trust checks below.

    Security scanned

    Checked by our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    Money-back guarantee

    Doesn't do what its page promises? You get your money back.

    Trust & safety

    Security scan

    Security scan passed 8 days ago

    Accounts
    TiktokapisTiktokTikTok developer account
    Optional
    Node.js 18+React 18+

    Node and React are only for the example code. The guidance applies to any backend language and frontend. You need your own TikTok app (client key and secret) from developers.tiktok.com.

    Permissions

    Terminal / Shell
    Network Access
    Read Files
    Write Files

    Allowed Hosts

    open.tiktokapis.com
    www.tiktok.com

    The skill itself is guidance plus example code: your agent reads the reference files and writes TikTok integration code into your project (read/write files, shell for type-checks). The example client, when you run it, calls only TikTok's official API (open.tiktokapis.com) and the upload URL TikTok returns, using your user's access token. It never handles your client_secret and sends nothing anywhere else.

    Listed8 days ago

    What's inside

    Frequently Asked Questions

    It gives your agent the checklist reviewers apply. That covers every posting-screen rule with TikTok's exact wording, only requesting scopes you demo, URL-prefix verification, a scope explanation template, a shot-by-shot demo video plan and the submission reason. It also lists the common rejection causes and how to fix each one. No one can guarantee approval, but these are the issues that most often delay or reject apps.

    Any agent that reads SKILL.md: Claude Code, Codex, Cursor, Copilot, Gemini CLI and others. The guidance is language-agnostic (endpoints, payloads, rules), so your agent can apply it to Python, Go, PHP or anything else. The examples are TypeScript: a Node 18+ client using fetch and a React posting screen.

    Large files are supported up to TikTok's 4 GB limit. The skill explains TikTok's chunk rules: 5-64 MB chunks, the last chunk absorbing the remainder up to 128 MB, and files under 5 MB sent whole. The example client streams the file in order, retries a chunk on server errors, and polls the publish status afterwards.

    SKILL.md (when to use it and the workflow), four reference files (API flow, posting-screen checklist, app review guide, error codes) and two type-checked examples: tiktok-client.ts (creator info, Direct Post, inbox drafts, chunked upload, status polling, user-facing error messages) and PostToTikTok.tsx (the posting screen as a React component).

    Yes, the skill includes a specific debugging module that maps cryptic TikTok API codes, such as privacy level mismatches or scope errors, to clear, actionable fixes.

    New in APIs & Backend