AnmeldenKostenlose Testphase starten
easyCoexistence Offizielle APIs

TikTok-Medien-URLs: verifizierte Domains und URL-Präfixe

Die API for Business von TikTok lädt Post-Medien über URLs herunter: video_url, custom_thumbnail_url und photo_images. Jede URL muss auf einer Domain oder einem URL-Präfix liegen, dessen Inhaberschaft die Entwickler-App verifiziert hat. Eine Domain wird über einen DNS-TXT-Eintrag verifiziert, ein Präfix über eine darunter abgelegte Signaturdatei, und zwar über /business/property/add/ und /business/property/verify/ mit App-ID und Secret.

easyCoexistence stellt Ihre Medien TikTok über ein eigenes verifiziertes URL-Präfix bereit: publish_tiktok_post nimmt einen HTTPS-Link von Claude, ChatGPT oder Ihrem eigenen Code entgegen und streamt die Datei von dort, wenn TikTok sie herunterlädt.

Nov 16, 2023

Seitdem lehnt TikTok Video-URLs ab, die nicht auf einer verifizierten Domain oder einem verifizierten URL-Präfix liegen.

Oct 15, 2025

Seitdem verlangen die URL-Property-Endpoints zusätzlich das Secret der Entwickler-App.

1 / 2

property_type-Werte: 1 für eine Domain, 2 für ein URL-Präfix.

0, 1, 2

property_status-Werte: pending, verified und not verified, wenn der Versuch fehlgeschlagen ist und wiederholt werden muss.

Apr 7, 2023

Entwickler, die davor Videos veröffentlicht haben, wurden für die Domains dieser Video-URLs automatisch als verifiziert gesetzt.

5 MB

Größtes Bild, das /business/comment/image/upload/ als Multipart-Formulardaten annimmt, für einen Kommentar oder eine Antwort.

Welche URLs lädt TikTok herunter?

Jedes Medienfeld in den beiden Veröffentlichungs-Endpoints ist eine URL, die TikTok nach Annahme des Aufrufs selbst abruft. Die Datei muss deshalb bis zum Ende des Downloads erreichbar bleiben:

  • video_url: das Video, für das TikTok empfiehlt, die URL mindestens 30 Minuten gültig zu halten.
  • custom_thumbnail_url: ein Bild, das als Titelbild des Videos dient.
  • photo_images: bis zu 35 Bilder für einen Foto-Post.
  • Timeout: TikTok gibt dem Download eine Stunde, danach schlägt der Post mit video_pull_failed oder photo_pull_failed fehl.

Was ist der Unterschied zwischen einer Domain und einem URL-Präfix?

Entscheidend ist, was Sie nachweisen, und damit, welche URLs als verifiziert gelten. Eine Domain eignet sich für Medien auf einem Host, den Sie besitzen oder kontrollieren; ein Präfix eignet sich für einen Ordner auf einem Host, auf den Sie nur Dateien hochladen können. Die Regeln von TikTok für jeden Property-Typ:

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

Wie verifizieren Sie eine Property?

In zwei Aufrufen, die sich mit app_id und Secret der Entwickler-App statt mit einem Konto-Token authentifizieren. Dazwischen wird der Nachweis hinterlegt:

  • Hinzufügen: POST /business/property/add/ mit url_property_meta, das property_type und url enthält. Die Antwort liefert signature, bei einem Präfix zusätzlich file_name, mit property_status 0.
  • Nachweis erbringen: Legen Sie die Signatur bei einer Domain in einen DNS-TXT-Eintrag ab oder bei einem Präfix in eine öffentliche Datei namens file_name mit einzelner .txt-Endung unter dem Präfix.
  • Prüfen: POST /business/property/verify/ mit demselben url_property_meta; property_status 1 bedeutet verifiziert, 2 bedeutet, dass der Versuch fehlgeschlagen ist.
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

Wie lassen sich Properties auflisten oder entfernen?

GET /business/property/list/ mit app_id und Secret liefert url_property_info_list; jeder Eintrag enthält property_type, url, property_status, signature und file_name. Subdomains einer verifizierten Domain gelten ohne eigenen Aufruf als verifiziert, erscheinen aber nur dann in der Liste, wenn sie hinzugefügt wurden. POST /business/property/delete/ mit app_id, Secret und url_property_meta entfernt eine Property, die die App nicht mehr besitzt oder kontrolliert.

Können Sie statt einer URL eine Datei hochladen?

Nicht für Posts. Die Accounts API veröffentlicht ausschließlich aus URLs, auch Entwürfe, und ihr einziger Upload-Endpoint, /business/comment/image/upload/, nimmt ein Kommentarbild als Multipart-Formulardaten entgegen: JPG, JPEG, WebP oder PNG bis 5 MB. Er gibt eine image_uri für einen Kommentar oder eine Antwort zurück. Der Chunked-Upload gehört zur Content Posting API auf developers.tiktok.com, einer eigenen API mit eigenen Apps, deren Übertragungsmethode FILE_UPLOAD heißt.

Was passiert mit einer nicht verifizierten URL?

TikTok verweigert die Veröffentlichung daraus. Die Referenz der API for Business nennt die Regel für Videos und Fotos, aber keinen eigenen Rückgabecode dafür. Lesen Sie daher Code und Meldung in der Antwort. Die Content Posting API auf developers.tiktok.com nennt denselben Fall url_ownership_unverified mit HTTP 403. Um den Video-Endpoint zu testen, bevor eine Property verifiziert ist, stellt TikTok eine Test-Video-URL bereit, die ohne Verifizierung auskommt:

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

Wie bringt easyCoexistence Ihre Medien zu TikTok?

Über ein eigenes verifiziertes URL-Präfix, https://easycoexistence.com/api/social/media/. publish_tiktok_post nimmt Ihren HTTPS-Link entgegen, lehnt http:// ab, bevor etwas gesendet wird, und gibt TikTok einen Link unter diesem Präfix. Dieser enthält ein signiertes Token, das Ihre Datei benennt, nach 6 Stunden abläuft und die Dateiendung Ihrer Datei beibehält. Wenn TikTok ihn abruft, prüft easyCoexistence das Token, bestätigt, dass Ihr Link HTTPS auf einer öffentlichen Adresse nutzt, und streamt die Datei direkt von Ihrem Link, einschließlich Range-Anfragen und Weiterleitungen, ohne sie zu speichern. Schlägt Ihr Link fehl, kann TikTok die Datei nicht herunterladen und der Post scheitert.

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

Häufige Fehler

  • Eine Subdomain verifizieren, Dateien aber auf deren übergeordneter Domain hosten. Eine verifizierte video.example.com deckt ihre eigenen Subdomains ab, nicht example.com selbst.
  • Die Signaturdatei des Präfixes über eine Weiterleitung ausliefern. TikTok folgt bei einem URL-Präfix keinen Weiterleitungen und wertet eine 3xx-Antwort als ungültig.
  • Die Signaturdatei als name.txt.txt speichern. TikTok erwartet, dass der Dateiname mit file_name übereinstimmt, mit einer einzigen .txt-Endung.
  • Die Datei direkt nach dem Veröffentlichungsaufruf löschen. TikTok lädt sie danach bis zu einer Stunde lang herunter und lässt den Post scheitern, wenn der Link nicht mehr funktioniert.
Mit EasyCoexistence

Ihre Domain braucht daher keine Verifizierung. US$ 9 bis US$ 0.75 pro Verbindung und Monat, sinkend mit jeder weiteren Verbindung, inklusive einer kostenlosen Testphase von 3 Tagen.

Häufig gestellte Fragen

Warum verlangt TikTok verifizierte Medien-URLs?

TikTok erklärt, die Verifizierung der Inhaberschaft von Video-URLs unterstütze die Einhaltung seiner Richtlinien zu urheberrechtlich geschützten Inhalten und zur Sicherheit der Nutzer.

Deckt eine verifizierte TikTok-Domain ihre Subdomains ab?

Ja. Subdomains einer verifizierten Domain gelten als verifiziert, auch wenn /business/property/list/ sie nur zeigt, wenn sie hinzugefügt wurden.

Kann die API for Business von TikTok über einen S3- oder CDN-Link veröffentlichen?

Ja, wenn der Link unter einer Domain oder einem URL-Präfix liegt, die die App verifiziert hat, etwa einem Präfix auf einem Bucket oder CDN-Pfad, den Sie kontrollieren.

Brauchen auch Foto-Posts verifizierte URLs?

Ja. Der Foto-Endpoint von TikTok besagt, dass Foto-Posts nicht aus unverifizierten Foto-URLs veröffentlicht werden können.

Weiterlesen

Verbinden Sie Ihren ersten Kanal in zwei Minuten.

Keine Plattform-Prüfungen, auf die Sie warten müssen. Verbinden Sie WhatsApp, Instagram, TikTok oder einen anderen Kanal, bitten Sie dann Ihre KI, zu posten, zu antworten oder Berichte zu erstellen, und sehen Sie ihr bei der Arbeit zu.

  • 3 Tage kostenlos
  • Jederzeit kündbar
  • Nur offizielle APIs
  • Überwacht rund um die Uhr (24/7)

Verifiziert am