List creatives
const url = 'https://portal.staging.arago-tech.com/creatives';const options = {method: 'GET', headers: {Authorization: '<Authorization>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://portal.staging.arago-tech.com/creatives \ --header 'Authorization: <Authorization>'Returns a list of creatives
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters”Query
Search query to filter creatives by name
Tags
List of tags to filter creatives by
From Date
Filter items with date on or after this timestamp
To Date
Filter items with date strictly before this timestamp. Must be after ‘from’ when both are provided.
From Date
Filter items with date on or after this timestamp
To Date
Filter items with date strictly before this timestamp. Must be after ‘from’ when both are provided.
Field
The field to sort by. This should be a valid field name in the context of the request.
Desc
The sort order. If true, the results will be sorted in descending order. If false, the results will be sorted in ascending order.
Offset
The offset of the first item
Limit
The maximum number of items to return (must be >= 10 and <= 1000)
Responses
Section titled “ Responses ”A successful response.
Response containing a list of creatives.
object
List of creatives
Creative details
object
The unique identifier of the creative in hexadecimal format
Tags associated with the creative
The name of the creative
The original URL of the creative
The URL of the creative thumbnail
The URL of the generated creative
The unique identifier of the dynamic content optimization of the creative
Indicates whether the creative is currently generating
The width of the creative
The height of the creative
The aspect ratio of the creative (width / height). Explicitly set or computed from non-zero dimensions. Leaving width, height and aspect_ratio at zero makes the creative eligible for every slot size with usable dimensions.
Free-form metadata of the creative as key/value pairs. Any key may be set, and none is required.
object
The UTC last updated date of the creative
The UTC created date of the creative
The format of the creative
The language of the creative
Flag indicating if full text search has been performed
Example
{ "creatives": [ { "id": "63e2d42a27ad5f2b345ca123", "tags": [ "tag1", "tag2", "tag3" ], "name": "Creative name", "source_url": "https://example.com/image.png", "thumbnail_url": "https://example.com/thumbnail.jpg", "generated_url": "https://example.com/generated_image.png", "dynamic_content_optimization_id": "63e2d42a27ad5f2b345ca123", "width": 100, "height": 100, "aspect_ratio": 1.7777777777777777, "updated_at": "2023-01-01T00:00:00Z", "created_at": "2023-01-01T00:00:00Z", "format": "FORMAT_UNSPECIFIED", "language": "LANGUAGE_UNSPECIFIED" } ]}Bad request
object
Example
{ "error": { "code": "BAD_REQUEST", "details": [ { "code": "MAX_ITEMS", "field": "line_items", "message": "value must contain no more than 3000 item(s)", "params": { "max": "3000" } } ], "message": "Bad request" }}Unauthorized
object
Example
{ "error": { "code": "UNAUTHORIZED", "message": "Unauthorized" }}Internal server error
object
Example
{ "error": { "code": "INTERNAL_ERROR", "message": "Internal server error" }}default
Section titled “default”An unexpected error response.
object
object
Examplegenerated
{ "code": 1, "message": "example", "details": [ { "@type": "example" } ]}