Log inStart Free Trial
easyCoexistence Official APIs

TikTok media URLs: verified domains and URL prefixes

TikTok's API for Business downloads post media from URLs: video_url, custom_thumbnail_url and photo_images. Each URL must sit on a domain or URL prefix whose ownership the developer app has verified. A domain is verified with a DNS TXT record, a prefix with a signature file placed under it, through /business/property/add/ and /business/property/verify/ with the app's ID and secret.

easyCoexistence serves your media to TikTok from its own verified URL prefix: publish_tiktok_post takes an HTTPS link from Claude, ChatGPT or your own code and streams the file from it when TikTok downloads, so your domain needs no verification.

Nov 16, 2023

Since then, TikTok refuses video URLs that are not on a verified domain or URL prefix.

Oct 15, 2025

Since then, the URL property endpoints also require the developer app's secret.

1 / 2

property_type values: 1 for a domain, 2 for a URL prefix.

0, 1, 2

property_status values: pending, verified, and not verified because the attempt failed and must be repeated.

Apr 7, 2023

Developers who published videos before then had those video URLs' domains set to verified automatically.

5 MB

Largest image /business/comment/image/upload/ accepts, as multipart form data, for a comment or a reply.

Which URLs does TikTok download?

Every media field in the two publish endpoints is a URL that TikTok fetches itself after accepting the call, so the file has to stay reachable until the download ends:

  • video_url: the video, which TikTok recommends keeping valid for at least 30 minutes.
  • custom_thumbnail_url: an image to use as the video's cover.
  • photo_images: up to 35 images for a photo post.
  • Timeout: TikTok gives the download an hour, then fails the post with video_pull_failed or photo_pull_failed.

What is the difference between a domain and a URL prefix?

What you prove you own, and therefore which URLs count as verified. A domain suits media on a host you own or control; a prefix suits a folder on a host you can only upload files to. TikTok's rules for each property type:

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

How do you verify a property?

Through two calls that authenticate with the developer app's app_id and secret instead of an account token, with the proof placed in between:

  • Add it: POST /business/property/add/ with url_property_meta, holding property_type and url; the answer gives signature, plus file_name for a prefix, with property_status 0.
  • Prove it: put the signature in a DNS TXT record for a domain, or in a public file named file_name, with a single .txt extension, under a prefix.
  • Check it: POST /business/property/verify/ with the same url_property_meta; property_status 1 means verified, and 2 means the attempt failed.
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

How do you list or remove properties?

GET /business/property/list/ with app_id and secret returns url_property_info_list, each entry with property_type, url, property_status, signature and file_name. Subdomains of a verified domain count as verified without a call of their own, but appear in the list only if they were added. POST /business/property/delete/ with app_id, secret and url_property_meta drops a property the app no longer owns or controls.

Can you upload a file instead of a URL?

Not for posts. The Accounts API publishes from URLs only, drafts included, and its one upload endpoint, /business/comment/image/upload/, takes a comment image as multipart form data, JPG, JPEG, WebP or PNG up to 5 MB, and returns an image_uri for a comment or reply. Chunked file upload belongs to the Content Posting API on developers.tiktok.com, a separate API with its own apps, where the transfer method is called FILE_UPLOAD.

What happens with a URL that is not verified?

TikTok refuses to publish from it. The API for Business reference states the rule for videos and photos but names no return code of its own for it, so read the code and message in the response. The Content Posting API on developers.tiktok.com calls the same case url_ownership_unverified, with HTTP 403. To try the video endpoint before any property is verified, TikTok publishes a test video URL that needs no verification:

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

How does easyCoexistence get your media to TikTok?

Through one verified URL prefix of its own, https://easycoexistence.com/api/social/media/. publish_tiktok_post takes your HTTPS link, refuses http:// before anything is sent, and gives TikTok a link under that prefix holding a signed token that names your file, expires after 6 hours and keeps your file's extension. When TikTok fetches it, easyCoexistence checks the token, confirms your link uses HTTPS on a public address, and streams the file straight from your link, range requests and redirects included, without storing it. If your link fails, TikTok cannot download the file and the post fails.

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

Common mistakes

  • Verifying a subdomain and hosting files on its parent. A verified video.example.com covers its own subdomains, not example.com itself.
  • Serving the prefix's signature file through a redirect. TikTok does not follow redirects for a URL prefix and treats a 3xx answer as invalid.
  • Saving the signature file as name.txt.txt. TikTok wants the file name to match file_name, with a single .txt extension.
  • Deleting the file right after the publish call. TikTok downloads it afterwards, for up to an hour, and fails the post if the link stops working.
Doing this with EasyCoexistence

US$ 9 to US$ 0.75 per connection per month, falling as you add connections, with the first 3 days free.

easyCoexistence is a multichannel API and MCP server that connects AI agents such as Claude and ChatGPT to WhatsApp, Instagram, TikTok, Facebook and more. On WhatsApp it uses Coexistence: the business keeps using its number in the WhatsApp Business app while the AI works through Meta's official API.

Frequently asked questions

Why does TikTok require verified media URLs?

TikTok says verifying ownership of video URLs helps it comply with its policies on copyrighted content and user safety.

Does a verified TikTok domain cover its subdomains?

Yes. Subdomains of a verified domain count as verified, though /business/property/list/ shows them only if they were added.

Can TikTok's API for Business publish from an S3 or CDN link?

Yes, when the link sits under a domain or URL prefix the app has verified, such as a prefix on a bucket or CDN path you control.

Do photo posts need verified URLs too?

Yes. TikTok's photo endpoint states that photo posts cannot be published from unverified photo URLs.

Keep reading

Connect your first channel in two minutes.

No platform reviews to wait for. Connect WhatsApp, Instagram, TikTok or another channel, then ask your AI to post, reply or report, and watch it work.

  • 3 days free
  • Cancel any time
  • Official APIs only
  • Monitored 24/7

Verified on