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.
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.
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.
Status /business/publish/status/ meldt zodra een concept is geüpload en TikTok de inbox van de maker heeft geïnformeerd.
Het aantal verzoeken dat elke user access token naar het upload-endpoint van de Content Posting API kan sturen.
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 posts | The creator, in the TikTok app | The app, through the API |
| Token scope | video.upload, on both APIs | video.publish on the Content Posting API |
| Content Posting API | /v2/post/publish/inbox/video/init/ | /v2/post/publish/video/init/ |
| API for Business | upload_to_draft or is_draft set to true | The same endpoints without them |
| Status once handed over | SEND_TO_USER_INBOX | PUBLISH_COMPLETE once live |
| Caption and settings | Mostly finished by the creator in TikTok | Sent 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:
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_sharemet HTTP 403. - Verzoeken: 6 per minuut per user access token, daarna
rate_limit_exceededmet HTTP 429. - Scope: een token zonder video.upload krijgt
scope_not_authorizedmet HTTP 401. - Media:
PULL_FROM_URLvanaf een domein of prefix dat de app niet heeft geverifieerd geefturl_ownership_unverifiedmet 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:
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.
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