Get a creative
const url = 'https://ads.wortise.com/api/public/v1/creatives/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};
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://ads.wortise.com/api/public/v1/creatives/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --header 'x-api-key: <x-api-key>'Reads one creative of the organization.
Requires the creatives:read scope.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Creative UUID.
Responses
Section titled “Responses”The creative.
object
Ref to ad_groups collection. When set, this creative is resolved against its ad group instead of the campaign directly
object
object
object
Narrate the ad with an AI voice, one line per scene.
Language of the narration. Omit to narrate in the on-screen language.
Speaking speed, from 1 to 1.5; the pitch is kept.
Voice of the narration. cedar and onyx sound best in Spanish.
object
object
object
E.g: “1”, “20”.
object
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
Only explicitly requested targeting exclusions.
object
object
object
object
object
object
object
object
object
E.g: “1”, “20”.
object
object
object
object
Exact inventory locations or geographic areas to target.
object
object
object
object
object
object
object
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
object
object
Optional demographic filters. Age codes are ranges: -18=under 18, 18=18–24, 25=25–34, 35=35–44, 45=45–54, 55=55–64, 65=65+. Adults 18+ requires all six adult ranges, not just 18. Gender ?? means unknown, not all genders; omit gender on creation or use [] on update for unrestricted gender.
object
object
Ref to brands collection
object
object
object
object
object
object
object
object
object
HTML content of the creative. Optional until first render.
Creative ID in ADS service
Position of the creative inside its ad group
Ref to products collection
object
Relevant product image URLs as seen on the page (max 3).
The main price the page shows for the item.
The discounted price when the page also shows a higher regular price for the same item, 0 when it shows no discount. Never a price without taxes or per installment.
object
Destination URL (redirect)
object
object
object
object
object
object
Narrate the ad with an AI voice, one line per scene.
Language of the narration. Omit to narrate in the on-screen language.
Speaking speed, from 1 to 1.5; the pitch is kept.
Voice of the narration. cedar and onyx sound best in Spanish.
Example
{ "asset": { "aspectRatio": "5:4", "extension": "jpeg", "type": "image" }, "audience": { "app": { "list": [ { "platform": "android" } ] }, "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "location": [ { "source": "google_places", "type": "place" } ], "not": { "device": { "os": [ "android", "ios" ], "type": [ "mobile" ] }, "app": { "list": [ { "platform": "android" } ] }, "appFilters": { "platform": [ "android" ] }, "location": [ { "source": "google_places", "type": "place" } ], "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "user": { "gender": [ "female" ], "age": [ "-18" ] } }, "brand": { "adn": { "colorScheme": "light" } }, "cta": "contact_us", "isDraft": false, "locale": "en", "status": "enabled", "type": "banner", "v": { "additionalProperty": { "asset": { "aspectRatio": "5:4", "extension": "jpeg", "type": "image" } } }, "verification": "approved"}The API key is missing, invalid, disabled or expired.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key lacks the scope, or its owner lacks the dashboard permission.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The resource does not exist in the organization of the API key.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}The API key exceeded its rate limit; retry after the Retry-After seconds.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}Headers
Section titled “Headers”Seconds to wait before retrying.
Unexpected server error.
object
TRPC error code, e.g. UNAUTHORIZED, FORBIDDEN, NOT_FOUND, CONFLICT
Example
{ "code": "PARSE_ERROR"}© 2026 Wortise. All rights reserved.