InloggenGratis proefperiode starten
easyCoexistence Officiële API's

Een video naar de concepten van een TikTok-maker sturen via de API

De API's van TikTok sturen een video naar de concepten van een maker met de uploadstroom: de Content Posting API uploadt via /v2/post/publish/inbox/video/init/ onder de video.upload-scope, en TikTok stuurt de maker een inbox-melding om de video in de app te bewerken en te posten. De API for Business doet hetzelfde met upload_to_draft op /business/video/publish/, of met is_draft bij fotoposts.

easyCoexistence publiceert TikTok-video's en fotoposts met publish_tiktok_post vanuit Claude, ChatGPT of je eigen platform, nu of op een datum en tijd tot 90 dagen vooruit, met elke ingeplande post op het Posts-scherm totdat hij wordt gepubliceerd.

video.upload

Scope die TikTok definieert als het delen van inhoud met het account van de maker als concept, om verder te bewerken en in TikTok te posten.

5 pending

Het maximale aantal openstaande deelverzoeken dat de Content Posting API binnen elke periode van 24 uur toestaat, een limiet die TikTok instelt om spam te beperken.

SEND_TO_USER_INBOX

Status /business/publish/status/ meldt zodra een concept is geüpload en TikTok de inbox van de maker heeft geïnformeerd.

6 a minute

Het aantal verzoeken dat elke user access token naar het upload-endpoint van de Content Posting API kan sturen.

Ignored

Wat er met de overige post_info-velden gebeurt wanneer upload_to_draft op /business/video/publish/ true is.

Hoe verschilt een concept van een directe post?

In wie op Post drukt. Een directe post gaat live zodra TikTok hem heeft verwerkt; een concept komt in de TikTok-inbox van de maker en wordt pas gepubliceerd wanneer de maker het opent, naar wens bewerkt en plaatst. Het verschil loopt door beide posting-API's van TikTok:

Draft (upload)Direct post
Who postsThe creator, in the TikTok appThe app, through the API
Token scopevideo.upload, on both APIsvideo.publish on the Content Posting API
Content Posting API/v2/post/publish/inbox/video/init//v2/post/publish/video/init/
API for Businessupload_to_draft or is_draft set to trueThe same endpoints without them
Status once handed overSEND_TO_USER_INBOXPUBLISH_COMPLETE once live
Caption and settingsMostly finished by the creator in TikTokSent in the call

Hoe uploadt de Content Posting API een concept?

Met een POST naar https://open.tiktokapis.com/v2/post/publish/inbox/video/init/, een user access token met video.upload en een source_info-object. PULL_FROM_URL laat TikTok de video ophalen van een domein of URL-prefix dat de app heeft geverifieerd; FILE_UPLOAD geeft een upload_url terug, waarnaar het bestand in delen wordt verstuurd met PUT-verzoeken. De teruggegeven publish_id gaat naar /v2/post/publish/status/fetch/, foto's gebruiken /v2/post/publish/content/init/ met post_mode ingesteld op MEDIA_UPLOAD, en TikTok vraagt apps om gebruikers te vertellen de inbox-melding te openen om in TikTok verder te bewerken:

Upload a video to the creator's inbox from a URL
curl -X POST 'https://open.tiktokapis.com/v2/post/publish/inbox/video/init/' \
  -H 'Authorization: Bearer <USER_ACCESS_TOKEN>' \
  -H 'Content-Type: application/json; charset=UTF-8' \
  -d '{
    "source_info": {
      "source": "PULL_FROM_URL",
      "video_url": "https://media.example.com/tiktok/draft.mp4"
    }
  }'

# data.publish_id: pass it to /v2/post/publish/status/fetch/

Welke limieten gelden voor concepten via de Content Posting API?

TikTok legt deze vast in zijn upload-referentie; elk wordt teruggegeven door de init-aanroep wanneer het van toepassing is:

  • Openstaande concepten: maximaal 5 openstaande deelverzoeken binnen elke periode van 24 uur; daarboven spam_risk_too_many_pending_share met HTTP 403.
  • Verzoeken: 6 per minuut per user access token, daarna rate_limit_exceeded met HTTP 429.
  • Scope: een token zonder video.upload krijgt scope_not_authorized met HTTP 401.
  • Media: PULL_FROM_URL vanaf een domein of prefix dat de app niet heeft geverifieerd geeft url_ownership_unverified met HTTP 403.

Hoe uploadt de API for Business een concept?

Met de publicatie-endpoints en één extra veld in post_info. Op /business/video/publish/ verstuurt upload_to_draft ingesteld op true de video als concept, en TikTok negeert de overige post_info-velden; op /business/photo/publish/ houdt is_draft alleen de titel en het bijschrift over. Beide vereisen video.upload op het token van het account, dat /tt_user/token_info/get/ weergeeft; ontbreekt het, dan keurt de eigenaar het uploaden van concepten goed door de app opnieuw te autoriseren. De media staat nog steeds op een geverifieerde URL, de status is SEND_TO_USER_INBOX en de maker vindt het concept via de inbox-melding:

Send a video to the creator's drafts on the API for Business
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/video/publish/' \
  -H 'Access-Token: <ACCESS_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "<OPEN_ID>",
    "video_url": "https://media.example.com/tiktok/draft.mp4",
    "post_info": {
      "upload_to_draft": true,
      "is_brand_organic": false,
      "is_branded_content": false
    }
  }'

Wat doet de maker met het concept?

De maker rondt het af in TikTok. De inbox-melding opent de geüploade video of foto's in de editor van TikTok, waar de maker ze bekijkt, bewerkt en plaatst. Bij de Content Posting API gaat de status van SEND_TO_USER_INBOX naar PUBLISH_COMPLETE zodra de maker vanuit het concept plaatst, en TikTok merkt op dat één concept meer dan één post kan opleveren.

Stuurt easyCoexistence concepten?

Nee: publish_tiktok_post publiceert. Het roept /business/video/publish/ of /business/photo/publish/ aan zonder upload_to_draft of is_draft, dus een post gaat live zodra TikTok hem heeft verwerkt. Om een post voor controle terug te houden, plan je hem in met scheduled_at, van 1 minuut tot 90 dagen vooruit: hij wacht onder Aankomend op het Posts-scherm, update_scheduled_post wijzigt het tijdstip, het bijschrift of de titel van een fotopost, en cancel_scheduled_post stopt hem voordat hij uitgaat.

Veelgemaakte fouten

  • video.publish gebruiken om concepten te versturen. Concepten hebben video.upload nodig, de scope die TikTok omschrijft als het delen van inhoud als concept.
  • Een bijschrift instellen op een videoconcept via de API for Business. Met upload_to_draft op true negeert TikTok de rest van post_info.
  • Concepten sneller uploaden dan makers ze plaatsen. De Content Posting API stopt bij 5 openstaande deelverzoeken in 24 uur met spam_risk_too_many_pending_share.
  • Gebruikers zonder aanwijzing naar de inbox laten. TikTok vraagt apps hen te vertellen de inbox-melding te openen om de post af te maken.
Dit doen met EasyCoexistence

US$ 9 tot US$ 0,75 per verbinding per maand, dalend naarmate je meer verbindingen toevoegt, met de eerste 3 dagen gratis.

Veelgestelde vragen

Kan de TikTok API een video opslaan als concept?

Ja. De uploadstroom zet hem in de TikTok-inbox van de maker, waar de maker hem bewerkt en plaatst; het token heeft de video.upload-scope nodig.

Waar verschijnt een concept dat via de API is verstuurd?

In de TikTok-app, achter een inbox-melding die de video opent in de editor van TikTok, zodat de maker hem kan afmaken.

Behoudt een TikTok-concept mijn bijschrift?

Bij de API for Business behoudt een fotoconcept zijn titel en bijschrift, terwijl een videoconcept de overige post_info-velden laat vallen.

Kan één TikTok-concept meer dan één post worden?

Ja. TikTok merkt op dat één concept meer dan één post kan opleveren, en bij de Content Posting API gaat de status naar PUBLISH_COMPLETE zodra de maker er een post van plaatst.

Lees verder

Koppel je eerste kanaal in twee minuten.

Geen platformbeoordelingen om op te wachten. Verbind WhatsApp, Instagram, TikTok of een ander kanaal, vraag je AI om te posten, te reageren of een rapport te maken, en zie het aan het werk.

  • 3 dagen gratis
  • Op elk moment opzegbaar
  • Alleen officiële API's
  • 24/7 bewaakt

Geverifieerd op