Upload Ads

Upload a video file directly to AdManage for ad creation. Images and Videos are supported.

curl -X POST "https://api.admanage.ai/upload" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@/path/to/your/file.mp4"

const formData = new FormData();
formData.append('file', /* your file object */);

fetch('https://api.admanage.ai/upload', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

import requests

files = {
    'file': open('path/to/your/file.mp4', 'rb')
}
headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}
response = requests.post(
    'https://api.admanage.ai/upload',
    headers=headers,
    files=files
)
print(response.json())

{
  "success": true,
  "url": "https://media.admanage.ai/company-name/filename.png",
  "filename": "filename_suffix.png",
  "originalName": "filename.png",
  "wasRenamed": true,
  "dimensions": {
    "format": "png",
    "size": 145523,
    "width": 960,
    "height": 694,
    "space": "srgb",
    "channels": 3,
    "depth": "uchar",
    "density": 72,
    "isProgressive": false,
    "hasProfile": false,
    "hasAlpha": false,
    "exif": {
      "type": "Buffer",
      "data": [77, 77, 0, 42, 0, 0, 0, 8, 0, 1, 135, 105, 0, 4, 0, 0, 0, 1, 0, 0, 0, 26, 0, 0, 0, 0, 0, 3, 160, 1, 0, 3, 0, 0, 0, 1, 0, 1, 0, 0, 160, 2, 0, 4, 0, 0, 0, 1, 0, 0, 3, 192, 160, 3, 0, 4, 0, 0, 0, 1, 0, 0, 2, 182, 0, 0, 0, 0]
    }
  },
  "size": 145523,
  "sizeFormatted": "142.11 KB"
}

Parameters

file

required

The video file to upload. Supported formats: MP4, MOV, AVI. Maximum size: 100MB.

Upload from URL

Upload a video from a URL to AdManage for ad creation.

curl -X POST "https://api.admanage.ai/upload/url" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/video.mp4"}'

fetch('https://api.admanage.ai/upload/url', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    url: 'https://example.com/video.mp4'
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
}
response = requests.post(
    'https://api.admanage.ai/upload/url',
    headers=headers,
    json={'url': 'https://example.com/video.mp4'}
)
print(response.json())

{
  "success": true,
  "url": "https://media.admanage.ai/admanage.ai/video_sample_xyz123.mp4",
  "filename": "video_sample_xyz123.mp4",
  "originalName": "video.mp4",
  "wasRenamed": true,
  "id": 11110,
  "dimensions": {
    "format": "mp4",
    "size": 12582912,
    "width": 1280,
    "height": 720,
    "duration": 25.2,
    "bitrate": 4000000,
    "framerate": 30
  },
  "size": 12582912,
  "sizeFormatted": "12.00 MB"
}

Parameters

string

required

The URL of the video file to upload. Must be publicly accessible and point to a supported video format.

Response Fields

boolean

Indicates whether the upload was successful.

string

The CDN URL where the uploaded file can be accessed.

string

The final filename of the uploaded file (may include suffix if renamed).

string

The original filename of the uploaded file.

boolean

Indicates whether the file was renamed during upload to avoid conflicts.

number

Unique identifier for the uploaded file. Use this ID to reference the file in other API calls.

object

Detailed information about the file’s dimensions and metadata.

Show dimensions properties

string

The format of the uploaded file (e.g., “png”, “mp4”, “jpg”).

number

The size of the file in bytes.

number

The width of the image/video in pixels.

number

The height of the image/video in pixels.

number

(Video files only) The duration of the video in seconds.

number

(Video files only) The bitrate of the video.

number

(Video files only) The framerate of the video.

string

(Image files only) The color space of the image.

number

(Image files only) The number of color channels.

string

(Image files only) The bit depth of the image.

number

(Image files only) The pixel density (DPI).

boolean

(Image files only) Whether the image is progressive.

boolean

(Image files only) Whether the image has a color profile.

boolean

(Image files only) Whether the image has an alpha channel.

object

(Image files only) EXIF metadata from the image file.

number

The size of the uploaded file in bytes.

string

Human-readable formatted file size (e.g., “142.11 KB”, “12.00 MB”).

Error Responses

{
  "success": false,
  "error": "FILE_TOO_LARGE",
  "message": "File size exceeds the maximum limit of 100MB",
  "details": {
    "fileSize": 157286400,
    "maxSize": 104857600
  }
}

{
  "success": false,
  "error": "INVALID_FORMAT",
  "message": "Unsupported file format. Supported formats: MP4, MOV, AVI, PNG, JPG, JPEG",
  "details": {
    "detectedFormat": "webp"
  }
}

{
  "success": false,
  "error": "URL_NOT_ACCESSIBLE",
  "message": "The provided URL is not accessible or does not contain a valid file",
  "details": {
    "url": "https://example.com/invalid.mp4"
  }
}

Overview

APIs

Parameters

Upload from URL

Parameters

Response Fields

Error Responses

​Parameters

​Upload from URL

​Parameters

​Response Fields

​Error Responses

Parameters

Upload from URL

Parameters

Response Fields

Error Responses