Criteo Audience API

openapi: 3.2.0
info:
  title: Criteo Audience API
  version: 2026-07
  description: 'Operations tagged Audience across 2 of this provider''s published API definitions: criteo-marketing-solutions-api-openapi.yml, criteo-retail-media-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.criteo.com
security:
- oauth: []
tags:
- name: Audience
paths:
  /2026-07/marketing-solutions/audience-segments:
    patch:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments
      description: Updates the properties of all segments with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned.
      operationId: UpdateAudienceSegments
      requestBody:
        description: Segment Update request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentBulkUpdateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list:
    parameters:
    - name: audience-segment-id
      in: path
      description: The id of the contact list audience-segment to amend
      required: true
      schema:
        type: string
        format: int32
    delete:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
      description: Delete all identifiers from a contact list audience-segment.
      operationId: DeleteContactListByAudienceSegment
      responses:
        '200':
          description: The Contact List was emptied
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeleteAudienceContactListResponse'
              example:
                data:
                  id: '1'
                  type: AudienceContactlist
                errors: []
                warnings:
                - traceId: 56ed4096-f96a-4944-8881-05468efe0ec9
                  type: deprecation
                  code: deprecated-field
                  instance: /audiences/314195
                  title: '''nbValidIds'' is deprecated'
                  detail: The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    patch:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
      description: Add/remove identifiers to or from a contact list audience-segment.
      operationId: UpdateContactListByAudienceSegment
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ContactlistAmendmentRequest'
        required: true
        x-bodyName: body
      responses:
        '200':
          description: Summary of created request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModifyAudienceResponse'
              example:
                data:
                  type: ContactlistAmendment
                  attributes:
                    contactListId: 12
                    operation: add
                    requestDate: '2018-12-10T10:00:50.0000000+00:00'
                    identifierType: madid
                    nbValidIdentifiers: 7343
                    nbInvalidIdentifiers: 13
                    sampleInvalidIdentifiers:
                    - InvalidIdentifier
                errors: []
                warnings:
                - traceId: 56ed4096-f96a-4944-8881-05468efe0ec9
                  type: deprecation
                  code: deprecated-field
                  instance: /audiences/314195
                  title: '''nbValidIds'' is deprecated'
                  detail: The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics:
    get:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics
      description: Returns the statistics of a contact list segment.
      operationId: GetAudienceSegmentContactListStatistics
      parameters:
      - name: audience-segment-id
        in: path
        description: The segment ID.
        required: true
        schema:
          type: string
          format: int32
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ContactListStatisticsEntityV1Response'
      security:
      - oauth:
        - MarketingSolutions_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/compute-sizes:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/compute-sizes
      description: Gets the size of all segments. An error is returned for those whose size calculation is not supported.
      operationId: ComputeAudienceSegmentsSizes
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentComputeSizesInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentSizeEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/create:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/create
      description: Creates all segments with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.
      operationId: CreateAudienceSegments
      requestBody:
        description: Segment creation parameter
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentBulkCreateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/delete:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/delete
      description: Delete the segments associated to the given audience IDs.
      operationId: DeleteAudienceSegments
      requestBody:
        description: Segment delete request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentBulkDeleteInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentIdEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/estimate-size:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/estimate-size
      description: Gets the size estimation of a non existent segment. An error is returned when size calculation is not supported.
      operationId: EstimateAudienceSegmentsSizes
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentEstimateSizeInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentSizeEstimationV1Response'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/in-market-brands:
    get:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/in-market-brands
      description: Returns a list with all available in-market brands that can be used to define an in-market segment.
      operationId: GetAudienceSegmentsInMarketBrands
      parameters:
      - name: advertiser-id
        in: query
        description: The advertiser ID.
        required: true
        schema:
          type: string
      - name: country
        in: query
        description: The ISO 3166-1 alpha-2 country code.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InMarketAudienceSegmentBrandEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/in-market-interests:
    get:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/in-market-interests
      description: Returns a list with all available in-market interests that can be used to define an in-market segment. These in-market interests correspond to the Google product taxonomy.
      operationId: GetAudienceSegmentsInMarketInterests
      parameters:
      - name: advertiser-id
        in: query
        description: The advertiser ID.
        required: true
        schema:
          type: string
      - name: country
        in: query
        description: The ISO 3166-1 alpha-2 country code.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InMarketAudienceSegmentInterestEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audience-segments/search:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audience-segments/search
      description: Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.
      operationId: SearchAudienceSegments
      parameters:
      - name: limit
        in: query
        description: The number of elements to be returned. The default is 50 and the maximum is 100.
        schema:
          maximum: 100
          minimum: 0
          type: integer
          format: int32
          default: 50
      - name: offset
        in: query
        description: The (zero-based) offset into the collection. The default is 0.
        schema:
          type: integer
          format: int32
          default: 0
      requestBody:
        description: Segment search filters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSegmentSearchInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences:
    patch:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences
      description: Updates the properties of all audiences with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned.
      operationId: UpdateAudiences
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceBulkUpdateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences/compute-sizes:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences/compute-sizes
      description: Gets the size of all audiences. An error is returned for those whose size calculation is not supported.
      operationId: ComputeAudiencesSizes
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceComputeSizesInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSizeEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences/create:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences/create
      description: Creates all audiences with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.
      operationId: CreateAudiences
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceBulkCreateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceEntityV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences/delete:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences/delete
      description: Deletes the audiences associated to the given audience IDs.
      operationId: DeleteAudiences
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceBulkDeleteInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceIdEntityV1ListResponse'
        '204':
          description: Success or partial success
          content:
            application/json: {}
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences/estimate-size:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences/estimate-size
      description: Gets the size estimation of a non existent audience. An error is returned when size calculation is not supported.
      operationId: EstimateAudiencesSizes
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceEstimateSizeInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceSizeEstimationV1Response'
      security:
      - oauth:
        - MarketingSolutions_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/marketing-solutions/audiences/search:
    post:
      tags:
      - Audience
      summary: /2026-07/marketing-solutions/audiences/search
      description: Returns a list of audiences that match the provided filters. If present, the filters are AND'ed together when applied.
      operationId: SearchAudiences
      parameters:
      - name: limit
        in: query
        description: The number of elements to be returned. The default is 50 and the maximum is 100.
        schema:
          maximum: 100
          minimum: 0
          type: integer
          format: int32
          default: 50
      - name: offset
        in: query
        description: The (zero-based) offset into the collection. The default is 0.
        schema:
          type: integer
          format: int32
          default: 0
      requestBody:
        description: Audience search filters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AudienceSearchInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AudienceEntityV1AudienceSearchMetadataV1ListResponse'
      security:
      - oauth:
        - MarketingSolutions_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audience-segments:
    patch:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audience-segments
      description: Updates the properties of all segments with a valid configuration, and returns the full segments. For those that cannot be updated, one or multiple errors are returned.
      operationId: bulkUpdateAudienceSegments
      parameters:
      - name: account-id
        in: path
        description: Account id
        required: true
        schema:
          type: string
      requestBody:
        description: Segment Update request
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RmAudienceSegmentBulkUpdateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmAudienceSegmentEntityV1ListResponse'
      security:
      - oauth:
        - RetailMedia_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list:
    get:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list
      description: Returns the statistics of a contact list segment.
      operationId: getAudienceSegmentContactListStatistics
      parameters:
      - name: account-id
        in: path
        description: Account Id
        required: true
        schema:
          type: string
      - name: audience-segment-id
        in: path
        description: Segment Id.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmContactListStatisticsEntityV1Response'
      security:
      - oauth:
        - RetailMedia_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audience-segments/create:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audience-segments/create
      description: Creates all segments with a valid configuration, and returns the full segments. For those that cannot be created, one or multiple errors are returned.
      operationId: bulkCreateAudienceSegments
      parameters:
      - name: account-id
        in: path
        description: Account Id
        required: true
        schema:
          type: string
      requestBody:
        description: Segment creation parameter
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RmAudienceSegmentBulkCreateInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmAudienceSegmentEntityV1ListResponse'
      security:
      - oauth:
        - RetailMedia_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audience-segments/delete:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audience-segments/delete
      description: Delete the segments associated to the given IDs.
      operationId: bulkDeleteAudienceSegments
      parameters:
      - name: account-id
        in: path
        description: Account id
        required: true
        schema:
          type: string
      requestBody:
        description: Segment delete request.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RmAudienceSegmentBulkDeleteInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmAudienceSegmentIdEntityV1ListResponse'
      security:
      - oauth:
        - RetailMedia_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audience-segments/search:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audience-segments/search
      description: Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.
      operationId: searchAudienceSegments
      parameters:
      - name: account-id
        in: path
        description: Account Id
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of elements to be returned. The default is 50 and the maximum is 500.
        schema:
          maximum: 500
          minimum: 0
          type: integer
          format: int32
          default: 50
      - name: offset
        in: query
        description: The (zero-based) offset into the collection. The default is 0.
        schema:
          type: integer
          format: int32
          default: 0
      requestBody:
        description: Segment search filters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RmAudienceSegmentSearchInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmAudienceSegmentEntityV1RmAudienceSegmentSearchMetadataV1ListResponse'
      security:
      - oauth:
        - RetailMedia_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/accounts/{account-id}/audiences/search:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/accounts/{account-id}/audiences/search
      description: Returns a list of audiences that match the provided filters. If present, the filters are AND'ed together when applied.
      operationId: searchAudiences
      parameters:
      - name: account-id
        in: path
        description: Account Id
        required: true
        schema:
          type: string
      - name: limit
        in: query
        description: The number of elements to be returned. The default is 50 and the maximum is 500.
        schema:
          maximum: 500
          minimum: 0
          type: integer
          format: int32
          default: 50
      - name: offset
        in: query
        description: The (zero-based) offset into the collection. The default is 0.
        schema:
          type: integer
          format: int32
          default: 0
      requestBody:
        description: Audience search filters.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RmAudienceSearchInputV1'
        required: true
        x-bodyName: request
      responses:
        '200':
          description: Success or partial success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RmAudienceEntityV1RmAudienceSearchMetadataV1ListResponse'
      security:
      - oauth:
        - RetailMedia_Audience_Read
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove
      description: Add/remove identifiers to or from a retail-media contact list audience-segment, with external audience segment id.
      operationId: AddRemoveContactListByAudienceSegment
      parameters:
      - name: audience-segment-id
        in: path
        description: The id of the contact list audience-segment to amend, we only accept external Id here
        required: true
        schema:
          type: string
          format: int64
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RetailMediaContactlistAmendmentRequest'
        required: true
        x-bodyName: body
      responses:
        '200':
          description: Summary of created request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RetailMediaContactlistOperation'
              example:
                type: AddRemoveContactlistResult
                data:
                  contactListId: 568708742535471104
                  operation: add
                  requestDate: '2018-12-10T10:00:50.0000000+00:00'
                  identifierType: madid
                  nbValidIdentifiers: 7343
                  nbInvalidIdentifiers: 13
                  sampleInvalidIdentifiers:
                  - InvalidIdentifier
                errors:
                - traceId: 667ac683ac797284.667ac683ac797284<:667ac683ac797284
                  type: availability
                  code: internal-error
                  instance: ''
                  title: Internal error
                warnings:
                - traceId: 56ed4096-f96a-4944-8881-05468efe0ec9
                  type: deprecation
                  code: deprecated-field
                  instance: /audiences/314195
                  title: '''nbValidIds'' is deprecated'
                  detail: The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers'
      security:
      - oauth:
        - RetailMedia_Audience_Manage
    servers:
    - url: https://api.criteo.com
  /2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/clear:
    post:
      tags:
      - Audience
      summary: /2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/clear
      description: Delete all identifiers from a retail-media contact list audience-segment, with external audience segment id.
      operationId: ClearContactListByAudienceSegment
      parameters:
      - name: audience-segment-id
        in: path
        description: The id of the contact list audience-segment to amend, we only accept external Id here
        required: true
        schema:
          type: string
          format: int64
      responses:
        '204':
          description: The Contact List identifiers were deleted
          content:
            application/json: {}
      security:
      - oauth:
        - RetailMedia_Audience_Manage
    servers:
    - url: https://api.criteo.com
components:
  schemas:
    AudienceIdEntityV1:
      type:
      - object
      - 'null'
      description: Audience entity with only its ID
      x-criteo-canonical:
        infoType: entity
        name: Audience
        version: v1
    AudienceEntityV1Resource:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/AudienceEntityV1'
        id:
          type:
          - string
          - 'null'
          description: Id of the entity
        type:
          type:
          - string
          - 'null'
      description: A class that represents a domain entity exposed by an API
    LookalikeCreateV1:
      required:
      - seedSegmentId
      type: object
      properties:
        seedSegmentId:
          type: string
          description: Segment from which the Lookalike segment will be generated
        targetSize:
          type: integer
          description: Desired size of the generated Lookalike segment
          format: int64
      description: Settings to target users close to a given seed segment.
    AudienceSegmentUpdateEntityV1:
      type: object
      properties:
        description:
          $ref: '#/components/schemas/NillableString'
        inMarket:
          $ref: '#/components/schemas/InMarketUpdateV1'
        location:
          $ref: '#/components/schemas/LocationUpdateV1'
        lookalike:
          $ref: '#/components/schemas/LookalikeUpdateV1'
        name:
          type: string
          description: Name of the segment
        prospecting:
          $ref: '#/components/schemas/ProspectingUpdateV1'
        retargeting:
          $ref: '#/components/schemas/RetargetingUpdateV1'
      description: Set of rules that defines specific people to target.
      x-criteo-canonical:
        infoType: entity
        name: AudienceSegment
        version: v1
    InMarketAudienceSegmentBrandEntityV1:
      type:
      - object
      - 'null'
      properties:
        name:
          type:
          - string
          - 'null'
          description: Name of the in-market segment brand
        size:
          type:
          - integer
          - 'null'
          description: Size of the in-market segment brand
          format: int32
      description: In-market segment brand entity
      x-criteo-canonical:
        infoType: entity
        name: InMarketAudienceSegmentBrand
        version: v1
    AudienceSegmentSearchEntityV1Resource:
      type: object
      properties:
        attributes:
          $ref: '#/components/schemas/AudienceSegmentSearchEntityV1'
        type:
          type: string
      description: A top-level object that encapsulates a Criteo API response for a single value
    InMarketV1:
      type:
      - object
      - 'null'
      properties:
        brandIds:
          uniqueItems: true
          type:
          - array
          - 'null'
          items:
            type: string
          description: Choose the brands your segment might be interested in
        buyingPower:
          uni

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