Synchronously uploads images as binary data.

  1. Restrictions
  2. Request
  3. Response
  4. Example


The maximum number of images per advertiser is 1000 + 2 × the number of ads.

Maximum of 100 images per method call. We recommend uploading no more than 3 images per call.

If images are identical, only one image is created.

Restrictions on the size of the image are listed in Requirements for images uploaded via the API.


Request structure in JSON format:

  "method": "add",
  "params": { /* params */
    "AdImages": [{  /* AdImageAddItem */
      "ImageData": (base64Binary), /* required */
      "Name": (string) /* required */
    }, ... ] /* required */
Parameter Type Description Required
Params structure (for JSON) / AddRequest structure (for SOAP)
AdImages array of AdImageAddItem Images to add (maximum of 100). Yes
AdImageAddItem structure
ImageData base64Binary

Image to upload: base64-encoded binary data.


When using the SOAP library, place the binary data directly in this field, and the library automatically encodes it as base64 during transmission.

When using JSON format, first encode the binary data in base64, then pass it as a string.