/

Browse the help center

List media library files

The media library's files, newest first unless 'sort' says otherwise.

Reference

GET https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do

The media library's files, newest first unless 'sort' says otherwise. 'available' is false when the network's file storage service is switched off; the library is empty then and uploads are refused. Filters: 'kind' (VIDEO, IMAGE, HTML5), 'query' (part of the name or file name), 'advertiserId' (the advertiser a file was uploaded for), 'width' and 'height' together (exact pixel size, as an image or HTML5 creative of that size needs). Each file carries 'usedIn', the number of live creatives serving it, and 'url', a link to view it. Pages: 'start' and 'limit' (at most 100); 'total' counts every match and 'more' says whether another page exists. Requires the MEDIA_LIBRARY permission and view rights on campaigns.

Query Params

kind string

VIDEO, IMAGE or HTML5

VIDEO

query string

Part of the file's name or original file name

spring

advertiserId integer

Only files uploaded for this advertiser

1001

width integer

Exact width in pixels; used together with height

300

height integer

Exact height in pixels; used together with width

250

start integer

Index of the first file to return

0

limit integer

Files per page, at most 100

25

sort string

CREATED, NAME or SIZE

CREATED

dir string

ASC or DESC

DESC

Responses

200

{success, available, total, more, start, limit, assets:[{id, name, kind, advertiserId, advertiserName, fileName, contentType, fileSize, width, height, duration, video, url, usedIn, createdAt, createdBy}]}

400

Bad request — invalid or missing parameters

401

Authentication error

403

The role lacks MEDIA_LIBRARY or campaign view rights

Language

cURL Request

curl --request GET \
  --url 'https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300' \
  --header 'X-Api-Key: YOUR_API_KEY'

Python Request

import requests

response = requests.request("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300", headers={"X-Api-Key": "YOUR_API_KEY"})
print(response.json())

Node Request

const response = await fetch('https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300', {
  method: 'GET',
  headers: { 'X-Api-Key': 'YOUR_API_KEY' },
});

console.log(await response.json());

Java Request

HttpClient client = HttpClient.newHttpClient();

HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300"))
    .header("X-Api-Key", "YOUR_API_KEY")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

C# Request

using var client = new HttpClient();

var request = new HttpRequestMessage(new HttpMethod("GET"), "https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300");
request.Headers.Add("X-Api-Key", "YOUR_API_KEY");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Go Request

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300", nil)
	req.Header.Set("X-Api-Key", "YOUR_API_KEY")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

PHP Request

<?php
$ch = curl_init("https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-Api-Key: YOUR_API_KEY"]);

echo curl_exec($ch);
curl_close($ch);

Ruby Request

require 'net/http'
require 'json'

uri = URI("https://YOUR-NETWORK-DOMAIN/rest-api/media-library/assets.do?advertiserId=1001&kind=VIDEO&query=spring&width=300")
request = Net::HTTP::Get.new(uri)
request['X-Api-Key'] = 'YOUR_API_KEY'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
puts response.body