AccediInizia la prova gratuita
easyCoexistence API ufficiali

URL dei media di TikTok: domini verificati e prefissi URL

L'API di TikTok per le aziende scarica i media dei post dagli URL: video_url, custom_thumbnail_url e photo_images. Ogni URL deve trovarsi su un dominio o un prefisso URL la cui proprietà è stata verificata dall'app dello sviluppatore. Un dominio si verifica con un record DNS TXT, un prefisso con un file di firma posto sotto di esso, tramite /business/property/add/ e /business/property/verify/ con ID e segreto dell'app.

easyCoexistence serve i tuoi media a TikTok dal proprio prefisso URL verificato: publish_tiktok_post accetta un link HTTPS da Claude, ChatGPT o dal tuo codice e trasmette il file da quel link quando TikTok lo scarica, quindi il tuo dominio non richiede alcuna verifica.

Nov 16, 2023

Da allora, TikTok rifiuta gli URL dei video che non si trovano su un dominio o un prefisso URL verificato.

Oct 15, 2025

Da allora, anche gli endpoint delle proprietà URL richiedono il segreto dell'app sviluppatore.

1 / 2

Valori di property_type: 1 per un dominio, 2 per un prefisso URL.

0, 1, 2

Valori di property_status: pending, verified e non verificato, quando il tentativo non è riuscito e va ripetuto.

Apr 7, 2023

Gli sviluppatori che hanno pubblicato video prima di allora hanno visto i domini di quegli URL impostati automaticamente come verificati.

5 MB

Immagine più grande accettata da /business/comment/image/upload/, in dati di form multipart, per un commento o una risposta.

Quali URL scarica TikTok?

Ogni campo multimediale dei due endpoint di pubblicazione è un URL che TikTok recupera autonomamente dopo aver accettato la chiamata, quindi il file deve restare raggiungibile fino al termine del download:

  • video_url: il video, che TikTok consiglia di mantenere valido per almeno 30 minuti.
  • custom_thumbnail_url: un'immagine da usare come copertina del video.
  • photo_images: fino a 35 immagini per un post di foto.
  • Timeout: TikTok concede al download un'ora, poi fa fallire il post con video_pull_failed o photo_pull_failed.

Qual è la differenza tra dominio e prefisso URL?

Ciò che dimostri di possedere, e quindi quali URL risultano verificati. Un dominio si adatta ai media su un host di cui sei proprietario o che controlli; un prefisso si adatta a una cartella su un host su cui puoi solo caricare file. Ecco le regole di TikTok per ciascun tipo di proprietà:

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

Come verifichi una proprietà?

Con due chiamate che si autenticano con app_id e segreto dell'app, invece che con un token di account, e con la prova da collocare nel mezzo:

  • Aggiungila: POST /business/property/add/ con url_property_meta, contenente property_type e url; la risposta restituisce signature, più file_name per un prefisso, con property_status 0.
  • Dimostrala: inserisci la firma in un record DNS TXT per un dominio, oppure in un file pubblico chiamato file_name, con una sola estensione .txt, sotto un prefisso.
  • Controllala: POST /business/property/verify/ con lo stesso url_property_meta; property_status 1 significa verificata, 2 significa che il tentativo è fallito.
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

Come elenchi o rimuovi le proprietà?

GET /business/property/list/ con app_id e segreto restituisce url_property_info_list, con ogni voce che riporta property_type, url, property_status, signature e file_name. I sottodomini di un dominio verificato risultano verificati senza una chiamata propria, ma compaiono nell'elenco solo se sono stati aggiunti. POST /business/property/delete/ con app_id, segreto e url_property_meta elimina una proprietà che l'app non possiede più o non controlla.

Puoi caricare un file invece di un URL?

Non per i post. L'API Accounts pubblica solo a partire da URL, bozze incluse, e il suo unico endpoint di caricamento, /business/comment/image/upload/, accetta un'immagine per commento come dati di form multipart, in JPG, JPEG, WebP o PNG fino a 5 MB, e restituisce un image_uri per un commento o una risposta. Il caricamento di file a blocchi appartiene alla Content Posting API su developers.tiktok.com, un'API separata con app proprie, dove il metodo di trasferimento si chiama FILE_UPLOAD.

Che succede con un URL non verificato?

TikTok rifiuta di pubblicare da quell'URL. Il riferimento dell'API di TikTok per le aziende enuncia la regola per video e foto, ma non assegna un codice di risposta proprio, quindi leggi codice e messaggio nella risposta. La Content Posting API su developers.tiktok.com indica lo stesso caso con url_ownership_unverified, con HTTP 403. Per provare l'endpoint dei video prima che una proprietà sia verificata, TikTok mette a disposizione un URL di video di prova che non richiede verifica:

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

Come easyCoexistence porta i tuoi media su TikTok?

Attraverso un unico prefisso URL verificato proprio, https://easycoexistence.com/api/social/media/. publish_tiktok_post accetta il tuo link HTTPS, rifiuta http:// prima di inviare qualsiasi cosa e consegna a TikTok un link sotto quel prefisso che contiene un token firmato con il nome del file, scade dopo 6 ore e conserva l'estensione del file. Quando TikTok lo recupera, easyCoexistence verifica il token, controlla che il tuo link usi HTTPS su un indirizzo pubblico e trasmette il file direttamente dal tuo link, incluse le richieste con range e i reindirizzamenti, senza memorizzarlo. Se il tuo link non funziona, TikTok non può scaricare il file e il post fallisce.

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

Errori comuni

  • Verificare un sottodominio e ospitare i file sul dominio padre. Un video.example.com verificato copre i propri sottodomini, non example.com in sé.
  • Servire il file di firma del prefisso tramite un reindirizzamento. TikTok non segue i reindirizzamenti per un prefisso URL e considera non valida una risposta 3xx.
  • Salvare il file di firma come name.txt.txt. TikTok vuole che il nome del file corrisponda a file_name, con una sola estensione .txt.
  • Eliminare il file subito dopo la chiamata di pubblicazione. TikTok lo scarica successivamente, per fino a un'ora, e fa fallire il post se il link smette di funzionare.
Farlo con EasyCoexistence

Da US$ 9 fino a US$ 0.75 per connessione al mese, a scalare man mano che aggiungi connessioni, con i primi 3 giorni di prova gratuita.

Domande frequenti

Perché TikTok richiede URL multimediali verificati?

TikTok dichiara che verificare la proprietà degli URL dei video la aiuta a rispettare le sue politiche su contenuti protetti da copyright e sicurezza degli utenti.

Un dominio TikTok verificato copre anche i suoi sottodomini?

Sì. I sottodomini di un dominio verificato risultano verificati, anche se /business/property/list/ li mostra solo se sono stati aggiunti.

L'API di TikTok per le aziende può pubblicare da un link S3 o CDN?

Sì, quando il link si trova sotto un dominio o un prefisso URL che l'app ha verificato, ad esempio un prefisso su un bucket o un percorso CDN che controlli.

Anche i post di foto richiedono URL verificati?

Sì. L'endpoint per le foto di TikTok afferma che i post di foto non possono essere pubblicati da URL di foto non verificati.

Continua a leggere

Collega il tuo primo canale in due minuti.

Nessuna revisione delle piattaforme da aspettare. Collega WhatsApp, Instagram, TikTok o un altro canale, poi chiedi alla tua AI di pubblicare, rispondere o fare un report, e guardala al lavoro.

  • 3 giorni gratis
  • Disdici quando vuoi
  • Solo API ufficiali
  • Monitorato 24/7

Verificato il