InloggenGratis proefperiode starten
easyCoexistence Officiële API's

TikTok-media-URL's: geverifieerde domeinen en URL-prefixen

TikTok's API for Business haalt postmedia op van URL's: video_url, custom_thumbnail_url en photo_images. Elke URL moet staan op een domein of URL-prefix waarvan de app van de ontwikkelaar het eigendom heeft geverifieerd. Een domein wordt geverifieerd met een DNS TXT-record, een prefix met een handtekeningbestand dat eronder wordt geplaatst, via /business/property/add/ en /business/property/verify/ met de app-ID en het geheim van de app.

easyCoexistence levert je media aan TikTok vanuit een eigen geverifieerde URL-prefix: publish_tiktok_post neemt een HTTPS-link van Claude, ChatGPT of je eigen code aan en streamt het bestand daarvan wanneer TikTok het downloadt, zodat je domein geen verificatie nodig heeft.

Nov 16, 2023

Sindsdien weigert TikTok video-URL's die niet op een geverifieerd domein of URL-prefix staan.

Oct 15, 2025

Sindsdien vereisen de URL-property-endpoints ook het geheim van de app van de ontwikkelaar.

1 / 2

property_type-waarden: 1 voor een domein, 2 voor een URL-prefix.

0, 1, 2

property_status-waarden: pending, verified en not verified, wat betekent dat de poging mislukte en herhaald moet worden.

Apr 7, 2023

Ontwikkelaars die vóór die datum video's publiceerden, kregen de domeinen van die video-URL's automatisch op verified gezet.

5 MB

Grootste afbeelding die /business/comment/image/upload/ accepteert, als multipart-formuliergegevens, voor een reactie of een antwoord.

Welke URL's downloadt TikTok?

Elk mediaveld in de twee publiceer-endpoints is een URL die TikTok zelf ophaalt nadat de aanroep is geaccepteerd, dus het bestand moet bereikbaar blijven tot het downloaden klaar is:

  • video_url: de video, waarvan TikTok aanraadt die minimaal 30 minuten geldig te houden.
  • custom_thumbnail_url: een afbeelding die als omslag van de video wordt gebruikt.
  • photo_images: tot 35 afbeeldingen voor een fotopost.
  • Timeout: TikTok geeft het downloaden een uur, daarna mislukt de post met video_pull_failed of photo_pull_failed.

Wat is het verschil tussen een domein en een URL-prefix?

Wat je aantoonbaar bezit, en dus welke URL's als geverifieerd gelden. Een domein past bij media op een host die je bezit of beheert; een prefix past bij een map op een host waarop je alleen bestanden kunt uploaden. TikTok's regels per eigenschapstype:

DomainURL prefix
What it isA site you own, such as example.com or a subdomainhttps:// plus a host, a path and a final /, such as https://www.example.com/videos/
ProofA DNS TXT record holding the signatureA file named file_name, holding the signature, uploaded under the prefix
CoversURLs on the domain and its subdomainsURLs that begin with the prefix
Leaves outThe parent: verifying video.example.com leaves example.com unverifiedSibling paths: /folder/user/ leaves /folder/public/ unverified
RedirectsNot applicableNot followed; a prefix answering 3xx is invalid

Hoe verifieer je een property?

Via twee aanroepen die authenticeren met de app_id en het secret van de developer-app in plaats van een account-token, met het bewijs ertussen:

  • Toevoegen: POST /business/property/add/ met url_property_meta, met property_type en url; het antwoord geeft signature, plus file_name voor een prefix, met property_status 0.
  • Bewijzen: zet de handtekening in een DNS TXT-record voor een domein, of in een openbaar bestand met de naam file_name en één .txt-extensie onder een prefix.
  • Controleren: POST /business/property/verify/ met dezelfde url_property_meta; property_status 1 betekent geverifieerd, en 2 betekent dat de poging mislukte.
Add a URL prefix
curl -X POST 'https://business-api.tiktok.com/open_api/v1.3/business/property/add/' \
  -H 'Content-Type: application/json' \
  -d '{
    "app_id": "<APP_ID>",
    "secret": "<APP_SECRET>",
    "url_property_meta": { "property_type": 2, "url": "https://media.example.com/tiktok/" }
  }'

# data.url_property_info: url, property_type, property_status (0), signature, file_name

Hoe vraag je properties op of verwijder je ze?

GET /business/property/list/ met app_id en secret geeft url_property_info_list, met per item property_type, url, property_status, signature en file_name. Subdomeinen van een geverifieerd domein gelden als geverifieerd zonder eigen aanroep, maar verschijnen alleen in de lijst als ze zijn toegevoegd. POST /business/property/delete/ met app_id, secret en url_property_meta verwijdert een property die de app niet meer bezit of beheert.

Kun je een bestand uploaden in plaats van een URL?

Niet voor posts. De Accounts API publiceert alleen vanuit URL's, ook concepten, en het enige uploadendpoint, /business/comment/image/upload/, neemt een reactieafbeelding aan als multipart-formuliergegevens, JPG, JPEG, WebP of PNG tot 5 MB, en geeft een image_uri terug voor een reactie of antwoord. Upload in stukken hoort bij de Content Posting API op developers.tiktok.com, een aparte API met eigen apps, waarbij de overdrachtsmethode FILE_UPLOAD heet.

Wat gebeurt er met een URL die niet is geverifieerd?

TikTok weigert vanuit die URL te publiceren. De referentie van de API for Business noemt de regel voor video's en foto's, maar kent er geen eigen retourcode voor, dus lees de code en het bericht in het antwoord. De Content Posting API op developers.tiktok.com noemt hetzelfde geval url_ownership_unverified, met HTTP 403. Om het video-endpoint te proberen voordat een property is geverifieerd, publiceert TikTok een testvideo-URL die geen verificatie vereist:

TikTok's test video URL for /business/video/publish/
https://sf16-va.tiktokcdn.com/obj/eden-va2/uvpapzpbxjH-aulauvJ-WV[[/ljhwZthlaukjlkulzlp/3min.mp4

Hoe krijgt easyCoexistence je media bij TikTok?

Via één eigen geverifieerde URL-prefix, https://easycoexistence.com/api/social/media/. publish_tiktok_post neemt je HTTPS-link aan, weigert http:// voordat er iets wordt verzonden, en geeft TikTok een link onder die prefix met een ondertekend token dat je bestand benoemt, na 6 uur verloopt en de extensie van je bestand behoudt. Wanneer TikTok het ophaalt, controleert easyCoexistence het token, bevestigt dat je link HTTPS gebruikt op een openbaar adres, en streamt het bestand rechtstreeks van je link, inclusief range-verzoeken en omleidingen, zonder het op te slaan. Als je link faalt, kan TikTok het bestand niet downloaden en mislukt de post.

What TikTok receives in place of your link
Your link:       https://cdn.example.com/videos/launch.mp4
Sent to TikTok:  https://easycoexistence.com/api/social/media/<SIGNED_TOKEN>.mp4

Veelgemaakte fouten

  • Een subdomein verifiëren en de bestanden op het bovenliggende domein hosten. Een geverifieerd video.example.com dekt zijn eigen subdomeinen, niet example.com zelf.
  • Het handtekeningbestand van de prefix via een omleiding serveren. TikTok volgt geen omleidingen voor een URL-prefix en behandelt een 3xx-antwoord als ongeldig.
  • Het handtekeningbestand opslaan als name.txt.txt. TikTok wil dat de bestandsnaam overeenkomt met file_name, met één .txt-extensie.
  • Het bestand verwijderen direct na de publicatie-aanroep. TikTok downloadt het daarna, tot een uur lang, en laat de post mislukken als de link niet meer werkt.
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

Waarom eist TikTok geverifieerde media-URL's?

TikTok zegt dat het verifiëren van eigendom van video-URL's helpt om te voldoen aan zijn beleid voor auteursrechtelijk beschermde inhoud en de veiligheid van gebruikers.

Dekt een geverifieerd TikTok-domein zijn subdomeinen?

Ja. Subdomeinen van een geverifieerd domein gelden als geverifieerd, al toont /business/property/list/ ze alleen als ze zijn toegevoegd.

Kan de API for Business van TikTok publiceren vanuit een S3- of CDN-link?

Ja, wanneer de link onder een domein of URL-prefix staat dat de app heeft geverifieerd, zoals een prefix op een bucket of CDN-pad dat je beheert.

Hebben fotoposts ook geverifieerde URL's nodig?

Ja. Het fotoendpoint van TikTok stelt dat fotoposts niet kunnen worden gepubliceerd vanuit ongeverifieerde foto-URL's.

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