Criteo Marketing Solutions API

openapi: 3.0.1
info:
  title: Criteo API
  description: Criteo API - MarketingSolutions
  version: 2026-07
servers:
- url: https://api.criteo.com
paths:
  /2026-07/advertisers/me:
    get:
      tags:
      - Advertiser
      summary: /2026-07/advertisers/me
      description: Fetch the portfolio of Advertisers for this account
      operationId: ListAdvertisers
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPortfolioResponse'
              example:
                data:
                - type: advertiser
                  id: '13'
                  attributes:
                    advertiserName: ClientName1
                - type: advertiser
                  id: '1352'
                  attributes:
                    advertiserName: ClientName2
                - type: advertiser
                  id: '73550'
                  attributes:
                    advertiserName: ClientName3
                errors: []
                warnings: []
      security:
      - oauth: []
  /2026-07/log-level/advertisers/{advertiser-id}/report:
    post:
      tags:
      - Analytics
      summary: /2026-07/log-level/advertisers/{advertiser-id}/report
      description: This Statistics endpoint provides publisher data.
      operationId: GetTransparencyReport
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser ID to fetch the transparency data for. The advertiser must already exist. Must be greater than 0.
        required: true
        schema:
          type: string
          format: int32
      requestBody:
        description: The query message.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TransparencyQueryMessage'
            example:
              shouldDisplayProductIds: false
              startDate: '2024-01-01T00:00:00.0000000+00:00'
              endDate: '2024-01-04T00:00:00.0000000+00:00'
          application/xml:
            schema:
              $ref: '#/components/schemas/TransparencyQueryMessage'
            example: "<TransparencyQueryMessage xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n  <EndDate>2024-01-04T00:00:00</EndDate>\r\n  <StartDate>2024-01-01T00:00:00</StartDate>\r\n  <ShouldDisplayProductIds>false</ShouldDisplayProductIds>\r\n</TransparencyQueryMessage>"
          text/xml:
            schema:
              $ref: '#/components/schemas/TransparencyQueryMessage'
            example: "<TransparencyQueryMessage xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n  <EndDate>2024-01-04T00:00:00</EndDate>\r\n  <StartDate>2024-01-01T00:00:00</StartDate>\r\n  <ShouldDisplayProductIds>false</ShouldDisplayProductIds>\r\n</TransparencyQueryMessage>"
          application/*+xml:
            schema:
              $ref: '#/components/schemas/TransparencyQueryMessage'
            example: "<TransparencyQueryMessage xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n  <EndDate>2024-01-04T00:00:00</EndDate>\r\n  <StartDate>2024-01-01T00:00:00</StartDate>\r\n  <ShouldDisplayProductIds>false</ShouldDisplayProductIds>\r\n</TransparencyQueryMessage>"
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TransparencyReportListResponse'
            application/xml:
              schema:
                $ref: '#/components/schemas/TransparencyReportListResponse'
            text/xml:
              schema:
                $ref: '#/components/schemas/TransparencyReportListResponse'
      security:
      - oauth:
        - MarketingSolutions_Analytics_Read
  /2026-07/marketing-solutions/ad-sets:
    patch:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets
      description: Patch a list of AdSets.
      operationId: PatchAdSets
      requestBody:
        description: List of adsets to patch.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestsPatchAdSetV26Q1'
        required: true
        x-bodyName: adSets
      responses:
        '200':
          description: Patched attributes for adSets specified in the request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesAdSetIdV26Q1'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
    post:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets
      description: Create an ad set with the provided parameters
      operationId: CreateAdSet
      requestBody:
        description: the ad sets to create
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAdSetV26Q1Request'
        required: true
        x-bodyName: adSet
      responses:
        '201':
          description: The ad set that has been created and errors / warnings
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseReadAdSetV26Q1'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ad-sets/{ad-set-id}:
    get:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}
      description: Get the data for the specified ad set
      operationId: GetAdSet
      parameters:
      - name: ad-set-id
        in: path
        description: Id of the ad set
        required: true
        schema:
          type: string
      responses:
        '200':
          description: data for the ad set
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseReadAdSetV26Q1'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Read
  /2026-07/marketing-solutions/ad-sets/{ad-set-id}/audience:
    put:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}/audience
      description: Link or unlink an audience with an ad set
      operationId: UpdateAdSetAudience
      parameters:
      - name: ad-set-id
        in: path
        description: The ad set ID.
        required: true
        schema:
          type: string
      requestBody:
        description: Ad set-Audience update request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdSetAudienceLinkInputEntityV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdSetAudienceLinkEntityV1Response'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids:
    get:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids
      description: Get the Category Bids for all valid Categories associated to an Ad Set
      operationId: GetAdSetCategoryBids
      parameters:
      - name: ad-set-id
        in: path
        description: Id of the Ad Set
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of Category Bids for all valid Categories associated to an Ad Set.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdSetCategoryBidListResponse'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Read
    patch:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids
      description: "Update the Category Bids for given Categories associated to an Ad Set\r\nPatch Category Bids for one or more Categories in a single request. Partial success policy is followed."
      operationId: PatchAdSetCategoryBids
      parameters:
      - name: ad-set-id
        in: path
        description: Id of the Ad Set
        required: true
        schema:
          type: string
      requestBody:
        description: Collection of category bids to update
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchAdSetCategoryBidListRequest'
        required: true
        x-bodyName: categoryBidsToUpdate
      responses:
        '200':
          description: List of updated Category Bids for given Categories associated to an Ad Set, used for partial successes as well.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchAdSetCategoryBidResultListResponse'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers:
    get:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers
      description: Get the Display Multipliers for all valid Categories associated to an Ad Set
      operationId: GetDisplayMultipliers
      parameters:
      - name: ad-set-id
        in: path
        description: Id of the Ad Set
        required: true
        schema:
          type: string
      responses:
        '200':
          description: List of Display Multipliers for all valid Categories associated to an Ad Set.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AdSetDisplayMultiplierListResponse'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Read
    patch:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers
      description: "Update the Display Multipliers for given Categories associated to an Ad Set\r\nPatch Display Multipliers for one or more Categories in a single request. Partial success policy is followed."
      operationId: PatchDisplayMultipliers
      parameters:
      - name: ad-set-id
        in: path
        description: Id of the Ad Set
        required: true
        schema:
          type: string
      requestBody:
        description: List of display multiplier values to change
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PatchAdSetDisplayMultiplierListRequest'
        required: true
        x-bodyName: displayMultipliersToUpdate
      responses:
        '200':
          description: List of updated Display Multipliers for given Categories associated to an Ad Set. Make sure to check the error field in the response since a partial success will result in a 200 response code.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PatchAdSetDisplayMultiplierResultListResponse'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ad-sets/search:
    post:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/search
      description: "Search for ad sets based on provided criteria.\r\nThis returns the full configuration of ad sets matching those criteria.\r\nField projection can be used if only a subset of fields is required, instead of the full configuration.\r\n            \r\nIf specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field."
      operationId: SearchAdSets
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AdSetSearchRequestV26Q1'
        x-bodyName: request
      responses:
        '200':
          description: data for the ad sets
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesReadAdSetV26Q1'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Read
  /2026-07/marketing-solutions/ad-sets/start:
    post:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/start
      description: Start the specified list of ad sets
      operationId: StartAdSets
      requestBody:
        description: All the ad sets to start
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestsAdSetId'
        x-bodyName: adSets
      responses:
        '200':
          description: List of ad sets that have been started and errors / warnings by ad set
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesAdSetId'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ad-sets/stop:
    post:
      tags:
      - Campaign
      summary: /2026-07/marketing-solutions/ad-sets/stop
      description: Stop the specified list of ad sets
      operationId: StopAdSets
      requestBody:
        description: All the ad sets to stop
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestsAdSetId'
        x-bodyName: adSets
      responses:
        '200':
          description: List of ad sets that have been stopped and errors / warnings by ad set
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponsesAdSetId'
      security:
      - oauth:
        - MarketingSolutions_Campaign_Manage
  /2026-07/marketing-solutions/ads/{ad-id}/product-boost:
    get:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-boost
      description: Fetch all boosting associations and configurations
      operationId: FetchBoostedAdAssociations
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceCollectionOutcomeOfBoostedAdProductSet'
      security:
      - oauth:
        - MarketingSolutions_Reco_Read
  /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}:
    delete:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}
      description: Delete association and configuration.
      operationId: DeleteBoostedAdAssociation
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      - name: product-set-id
        in: path
        description: ID of the product set
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfBoostedAdProductSet'
      security:
      - oauth:
        - MarketingSolutions_Reco_Manage
    get:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}
      description: Fetch boosting association and configuration
      operationId: FetchBoostedAdAssociation
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      - name: product-set-id
        in: path
        description: ID of the product set
        required: true
        schema:
          type: string
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfBoostedAdProductSet'
      security:
      - oauth:
        - MarketingSolutions_Reco_Read
    post:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}
      description: Create or update product boosting configuration
      operationId: CreateBoostedAdAssociation
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      - name: product-set-id
        in: path
        description: ID of the product set
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValueResourceInputOfBoostingConfigurationRequest'
        x-bodyName: boostedAdProductSetAssociationRequest
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfBoostedAdProductSet'
        '201':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfBoostedAdProductSet'
      security:
      - oauth:
        - MarketingSolutions_Reco_Manage
  /2026-07/marketing-solutions/ads/{ad-id}/product-filter:
    delete:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-filter
      description: Disable product filtering for a given ad
      operationId: DisableProductFiltering
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfProductFilterConfig'
      security:
      - oauth:
        - MarketingSolutions_Reco_Manage
    get:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-filter
      description: Fetch product filtering configuration for a given ad
      operationId: FetchProductFilteringConfig
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful operation. Returns the product filtering configuration if it exists, or empty data if it doesn't.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfProductFilterConfig'
      security:
      - oauth:
        - MarketingSolutions_Reco_Read
    post:
      tags:
      - Reco
      summary: /2026-07/marketing-solutions/ads/{ad-id}/product-filter
      description: Enable product filtering for a given ad
      operationId: EnableProductFiltering
      parameters:
      - name: ad-id
        in: path
        description: ID of the ad
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ValueResourceInputOfCreateProductFilterRequest'
        x-bodyName: createProductFilterRequest
      responses:
        '200':
          description: successful operation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValueResourceOutcomeOfProductFilterConfig'
      security:
      - oauth:
        - MarketingSolutions_Reco_Manage
  /2026-07/marketing-solutions/ads/{id}:
    delete:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/ads/{id}
      description: Delete an Ad
      operationId: DeleteAd
      parameters:
      - name: id
        in: path
        description: The ad identifier to delete.
        required: true
        schema:
          type: string
          format: int32
      responses:
        '204':
          description: The ad was deleted.
      security:
      - oauth:
        - MarketingSolutions_Creative_Manage
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/ads/{id}
      description: Get an Ad with its id
      operationId: GetAd
      parameters:
      - name: id
        in: path
        description: The ad identifier to retrieve.
        required: true
        schema:
          type: string
          format: int32
      responses:
        '200':
          description: The found ad is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfAd'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/ads:
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
      description: Get the list of self-services Ads for a given advertiser
      operationId: GetAdvertiserAds
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of ads to be returned. The default is 50.
        schema:
          type: integer
          format: int32
          nullable: true
      - name: offset
        in: query
        description: The (zero-based) offset into the collection of ads. The default is 0.
        schema:
          type: integer
          format: int32
          nullable: true
      responses:
        '200':
          description: The list of self-services Ads is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceCollectionOutcomeOfAd'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
    post:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/ads
      description: Create an Ad
      operationId: CreateAdvertiserAd
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfAdWrite'
        required: true
        x-bodyName: request
      responses:
        '201':
          description: The created Ad is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfAd'
      security:
      - oauth:
        - MarketingSolutions_Creative_Manage
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons:
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
      description: Get the list of self-services Coupons for a given advertiser
      operationId: GetAdvertiserCoupons
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of coupons to be returned. The default is 50.
        schema:
          type: integer
          format: int32
          nullable: true
      - name: offset
        in: query
        description: The (zero-based) offset into the collection of coupons. The default is 0.
        schema:
          type: integer
          format: int32
          nullable: true
      responses:
        '200':
          description: The list of self-services Coupons is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceCollectionOutcomeOfCoupon'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
    post:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons
      description: Create a Coupon
      operationId: CreateAdvertiserCoupon
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfCreateCoupon'
        required: true
        x-bodyName: request
      responses:
        '201':
          description: The created Coupon is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCoupon'
      security:
      - oauth:
        - MarketingSolutions_Creative_Manage
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes:
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes
      description: Get the list of Coupon supported sizes
      operationId: GetAdvertiserCouponSupportedSizes
      parameters:
      - name: ad-set-id
        in: query
        description: The ad set id on which you want to check the Coupon supported sizes.
        schema:
          type: string
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The list of Coupon supported sizes is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCouponSupportedSizes'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}:
    delete:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
      description: Delete a Coupon
      operationId: DeleteAdvertiserCoupon
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The Coupon identifier to delete.
        required: true
        schema:
          type: string
      responses:
        '204':
          description: The Coupon was deleted.
      security:
      - oauth:
        - MarketingSolutions_Creative_Manage
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
      description: Get a Coupon with its id
      operationId: GetAdvertiserCoupon
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The Coupon identifier to retrieve.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: The found Coupon is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCoupon'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
    put:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}
      description: Edit a specific Coupon
      operationId: EditAdvertiserCoupon
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: id
        in: path
        description: The Coupon identifier to edit.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfUpdateCoupon'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: The edited Coupon is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCoupon'
      security:
      - oauth:
        - MarketingSolutions_Creative_Manage
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview:
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview
      description: Get the preview of a specific Coupon
      operationId: GetAdvertiserCouponPreview
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: height
        in: query
        description: The height of the coupon to preview.
        schema:
          type: integer
          format: int32
      - name: id
        in: path
        description: The Coupon identifier to preview.
        required: true
        schema:
          type: string
      - name: width
        in: query
        description: The width of the coupon to preview.
        schema:
          type: integer
          format: int32
      responses:
        '200':
          description: The preview HTML of a specific Coupon is returned.
          content:
            text/html:
              schema:
                type: string
            application/json:
              schema:
                type: string
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
  /2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives:
    get:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
      description: Get the list of self-services Creatives for a given advertiser
      operationId: GetAdvertiserCreatives
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of creatives to be returned. The default is 50.
        schema:
          type: integer
          format: int32
          nullable: true
      - name: offset
        in: query
        description: The (zero-based) offset into the collection of creatives. The default is 0.
        schema:
          type: integer
          format: int32
          nullable: true
      responses:
        '200':
          description: The list of self-services Creatives is returned.This list will contain creatives in draft status as well which will have some properties as null
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceCollectionOutcomeOfCreativeRead'
      security:
      - oauth:
        - MarketingSolutions_Creative_Read
    post:
      tags:
      - Creative
      summary: /2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives
      description: Create a Creative
      operationId: CreateAdvertiserCreative
      parameters:
      - name: advertiser-id
        in: path
        description: The advertiser identifier.
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ResourceInputOfCreativeWrite'
        required: true
        x-bodyName: request
      responses:
        '201':
          description: The created creative is returned.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResourceOutcomeOfCreative'
      security:
      - oauth:
        - Marketing

# --- truncated at 32 KB (371 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/criteo/refs/heads/main/openapi/criteo-marketing-solutions-api-openapi.yml