TOOL API

file_name_check

Checks whether one or more image or video file names have already been used under the same ad account (`advertiser_id`). File names must be unique within an advertiser account for ad images and videos. If you skip this check and later get a duplicate-name error when uploading via `/file/image/ad/upload/` or `/file/video/ad/upload/`, you must upload the file again.

ecommerceOAuth1 credits

Call information

Tool slug
tiktok-ads.file_name_check
Provider
TikTok for Business
Average response
0 ms
Calls in 7 days
0

Input parameters

advertiser_idrequired

Advertiser ID.

file_name

Use this top-level field when checking a single file name. In that case, `file_type` is also required. If checking multiple file names, use `files` instead.

file_type

Use this top-level field when checking a single file name. In that case, `file_name` is also required. If checking multiple file names, use `files` instead. Enum values: `VIDEO` (video), `IMAGE` (image). Default value: `VIDEO`.

files

Use this field to check multiple file names at once. If checking multiple names, `files` is required. Each item should include `file_name` and may include `file_type`; if omitted, `file_type` defaults to `VIDEO`. If checking a single file name instead, use top-level `file_name` and `file_type`. Maximum 20 items.