How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Criteo Creative API

The Creative API from Criteo — 9 operation(s) for creative.

Criteo Creative API is one of 13 APIs that Criteo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Creative. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a changelog, and authentication docs.

This API exposes 17 operations across 9 paths, and defines 48 schemas. It is described by OpenAPI 3.2.0, at version 2026-07.

Requests are made against a single base URL, https://api.criteo.com.

17 operations 9 paths 48 schemas 3 DELETE8 GET4 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2026-07
Base URL
https://api.criteo.com/2026-07/retail-media
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Criteo Creative API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth) using the clientCredentials and authorizationCode flows. By default, every request must be authenticated.

Paths & Operations 17

Across 9 paths, the API surfaces 17 operations — 3 DELETE, 8 GET, 4 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Creative 17
DELETE
/2026-07/marketing-solutions/ads/{id}
/2026-07/marketing-solutions/ads/{id}
DeleteAd 1 param → 204
GET
/2026-07/marketing-solutions/ads/{id}
/2026-07/marketing-solutions/ads/{id}
GetAd 1 param → 200
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
GetAdvertiserAds 3 params → 200
POST
/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
CreateAdvertiserAd 1 param body → 201
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
GetAdvertiserCoupons 3 params → 200
POST
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
CreateAdvertiserCoupon 1 param body → 201
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes
GetAdvertiserCouponSupportedSizes 2 params → 200
DELETE
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
DeleteAdvertiserCoupon 2 params → 204
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
GetAdvertiserCoupon 2 params → 200
PUT
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
EditAdvertiserCoupon 2 params body → 200
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview
/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview
GetAdvertiserCouponPreview 4 params → 200
GET
/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
GetAdvertiserCreatives 3 params → 200
POST
/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
CreateAdvertiserCreative 1 param body → 201
DELETE
/2026-07/marketing-solutions/creatives/{id}
/2026-07/marketing-solutions/creatives/{id}
DeleteCreative 1 param → 204
GET
/2026-07/marketing-solutions/creatives/{id}
/2026-07/marketing-solutions/creatives/{id}
GetCreative 1 param → 200
PUT
/2026-07/marketing-solutions/creatives/{id}
/2026-07/marketing-solutions/creatives/{id}
EditCreative 1 param body → 200
POST
/2026-07/marketing-solutions/creatives/{id}/preview
/2026-07/marketing-solutions/creatives/{id}/preview
GenerateCreativePreview 3 params → 200

Schemas 48

The contract defines 48 schemas that model the data the API accepts and returns. The most detailed are Coupon (15 properties), Creative (12 properties), AdaptiveReadAttributes (12 properties), AdaptiveAttributes (12 properties). Each schema is shown below with its type and property counts.

Coupon
objectnull
Coupons are static images applied on ad set which can be displayed within an ad and link to a landing page.
15 properties
CommonProblem
object
Common problem object.
9 properties
ResourceCollectionOutcomeOfCoupon
object
A top-level object that encapsulates a Criteo API response for several entities.
3 properties
UpdateCoupon
object
Entity to edit a Coupon
2 properties 1 required
CreateCoupon
object
Entity to create a Coupon
11 properties 9 required
CreativeRead
objectnull
A CreativeRead is a project with the necessary information to display a creative
11 properties 4 required
ResourceInputOfCreateCoupon
object
A top-level object that encapsulates a Criteo API request for a single entity.
1 property
ResourceOfCreativeWrite
object
A class that represents a domain entity exposed by an API.
3 properties
ResourceCollectionOutcomeOfAd
object
A top-level object that encapsulates a Criteo API response for several entities.
3 properties
ImageSetBase64
object
Entity consists of multiple images in different ratios as a base-64 encoded and a headline text.
2 properties 1 required
ResourceOutcomeOfCoupon
object
A top-level object that encapsulates a Criteo API response for a single entity.
3 properties
ResourceOfCreative
objectnull
A class that represents a domain entity exposed by an API.
3 properties
Ad
objectnull
An ad is the binding that connects a creative with an ad set
8 properties
AdaptiveAttributes
objectnull
The attributes specific to Adaptive creatives
12 properties 9 required
Creative
objectnull
A creative is a project with the necessary information to display a creative
12 properties 4 required
ImageShape
object
Entity containing the shape and url of the image
2 properties 2 required
ResourceOfUpdateCoupon
object
A class that represents a domain entity exposed by an API.
3 properties
ResourceOfCouponSupportedSizes
objectnull
A class that represents a domain entity exposed by an API.
3 properties
ResourceOfCreateCoupon
object
A class that represents a domain entity exposed by an API.
3 properties
ResourceInputOfAdWrite
object
A top-level object that encapsulates a Criteo API request for a single entity.
1 property
ImageSet
object
Entity consists of multiple images in different ratios and a headline text.
2 properties 1 required
ImageSlide
object
Slide containing the image URLs
3 properties
ResourceOutcomeOfCouponSupportedSizes
object
A top-level object that encapsulates a Criteo API response for a single entity.
3 properties
ImageWriteAttributes
object
The attributes specific to create or update an Image creative
2 properties 2 required
VideoDetail
object
Entity consists of the url of the video, its duration and its shape.
3 properties 3 required
CreativeWrite
object
Entity to create or update a creative
8 properties 3 required
ResourceOutcomeOfAd
object
A top-level object that encapsulates a Criteo API response for a single entity.
3 properties
ResourceOfCoupon
objectnull
A class that represents a domain entity exposed by an API.
3 properties
Size
objectnull
Size entity containing width and height of the creative
2 properties
ResourceCollectionOutcomeOfCreativeRead
object
A top-level object that encapsulates a Criteo API response for several entities.
3 properties
DynamicAttributes
objectnull
The attributes specific to Dynamic creatives
7 properties
ResourceOfCreativeRead
object
A class that represents a domain entity exposed by an API.
3 properties
ResourceOfAdWrite
object
A class that represents a domain entity exposed by an API.
3 properties
ResourceInputOfUpdateCoupon
object
A top-level object that encapsulates a Criteo API request for a single entity.
1 property
CouponSupportedSizes
objectnull
Entity containing the list of Coupon supported sizes
2 properties
HtmlTagWriteAttributes
object
The attributes specific to create or update a HtmlTag creative
1 property 1 required
AdaptiveReadAttributes
objectnull
The attributes specific to Adaptive creatives read
12 properties
Tag
object
Entity specifying the html of the tag and its size
2 properties
AdWrite
object
Entity to create or update an ad
7 properties 4 required
CreateImageSlide
object
Slide containing the images of the same size as a base-64 encoded string
3 properties
ResourceInputOfCreativeWrite
object
A top-level object that encapsulates a Criteo API request for a single entity.
1 property
AdaptiveWriteAttributes
object
The attributes specific to create or update an Adaptive creative
12 properties 9 required
DynamicWriteAttributes
object
The attributes specific to create or update a Dynamic creative
7 properties 5 required
ImageAttributes
objectnull
The attributes specific to Image creatives
2 properties
HtmlTagAttributes
objectnull
The attributes specific to HtmlTag creatives
1 property
AdaptiveColors
objectnull
Entity consists of the color aliases of the creative's elements
6 properties 6 required
ResourceOfAd
objectnull
A class that represents a domain entity exposed by an API.
3 properties
ResourceOutcomeOfCreative
object
A top-level object that encapsulates a Criteo API response for a single entity.
3 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

criteo-creative-api-openapi.yml Raw ↑

Other APIs Criteo publishes across the network.

Criteo MCP Servers
Criteo Accounts API
Criteo Advertiser API
Criteo Analytics API
Criteo Audience API
Criteo Balance API
Criteo Billing API
Criteo Campaign API
Criteo Catalog API
Criteo Gateway API
Criteo Reco API
Criteo Segment API
Where this information came from

This is an independent, third-party profile of Criteo Creative API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.