upload_tiktok_images

TikTok Ads Write

Upload images to TikTok Asset Library from public URLs

Endpoint

POST https://api.adspirer.ai/api/v1/tools/upload_tiktok_images/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

Upload images to TikTok Asset Library from public URLs.

Returns TikTok image_ids that can be used for:
- add_tiktok_ad with image_ids — supporting image assets alongside a video creative

Note: TikTok rejects image-ONLY in-feed ads. image_ids cannot stand alone as an ad
creative; pair them with video_url/video_id, or use tiktok_item_id (Spark Ad).

TikTok downloads images directly from the provided URLs (no intermediate storage needed).

Supported formats: JPG, PNG, WEBP. Max 10MB per image. Max 20 images per call.

Use this tool when the user provides image URLs and you need TikTok image IDs.

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`image_urls`	`array` required	List of public HTTPS image URLs to upload to TikTok (1-20). TikTok downloads images directly from these URLs. Supported formats: JPG, PNG, WEBP. Max 10MB per image.
`advertiser_id`	`string` optional	TikTok advertiser ID (optional).

Example request

{
  "arguments": {
    "image_urls": [
      "string"
    ],
    "advertiser_id": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for upload_tiktok_images)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "upload_tiktok_images"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "upload_tiktok_images"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "upload_tiktok_images",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: TikTok Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai