openapi: 3.0.1 info: title: Criteo API description: Criteo API - RetailMedia version: 2026-07 servers: - url: https://api.criteo.com paths: /2026-07/retail-media/account-management/accounts/{accountId}/brands/add: post: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/brands/add description: Add brands to an account operationId: AddBrands parameters: - name: accountId in: path description: the account id to update required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfRetailMediaBrands' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfRetailMediaBrands' security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/account-management/accounts/{accountId}/brands/remove: post: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/brands/remove description: Remove brands from an account operationId: RemoveBrands parameters: - name: accountId in: path description: the account id to update required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfRetailMediaBrands' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfRetailMediaBrands' security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/account-management/accounts/{accountId}/create-brand-account: post: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/create-brand-account description: Creates a new child Demand Brand account for the provided parent Private Market account operationId: CreatePrivateMarketDemandBrandAccount parameters: - name: accountId in: path description: The given account id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfRetailMediaBrandAccountCreation' responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfRetailMediaAccount' security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/account-management/accounts/{accountId}/create-seller-account: post: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/create-seller-account description: Creates a new child Demand Seller account for the provided parent Private Market account operationId: CreatePrivateMarketDemandSellerAccount parameters: - name: accountId in: path description: The given account id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfRetailMediaSellerAccountCreation' responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfRetailMediaAccount' security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/account-management/accounts/{accountId}/private-market-child-accounts: get: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/private-market-child-accounts description: Gets Private Market child accounts that are associated with the given account operationId: GetPrivateMarketChildAccountsByAccountId parameters: - name: accountId in: path description: Account Id required: true schema: type: string - name: limit in: query description: The number of accounts to be returned. The default is 25. schema: type: integer format: int32 default: 25 - name: offset in: query description: The (zero-based) offset into the collection of accounts. The default is 0. schema: type: integer format: int32 default: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeOfRetailMediaChildAccountAndMetadata' security: - oauth: - RetailMedia_Accounts_Read /2026-07/retail-media/account-management/accounts/{accountId}/sellers: put: tags: - Accounts summary: /2026-07/retail-media/account-management/accounts/{accountId}/sellers description: Replace the sellers associated with an account operationId: UpdateSellers parameters: - name: accountId in: path description: The given account id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceCollectionInputOfRetailMediaSeller' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceCollectionOutcomeOfRetailMediaSeller' security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/accounts: get: tags: - Accounts summary: /2026-07/retail-media/accounts description: Gets page of account objects that the current user can access operationId: GetAccounts parameters: - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiPageResponseOfAccount' security: - oauth: - RetailMedia_Accounts_Read /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 /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 /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 /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 /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 /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 /2026-07/retail-media/accounts/{account-id}/balances: post: tags: - Balance summary: /2026-07/retail-media/accounts/{account-id}/balances description: Create balance for the given account id operationId: CreateBalanceByAccountId parameters: - name: account-id in: path description: The account to create balances for required: true schema: type: string requestBody: description: An object that represents the available options to set when creating a Retail Media Balance content: application/json: schema: $ref: '#/components/schemas/CreateBalanceV3Request' required: true x-bodyName: createBalance responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceResponseV3Response' security: - oauth: - RetailMedia_Balance_Manage /2026-07/retail-media/accounts/{account-id}/balances/{balance-id}: patch: tags: - Balance summary: /2026-07/retail-media/accounts/{account-id}/balances/{balance-id} description: Modify a balance for the given account id operationId: UpdateBalanceV1 parameters: - name: account-id in: path description: The account of the balance required: true schema: type: string - name: balance-id in: path description: The balance to change the dates required: true schema: type: string requestBody: description: An object that represents the available options to modify a balance. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfUpdateBalanceModelV1' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfBalanceResponseV1' security: - oauth: - RetailMedia_Balance_Manage get: tags: - Balance summary: /2026-07/retail-media/accounts/{account-id}/balances/{balance-id} description: Get a balance for the given account id and balance id operationId: GetBalanceByAccountAndBalanceId parameters: - name: account-id in: path description: The account of the balance required: true schema: type: string - name: balance-id in: path description: The balance id required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceResponseV2Response' security: - oauth: - RetailMedia_Balance_Read /2026-07/retail-media/accounts/{account-id}/balances/{balance-id}/add-funds: post: tags: - Balance summary: /2026-07/retail-media/accounts/{account-id}/balances/{balance-id}/add-funds description: Add funds to a balance for the given account id operationId: AddFundsByAccountAndBalanceId parameters: - name: account-id in: path description: The account of the balance required: true schema: type: string - name: balance-id in: path description: The balance to add funds to required: true schema: type: string requestBody: description: An object that represents the available options of adding funds to a balance. content: application/json: schema: $ref: '#/components/schemas/AddFundsToBalanceV3Request' required: true x-bodyName: addFundsToBalance responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceResponseV3Response' security: - oauth: - RetailMedia_Balance_Manage /2026-07/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates: post: tags: - Balance summary: /2026-07/retail-media/accounts/{account-id}/balances/{balance-id}/change-dates description: Change dates of a balance for the given account id operationId: ChangeDatesByAccountAndBalanceId parameters: - name: account-id in: path description: The account of the balance required: true schema: type: string - name: balance-id in: path description: The balance to change the dates required: true schema: type: string requestBody: description: An object that represents the available options to modify schedule of a balance. content: application/json: schema: $ref: '#/components/schemas/ChangeDatesOfBalanceV2Request' required: true x-bodyName: changeDatesOfBalance responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceResponseV2Response' security: - oauth: - RetailMedia_Balance_Manage /2026-07/retail-media/accounts/{account-id}/campaigns: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/campaigns description: Gets page of campaign objects for the given account id operationId: GetCampaignsByAccountId parameters: - name: account-id in: path description: The given account id required: true schema: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: maximum: 2147483647 minimum: 1 type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiPageResponseOfCampaignV202301' security: - oauth: - RetailMedia_Campaign_Read post: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/campaigns description: Creates a new campaign with the specified settings operationId: CreateCampaignsByAccountId parameters: - name: account-id in: path description: The given account id required: true schema: type: string requestBody: description: The campaign settings to create a campaign with content: application/json: schema: $ref: '#/components/schemas/PostCampaignV202301' required: true x-bodyName: campaign responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCampaignV202301' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/accounts/{account-id}/creatives: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/creatives description: Get account creatives operationId: GetAccountCreatives parameters: - name: account-id in: path description: External account id to retrieve creatives for required: true schema: type: string responses: '200': description: Creatives found content: application/json: schema: $ref: '#/components/schemas/Creative202110ListResponse' security: - oauth: - RetailMedia_Campaign_Read post: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/creatives description: Create a creative for an account operationId: CreateCreative parameters: - name: account-id in: path description: External account id to create a creative for required: true schema: type: string requestBody: description: The creative to create content: application/json: schema: $ref: '#/components/schemas/CreativeCreateModel202207' required: true responses: '201': description: Creatives created content: application/json: schema: $ref: '#/components/schemas/Creative202210Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/accounts/{account-id}/creatives/{creative-id}: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/creatives/{creative-id} description: Get the specified creative operationId: GetCreative parameters: - name: account-id in: path description: External account id to retrieve creatives for required: true schema: type: string - name: creative-id in: path description: Creative to get required: true schema: type: string responses: '200': description: Creatives found content: application/json: schema: $ref: '#/components/schemas/Creative2Response' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/creatives/{creative-id} description: Update a creative operationId: UpdateCreative parameters: - name: account-id in: path description: External account id containing the creative required: true schema: type: string - name: creative-id in: path description: Creative to update required: true schema: type: string requestBody: description: The creative to create content: application/json: schema: $ref: '#/components/schemas/CreativeUpdateModel202207' required: true responses: '201': description: Creative updated content: application/json: schema: $ref: '#/components/schemas/Creative202210Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/accounts/{account-id}/creatives/search: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/creatives/search description: Get account creatives operationId: SearchAccountCreatives parameters: - name: account-id in: path description: External account id to retrieve creatives for required: true schema: type: string - name: creative-ids in: query description: Creatives to filter by schema: type: array items: type: string responses: '200': description: Creatives found content: application/json: schema: $ref: '#/components/schemas/Creative2ListResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{account-id}/keywords/in-review-report: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/keywords/in-review-report description: Generate a list of reports for line items which contain one or more actionable keyword reviews operationId: GetKeywordInReviewReport parameters: - name: account-id in: path description: The account to generate a report for required: true schema: type: string format: int64 - name: limit in: query description: Number of items per page schema: maximum: 50 minimum: 1 type: integer format: int32 default: 25 - name: offset in: query description: Offset for pagination schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeLineItemKeywordReviewReportAndMetadata' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{account-id}/line-items: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{account-id}/line-items description: Gets page of line item objects for the given account id operationId: GetLineItemsByAccountId parameters: - name: account-id in: path description: The given account id required: true schema: type: string - name: limitToCampaignId in: query description: The campaign ids that you would like to limit your result set to schema: type: array items: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: limitToType in: query description: The campaign types that you would like to limit your result set to schema: enum: - Unknown - Auction - Preferred type: string nullable: true - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: maximum: 2147483647 minimum: 1 type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CommonLineItemPagedListResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{accountId}/balances: get: tags: - Balance summary: /2026-07/retail-media/accounts/{accountId}/balances description: Gets page of balance objects for the given account id. operationId: GetPageOfBalancesV1 parameters: - name: accountId in: path description: The account to get balances for. required: true schema: type: string - name: limit in: query description: The number of elements to be returned. schema: maximum: 500 minimum: 1 type: integer format: int32 default: 25 - name: limit-to-id in: query description: The balance ids which the result is limited to. schema: maxItems: 50 type: array items: type: string - name: offset in: query description: The (zero-based) starting offset in the collection. schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeBalanceV1AndMetadata' security: - oauth: - RetailMedia_Balance_Read /2026-07/retail-media/accounts/{accountId}/brand-catalog-export: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/brand-catalog-export description: Create a request for a Catalog available to the indicated account. operationId: CreateBrandCatalogExport parameters: - name: accountId in: path description: The account to request the catalog for. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfBrandCatalogRequestV2' required: true responses: '200': description: Catalog request successfully created content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfCatalogStatusV2' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/accounts/{accountId}/brands: get: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/brands description: Gets page of retailer objects that are associated with the given account operationId: GetBrandsByAccountId parameters: - name: accountId in: path description: The given account id required: true schema: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiPageResponseOfBrand' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{accountId}/catalogs: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/catalogs description: Create a request for a Catalog available to the indicated account. operationId: CatalogApi_PostApiV1ExternalAccountCatalogsByAccountId parameters: - name: accountId in: path description: The account to request the catalog for. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/JsonApiRequestOfCatalogRequest' required: true responses: '200': description: Catalog request successfully created content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCatalogStatus' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{accountId}/catalogs/sellers: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/catalogs/sellers description: Create a request for a Catalog available to the indicated account. operationId: Catalog_PostApiExternalV1AccountCatalogsSellersByAccountId parameters: - name: accountId in: path description: The account to request the catalog for. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/JsonApiRequestOfSellerCatalogRequest' required: true responses: '200': description: Catalog request successfully created content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCatalogStatus' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{accountId}/grant-consent: post: tags: - Accounts summary: /2026-07/retail-media/accounts/{accountId}/grant-consent description: Grant consent to a business application on behalf of a Private Market demand account operationId: GrantConsent parameters: - name: accountId in: path description: The demand account ID on which to grant consent required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/GrantConsentInput' x-bodyName: grantConsentInput responses: '204': description: Success security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/accounts/{accountId}/retailers/search: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/retailers/search description: Searches for retailers associated with the specified account and returns budget model availability for each retailer operationId: SearchAccountRetailers parameters: - name: accountId in: path description: The external account identifier required: true schema: type: string - name: limit in: query description: The maximum number of items to return. Must be between 1 and 10. Default is 5. schema: maximum: 10 minimum: 1 type: integer format: int32 default: 5 - name: offset in: query description: The number of items to skip before starting to collect the result set. Default is 0. schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 requestBody: description: The search request containing filtering parameters content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfRetailerSearchRequestV2' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeOfRetailerResultV2AndMetadata' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/accounts/{accountId}/seller-catalog-export: post: tags: - Campaign summary: /2026-07/retail-media/accounts/{accountId}/seller-catalog-export description: Create a request for a Catalog available to the indicated account. operationId: CreateSellerCatalogExport parameters: - name: accountId in: path description: The account to request the catalog for. required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfSellerCatalogRequestV2' required: true responses: '200': description: Catalog request successfully created content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfCatalogStatusV2' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/accounts/fees/search: post: tags: - Accounts summary: /2026-07/retail-media/accounts/fees/search description: Get fees for provided accounts operationId: AccountFeesSearch parameters: - name: limit in: query description: used for paging, number of results returned per request, Maximum of 500 schema: maximum: 500 minimum: 1 type: integer format: int32 default: 50 - name: offset in: query description: used for paging, number of records to skip schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputAccountFeesSearchRequest' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceCollectionOutcomePrivateMarketAccountFeesAndMetadata' security: - oauth: - RetailMedia_Accounts_Read /2026-07/retail-media/accounts/fees/update: post: tags: - Accounts summary: /2026-07/retail-media/accounts/fees/update description: Set fees for provided accounts operationId: UpdateAccountFees requestBody: content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputAccountFeesUpdateRequest' required: true responses: '204': description: Success security: - oauth: - RetailMedia_Accounts_Manage /2026-07/retail-media/accounts/sellers/search: post: tags: - Accounts summary: /2026-07/retail-media/accounts/sellers/search description: Get the sellers mapped to provided accounts operationId: SearchSellers requestBody: description: '' content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfSellerSearch' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceCollectionOutcomeOfSellerSearchResult' security: - oauth: - RetailMedia_Accounts_Read /2026-07/retail-media/assets: post: tags: - Campaign summary: /2026-07/retail-media/assets description: Creates an asset operationId: CreateAsset requestBody: content: multipart/form-data: schema: required: - AssetFile properties: AssetFile: type: string description: The asset binary content format: binary responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/AssetResponse' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/auction-line-items/{lineItemId}: get: tags: - Campaign summary: /2026-07/retail-media/auction-line-items/{lineItemId} description: Gets a sponsored product line item by its id. operationId: GetAuctionLineItem parameters: - name: lineItemId in: path description: The id of the line item required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfSponsoredProductsLineItem' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/auction-line-items/{lineItemId} description: Updates a Sponsored Products Line Item given a line item id and a request. operationId: UpdateAuctionLineItem parameters: - name: lineItemId in: path description: The external line item ID of the sponsored products line item. required: true schema: type: string requestBody: description: An update request containing all details of the requested update. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfSponsoredProductsLineItemUpdateRequestModel' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfSponsoredProductsLineItem' security: - oauth: - RetailMedia_Campaign_Manage /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 /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 /2026-07/retail-media/balances/{balance-id}/campaigns: get: tags: - Balance summary: /2026-07/retail-media/balances/{balance-id}/campaigns description: Gets page of campaigns for the given balanceId operationId: GetCampaignsByBalanceId parameters: - name: balance-id in: path description: The balance to get campaigns from required: true schema: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: maximum: 2147483647 minimum: 1 type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/BalanceCampaign202110PagedListResponse' security: - oauth: - RetailMedia_Balance_Read /2026-07/retail-media/balances/{balanceId}: get: tags: - Balance summary: /2026-07/retail-media/balances/{balanceId} description: Get a balance for the given balance id. operationId: GetBalanceV1 parameters: - name: balanceId in: path description: The balance id. required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeBalanceV1' security: - oauth: - RetailMedia_Balance_Read /2026-07/retail-media/balances/{balanceId}/campaigns/append: post: tags: - Campaign summary: /2026-07/retail-media/balances/{balanceId}/campaigns/append description: Appends one or more campaigns to the specified balance operationId: AppendCampaignsToBalanceV1 parameters: - name: balanceId in: path description: The balance to add campaigns from required: true schema: type: string requestBody: description: The balance campaign appending request. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputAppendCampaignsRequestV1' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeBalanceCampaignsV1' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/balances/{balanceId}/campaigns/delete: post: tags: - Campaign summary: /2026-07/retail-media/balances/{balanceId}/campaigns/delete description: Deletes one or more campaigns on the specified balance operationId: DeleteCampaignsFromBalanceV1 parameters: - name: balanceId in: path description: The balance to remove campaigns from required: true schema: type: string requestBody: description: The balance campaign deleting request. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputDeleteCampaignsRequestV1' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeBalanceCampaignsV1' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/balances/{balanceId}/history: get: tags: - Balance summary: /2026-07/retail-media/balances/{balanceId}/history description: Gets the balance's historical change data. operationId: GetBalanceHistoryV1 parameters: - name: balanceId in: path description: Balance id. required: true schema: type: string - name: limit in: query description: The number of elements to be returned. schema: maximum: 500 minimum: 1 type: integer format: int32 default: 25 - name: limitToChangeTypes in: query description: Comma separated change types string that will be queried. schema: type: string - name: offset in: query description: The (zero-based) starting offset in the collection. schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceCollectionOutcomeBalanceHistoryChangeDataCaptureV1AndMetadata' security: - oauth: - RetailMedia_Balance_Read /2026-07/retail-media/billing/partner-report: post: tags: - Billing summary: /2026-07/retail-media/billing/partner-report description: Create a Partner Billing Report request. operationId: CreatePartnerBillingReportRequestV1 requestBody: description: Partner Billing Report request object. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputPartnerBillingReportRequestV1' required: true responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomePartnerBillingReportStatusV1' security: - oauth: - RetailMedia_Billing_Read /2026-07/retail-media/billing/partner-report/{requestId}/output: get: tags: - Billing summary: /2026-07/retail-media/billing/partner-report/{requestId}/output description: Get the output of an existing Partner Billing Report. operationId: GetPartnerBillingReportOutputV1 parameters: - name: requestId in: path description: The id of a Partner Billing Report request. required: true schema: type: string responses: '200': description: Success content: application/csv: schema: type: string format: binary application/json: schema: type: string format: binary security: - oauth: - RetailMedia_Billing_Read /2026-07/retail-media/billing/partner-report/{requestId}/status: get: tags: - Billing summary: /2026-07/retail-media/billing/partner-report/{requestId}/status description: Get the status of an existing Partner Billing Report. operationId: GetPartnerBillingReportStatusV1 parameters: - name: requestId in: path description: The id of a Partner Billing Report request. required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomePartnerBillingReportStatusV1' security: - oauth: - RetailMedia_Billing_Read /2026-07/retail-media/brands/search: post: tags: - Accounts summary: /2026-07/retail-media/brands/search description: Search for brands given a retailer ID and search term. operationId: SearchBrands parameters: - name: limit in: query description: the number of brands to return schema: maximum: 100 minimum: 1 type: integer format: int32 default: 25 - name: offset in: query description: offset of paginated results schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 requestBody: description: BrandIdSearchRequest which contains the request parameters content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputBrandIdSearchRequest' x-bodyName: brandIdSearchRequest responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeBrandIdSearchResultPagingOffsetLimitMetadata' security: - oauth: - RetailMedia_Accounts_Read /2026-07/retail-media/campaigns/{campaign-id}/preferred-line-items: get: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaign-id}/preferred-line-items description: Gets page of preferred line item objects for the given campaign id operationId: GetPreferredLineItemsByCampaignId parameters: - name: campaign-id in: path description: The given campaign id required: true schema: type: string - name: limitToId in: query description: The ids that you would like to limit your result set to schema: type: array items: type: string - name: pageIndex in: query description: The 0 indexed page index you would like to receive given the page size schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of items you would like to receive in this request schema: maximum: 2147483647 minimum: 1 type: integer format: int32 default: 25 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemV2PagedListResponse' security: - oauth: - RetailMedia_Campaign_Read post: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaign-id}/preferred-line-items description: Creates a new preferred line item with the specified settings operationId: CreatePreferredLineItemByCampaignId parameters: - name: campaign-id in: path description: The given campaign id required: true schema: type: string requestBody: description: The line item settings to create a line item with content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemCreateModelV2Request' required: true x-bodyName: lineItem responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemV2Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/campaigns/{campaignId}: get: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId} description: Gets the campaign for the given campaign id operationId: GetCampaignByCampaignId parameters: - name: campaignId in: path description: The given campaign id required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCampaignV202301' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId} description: Updates the campaign for the given campaign id operationId: UpdateCampaignByCampaignId parameters: - name: campaignId in: path description: The given campaign id required: true schema: type: string requestBody: description: The campaign settings to update that campaign with content: application/json: schema: $ref: '#/components/schemas/PutCampaignV202301' required: true x-bodyName: campaign responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCampaignV202301' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/campaigns/{campaignId}/auction-line-items: get: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId}/auction-line-items description: Gets a page of sponsored product line items by campaign id. operationId: GetAuctionLineItemsByCampaign parameters: - name: campaignId in: path description: The id of the campaign required: true schema: type: string - name: limit in: query description: The number of elements to be returned on a page. schema: maximum: 500 minimum: 1 type: integer format: int32 default: 25 - name: limitToIds in: query description: The ids to limit the auction line item results to schema: type: array items: type: string - name: offset in: query description: The (zero-based) starting offset into the collection. schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeOfSponsoredProductsLineItemAndMetadata' security: - oauth: - RetailMedia_Campaign_Read post: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId}/auction-line-items description: Creates new auction line item with the specified settings operationId: CreateAuctionLineItem parameters: - name: campaignId in: path description: The given campaign id required: true schema: type: string requestBody: description: The line item settings to create a line item with content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfSponsoredProductsLineItemCreateRequestModel' required: true responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceOutcomeOfSponsoredProductsLineItem' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/campaigns/{campaignId}/campaign-budget-overrides: get: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId}/campaign-budget-overrides description: Get current campaign budget overrides by given campaign id. operationId: GetCampaignBudgetOverrides parameters: - name: campaignId in: path description: Campaign id. required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfCampaignBudgetOverrides' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/campaigns/{campaignId}/campaign-budget-overrides description: Update campaign budget overrides by given campaign id and new campaign budget overrides settings. operationId: UpdateCampaignBudgetOverrides parameters: - name: campaignId in: path description: Campaign id. required: true schema: type: string requestBody: description: New campaign budget overrides settings value resource input. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfCampaignBudgetOverrides' required: true responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfCampaignBudgetOverrides' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/catalog/merchants/{merchantId}/store-inventory/delete: post: tags: - Catalog summary: /2026-07/retail-media/catalog/merchants/{merchantId}/store-inventory/delete description: Used to publish a batch of store inventories to delete. The batch is processed asynchronously. operationId: DeleteStoreInventoryPerMerchantId parameters: - name: merchantId in: path description: Identifies the merchant, can also be called partnerId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchStoreInventoryDeleteRequest' required: true x-bodyName: body responses: '204': description: Batch accepted. content: application/json: {} security: - oauth: - RetailMedia_Catalog_Manage /2026-07/retail-media/catalog/merchants/{merchantId}/store-inventory/upsert: post: tags: - Catalog summary: /2026-07/retail-media/catalog/merchants/{merchantId}/store-inventory/upsert description: Used to publish a batch of store inventories to upsert. The batch is processed asynchronously. operationId: UpsertStoreInventoryPerMerchantId parameters: - name: merchantId in: path description: Identifies the merchant, can also be called partnerId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/BatchStoreInventoryRequest' required: true x-bodyName: body responses: '204': description: Batch accepted. content: application/json: {} security: - oauth: - RetailMedia_Catalog_Manage /2026-07/retail-media/catalogs/{catalogId}/output: get: tags: - Campaign summary: /2026-07/retail-media/catalogs/{catalogId}/output description: "Output the indicated catalog. Catalogs are only available for retrieval when their associated status request\r\nis at a Success status.\r\nProduces application/x-json-stream CatalogProduct json objects (first introduced in the 2021-07 version)." operationId: GetCatalogOutput parameters: - name: catalogId in: path description: A catalog ID returned from an account catalog request. required: true schema: type: string responses: '200': description: Catalog download initiated. content: application/x-json-stream: schema: type: string format: binary '204': description: Catalog has expired. security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/catalogs/{catalogId}/status: get: tags: - Campaign summary: /2026-07/retail-media/catalogs/{catalogId}/status description: Check the status of a catalog request. operationId: GetCatalogStatus parameters: - name: catalogId in: path description: A catalog ID returned from an account catalog request. required: true schema: type: string responses: '200': description: Catalog request found. content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfCatalogStatus' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/categories: get: tags: - Campaign summary: /2026-07/retail-media/categories description: Endpoint to search categories by text and retailer. operationId: CategorySearch_GetApiExternalV1Categories parameters: - name: pageIndex in: query description: The start position in the overall list of matches. Must be zero or greater. schema: maximum: 500 minimum: 0 type: integer format: int32 default: 0 - name: pageSize in: query description: The maximum number of results to return with each call. Must be greater than zero. schema: maximum: 100 minimum: 1 type: integer format: int32 default: 100 - name: retailerId in: query description: The retailer id for which Categories fetched schema: type: integer format: int32 - name: textSubstring in: query description: Query string to search across Categories schema: type: string responses: '200': description: Categories found. content: application/json: schema: $ref: '#/components/schemas/Category202204ListResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/categories/{categoryId}: get: tags: - Campaign summary: /2026-07/retail-media/categories/{categoryId} description: Endpoint to search for a specific category by categoryId. operationId: GetCategory parameters: - name: categoryId in: path description: ID of the desired category required: true schema: type: string format: int32 responses: '200': description: Retrieval completed and category is returned. content: application/json: schema: $ref: '#/components/schemas/Category202204' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/line-items/{externalLineItemId}/keywords/recommended: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{externalLineItemId}/keywords/recommended description: Retrieves a collection of recommended keywords for a line item operationId: GetRecommendedKeywords parameters: - name: externalLineItemId in: path description: The line item identifier required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfRecommendedKeywordsResult' deprecated: true security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/line-items/{id}/keywords: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{id}/keywords description: Fetch keywords associated with the specified line item operationId: FetchKeywords parameters: - name: id in: path description: ID of the line item required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/KeywordsModelResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/line-items/{id}/keywords/add-remove: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{id}/keywords/add-remove description: Add or Remove keywords from the line item in bulk operationId: AddRemoveKeywords parameters: - name: id in: path description: ID of the line item required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/AddRemoveKeywordsModelRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ResourceOutcome' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{id}/keywords/set-bid: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{id}/keywords/set-bid description: Set bid overrides for associated keywords to the given line item in bulk operationId: SetKeywordBids parameters: - name: id in: path description: ID of the line item required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/SetBidsModelRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ResourceOutcome' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id} description: Gets the line item for the given line item id operationId: GetLineItemsByCampaignId parameters: - name: line-item-id in: path description: The given line item id required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CommonLineItemResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/line-items/{line-item-id}/bid-multipliers: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/bid-multipliers description: Fetch all bid multipliers for a given line item operationId: GetBidMultipliersByLineItemId parameters: - name: line-item-id in: path description: LineItemId for bid multiplier retrieval required: true schema: type: string responses: '200': description: BidMultipliers Found content: application/json: schema: $ref: '#/components/schemas/JsonApiSingleResponseOfLineItemBidMultipliersV2' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/bid-multipliers description: Updates the bid multipliers for a given line item operationId: UpdateBidMultipliersByLineItemId parameters: - name: line-item-id in: path description: LineItemId for bid multiplier retrieval required: true schema: type: string requestBody: description: New Bid Multipliers to be set content: application/json: schema: $ref: '#/components/schemas/LineItemBidMultipliersV2Request' required: true x-bodyName: request responses: '200': description: BidMultipliers Updated content: application/json: schema: $ref: '#/components/schemas/LineItemBidMultipliersV2Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}/keywords/review: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/keywords/review description: Update the status of keyword reviews under a line item operationId: UpdateKeywordReviews parameters: - name: line-item-id in: path description: The line item to update keyword review statuses for required: true schema: type: string format: int64 requestBody: description: Request object containing a list of Phrase-ReviewState pairs to update content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputRetailMediaKeywordsReview' x-bodyName: keywordReviewSetStateRequest responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeRetailMediaKeywordsReviewResult' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}/products: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/products description: Retrieve a page of promoted products for a line item operationId: FetchPromotedProducts parameters: - name: fields in: query description: "A comma separated list of attribute names from the response model to compute and return.\r\n Valid values are `status` and `bidOverride` in any order. Defaults to `status`." schema: type: string - name: limit in: query description: Maximum page size to fetch. Defaults to 500. schema: type: integer format: int32 - name: line-item-id in: path description: ID of the line item. required: true schema: type: string - name: offset in: query description: Offset of the first item to fetch. Defaults to zero. schema: type: integer format: int32 responses: '200': description: Promoted products associated with the line item content: application/json: schema: $ref: '#/components/schemas/PromotedProductResourceCollectionOutcome' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/line-items/{line-item-id}/products/append: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/products/append description: Append a collection of promoted products to a line item operationId: AppendPromotedProducts parameters: - name: line-item-id in: path description: ID of the line item required: true schema: type: string requestBody: description: Request body whose {data} contains an array of promoted products. content: application/json: schema: $ref: '#/components/schemas/PromotedProductResourceCollectionInput' responses: '200': description: Promoted products appended to the line item with warnings content: application/json: schema: $ref: '#/components/schemas/ProductResourceOutcome' '204': description: Promoted products appended to the line item security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}/products/delete: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/products/delete description: Remove a collection of promoted products from a line item operationId: DeletePromotedProducts parameters: - name: line-item-id in: path description: ID of the line item required: true schema: type: string requestBody: description: Request body whose {data} contains an array of promoted products. content: application/json: schema: $ref: '#/components/schemas/PromotedProductResourceCollectionInput' responses: '204': description: Promoted products removed from the line item security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}/products/pause: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/products/pause description: Pause a collection of promoted products associated with a line item operationId: PausePromotedProducts parameters: - name: line-item-id in: path description: ID of the line item required: true schema: type: string requestBody: description: Request body whose {data} contains an array of promoted products. content: application/json: schema: $ref: '#/components/schemas/PromotedProductResourceCollectionInput' responses: '204': description: Promoted products paused security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{line-item-id}/products/unpause: post: tags: - Campaign summary: /2026-07/retail-media/line-items/{line-item-id}/products/unpause description: Un-pause a collection of promoted products associated with a line item operationId: UnpausePromotedProducts parameters: - name: line-item-id in: path description: ID of the line item required: true schema: type: string requestBody: description: Request body whose {data} contains an array of promoted products. content: application/json: schema: $ref: '#/components/schemas/PromotedProductResourceCollectionInput' responses: '204': description: Promoted products un-paused security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/line-items/{lineItemId}/line-item-budget-overrides: get: tags: - Campaign summary: /2026-07/retail-media/line-items/{lineItemId}/line-item-budget-overrides description: Gets a collection of monthly and daily budget overrides for the provided line item. operationId: GetLineItemBudgetOverrides parameters: - name: lineItemId in: path description: The line item id to get budget overrides for. required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfLineItemBudgetOverrides' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/line-items/{lineItemId}/line-item-budget-overrides description: Update line item budget overrides by given external line item id and new line item budget overrides settings. operationId: UpdateLineItemBudgetOverrides parameters: - name: lineItemId in: path description: Line item external id. required: true schema: type: string requestBody: description: New line item budget overrides settings value resource input. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputOfLineItemBudgetOverrides' required: true responses: '201': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeOfLineItemBudgetOverrides' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/me: get: tags: - Gateway summary: /2026-07/retail-media/me description: Get information about the currently logged application operationId: GetCurrentApplication responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ApplicationSummaryModelResponse' security: - oauth: [] /2026-07/retail-media/preferred-line-items/{line-item-id}: get: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id} description: Gets the preferred line item for the given line item id operationId: GetPreferredLineItemsByLineItemId parameters: - name: line-item-id in: path description: The given line item id required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemV2Response' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id} description: Updates the preferred line item for the given line item id operationId: UpdatePreferredLineItemByLineItemId parameters: - name: line-item-id in: path description: The given line item id required: true schema: type: string requestBody: description: The line item settings to create a line item with content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemUpdateModelV2Request' required: true x-bodyName: lineItem responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/PreferredLineItemV2Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket: get: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket description: This endpoint gets the add to basket target on the specified line item. operationId: GetAddToBasketTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AddToBasketTarget202110Response' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket description: This endpoint sets the scope of the add to basket target on the specified line item. operationId: PutAddToBasketTargetByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: The add to basket target to set the scope for content: application/json: schema: $ref: '#/components/schemas/AddToBasketTarget202110Request' required: true x-bodyName: addToBasketTarget responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AddToBasketTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket/append: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket/append description: This endpoint appends one or more add to basket ids to targeting on the specified line item. The resulting state of the add to basket target is returned. operationId: AppendAddToBasketTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Ids to append to the target content: application/json: schema: $ref: '#/components/schemas/AddToBasketIdsUpdateModel202110Request' x-bodyName: idsToAppend responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AddToBasketTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket/delete: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/add-to-basket/delete description: This endpoint removes one or more add to basket ids from targeting on the specified line item. The resulting state of the add to basket target is returned. operationId: DeleteAddToBasketTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Ids to remove from the target content: application/json: schema: $ref: '#/components/schemas/AddToBasketIdsUpdateModel202110Request' x-bodyName: idsToRemove responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AddToBasketTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences: get: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences description: This endpoint gets the audience target on the specified line item. operationId: GetAudienceTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AudienceTarget202110Response' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences description: This endpoint sets the scope of the audience target on the specified line item. operationId: PutAudienceTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: The audience target to set the scope for content: application/json: schema: $ref: '#/components/schemas/AudienceTarget202110Request' required: true x-bodyName: audienceTarget responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AudienceTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences/append: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences/append description: This endpoint appends one or more audiences ids to targeting on the specified line item. The resulting state of the audience target is returned. operationId: AppendAudienceTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Audience ids to append to the target content: application/json: schema: $ref: '#/components/schemas/AudienceIdsUpdateModel202110Request' x-bodyName: idsToAppend responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AudienceTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences/delete: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/audiences/delete description: This endpoint removes one or more audiences ids from targeting on the specified line item. The resulting state of the audience target is returned. operationId: DeleteAudienceTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Audience ids to remove from the target content: application/json: schema: $ref: '#/components/schemas/AudienceIdsUpdateModel202110Request' x-bodyName: idsToRemove responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AudienceTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores: get: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores description: This endpoint gets the store target on the specified line item. operationId: GetStoreTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StoreTarget202110Response' security: - oauth: - RetailMedia_Campaign_Read put: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores description: This endpoint sets the scope of the store target on the specified line item. operationId: PutStoreTargetByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: The store target to set the scope for content: application/json: schema: $ref: '#/components/schemas/StoreTarget202110Request' required: true x-bodyName: storeTarget responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StoreTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores/append: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores/append description: This endpoint appends one or more store ids to targeting on the specified line item. The resulting state of the store target is returned. operationId: AppendStoreTargetsByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Store ids to append to the target content: application/json: schema: $ref: '#/components/schemas/StoreIdsUpdateModel202110Request' x-bodyName: idsToAppend responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StoreTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores/delete: post: tags: - Campaign summary: /2026-07/retail-media/preferred-line-items/{line-item-id}/targeting/stores/delete description: This endpoint removes one or more store ids from targeting on the specified line item. The resulting state of the store target is returned. operationId: DeleteStoreTargetByLineItemId parameters: - name: line-item-id in: path description: The line item to interact with required: true schema: type: string requestBody: description: Store ids to remove from the target content: application/json: schema: $ref: '#/components/schemas/StoreIdsUpdateModel202110Request' x-bodyName: idsToRemove responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/StoreTarget202110Response' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/reports/{reportId}/output: get: tags: - Analytics summary: /2026-07/retail-media/reports/{reportId}/output description: Returns the output of an async report operationId: GetAsyncExportOutput parameters: - name: reportId in: path description: The ID of the report to retrieve required: true schema: type: string responses: '200': description: Success content: application/json: schema: type: string format: binary security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/{reportId}/status: get: tags: - Analytics summary: /2026-07/retail-media/reports/{reportId}/status description: Returns the status of an async report operationId: GetAsyncExportStatus parameters: - name: reportId in: path description: The ID of the report to retrieve required: true schema: type: string responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/attributed-transactions: post: tags: - Analytics summary: /2026-07/retail-media/reports/attributed-transactions description: "Creates an attributed-transactions async report. The request accepts explicit attributed-transaction dimensions, metrics, and filters.\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncAttributedTransactionsReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncAttributedTransactionsReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/fillrate: post: tags: - Analytics summary: /2026-07/retail-media/reports/fillrate description: "Returns an asynchronous Fill Rate Report\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncFillRateReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncFillRateReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/missed-opportunities: post: tags: - Analytics summary: /2026-07/retail-media/reports/missed-opportunities description: "Creates a missed-opportunities async report. The request accepts explicit missed-opportunities dimensions, metrics, and filters.\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncMissedOpportunitiesReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncMissedOpportunitiesReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/performance: post: tags: - Analytics summary: /2026-07/retail-media/reports/performance description: "Creates a performance DSP analytics async report. Dimensions and metrics select the output schema, and filters constrain eligible data.\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncPerformanceReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncPerformanceReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/revenue: post: tags: - Analytics summary: /2026-07/retail-media/reports/revenue description: "Returns an asynchronous Revenue Report\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncRevenueReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncRevenueReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/sync/attributed-transactions: post: tags: - Analytics summary: /2026-07/retail-media/reports/sync/attributed-transactions description: Returns a synchronous Attributed Transactions Report operationId: GenerateSyncAttributedTransactionsReport requestBody: content: application/json: schema: $ref: '#/components/schemas/SyncAttributedTransactionsReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/sync/campaigns: post: tags: - Analytics summary: /2026-07/retail-media/reports/sync/campaigns description: Returns a synchronous Campaigns Report operationId: GenerateSyncCampaignsReport requestBody: content: application/json: schema: $ref: '#/components/schemas/SyncCampaignsReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/sync/line-items: post: tags: - Analytics summary: /2026-07/retail-media/reports/sync/line-items description: Returns a synchronous Line Items Report operationId: GenerateSyncLineItemsReport requestBody: content: application/json: schema: $ref: '#/components/schemas/SyncLineItemsReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/sync/real-time-performance: post: tags: - Analytics summary: /2026-07/retail-media/reports/sync/real-time-performance description: "Returns a synchronous Real Time Performance Report. Returns empty rows; metadata includes dataCompleteThrough (latest time from streaming table in the request timezone).\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateSyncRealTimePerformanceReport requestBody: content: application/json: schema: $ref: '#/components/schemas/SyncRealTimePerformanceReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/reports/unfilled-placements: post: tags: - Analytics summary: /2026-07/retail-media/reports/unfilled-placements description: "Returns an asynchronous Unfilled Placements Report\r\n
\r\nThis endpoint is subject to specific rate limits." operationId: GenerateAsyncUnfilledPlacementsReport requestBody: content: application/json: schema: $ref: '#/components/schemas/AsyncUnfilledPlacementsReportRequest' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/AsyncReportResponse' security: - oauth: - RetailMedia_Analytics_Read /2026-07/retail-media/retailers/{retailer-id}/templates: get: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailer-id}/templates description: Get retailer creative templates operationId: GetRetailerCreativeTemplates parameters: - name: retailer-id in: path description: External retailer id to retrieve creative templates for required: true schema: type: string format: int32 responses: '200': description: Templates found content: application/json: schema: $ref: '#/components/schemas/TemplateListResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/retailers/{retailer-id}/templates/{template-id}: get: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailer-id}/templates/{template-id} description: Gets the template for the specified retailer id and template id operationId: GetCreativeTemplate parameters: - name: retailer-id in: path description: Retailer Id required: true schema: type: string format: int32 - name: template-id in: path description: Template Id required: true schema: type: string format: int32 responses: '200': description: Template found for the retailer content: application/json: schema: $ref: '#/components/schemas/TemplateResponse' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/retailers/{retailerId}/categories/search: post: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailerId}/categories/search description: Search a retailer categories by given text substring and category ids. operationId: SearchCategory parameters: - name: limit in: query description: Limit of the search result. schema: maximum: 500 minimum: 1 type: integer format: int32 default: 50 - name: offset in: query description: Offset of the search result. schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: retailerId in: path description: Retailer id. required: true schema: type: string format: int32 requestBody: description: Request of categories search. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputCategoriesSearchRequestV1' x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeCategory202204Metadata' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/retailers/{retailerId}/cpc-min-bids: post: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailerId}/cpc-min-bids description: Get overall and individual minimum bid amount for given retailer id and sku id list. operationId: GetCpcMinBidsBySkuIdsV1 parameters: - name: retailerId in: path description: Retailer Id. required: true schema: type: string format: int32 requestBody: description: Cpc minimum bid amount request object. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputCpcMinBidsRequest' required: true x-bodyName: cpcMinBidsRequest responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeCpcMinBidsResponse' security: - oauth: - RetailMedia_Campaign_Manage /2026-07/retail-media/retailers/{retailerId}/pages: get: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailerId}/pages description: Get the page types available for the given retailer operationId: RetailerApi_GetApi202110ExternalRetailerPagesByRetailerId parameters: - name: retailerId in: path description: The retailers to fetch pages for required: true schema: type: string format: int32 responses: '200': description: Pages fetched successfully content: application/json: schema: $ref: '#/components/schemas/RetailerPages202110' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/retailers/{retailerId}/recommend-categories: post: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailerId}/recommend-categories description: Endpoint to get recommended categories by given retailer id and sku id list. operationId: GetRecommendedCategories parameters: - name: retailerId in: path description: Retailer id. required: true schema: type: string format: int32 requestBody: description: Request of recommended categories. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputRecommendedCategoriesRequestV1' required: true x-bodyName: request responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/EntityResourceCollectionOutcomeCategory202204' security: - oauth: - RetailMedia_Campaign_Read /2026-07/retail-media/retailers/{retailerId}/recommend-keywords: post: tags: - Campaign summary: /2026-07/retail-media/retailers/{retailerId}/recommend-keywords description: Recommend keywords by given retailer id and sku ids. operationId: RecommendedKeywords parameters: - name: retailerId in: path description: Retailer id. required: true schema: type: string requestBody: description: Request of recommended keywords. content: application/json: schema: $ref: '#/components/schemas/ValueResourceInputRecommendedKeywordsRequestV1' required: true responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ValueResourceOutcomeRecommendedKeywordsResponseV1' security: - oauth: - RetailMedia_Campaign_Read components: schemas: AccountFeesSearchRequest: type: object properties: accountIds: type: array items: type: string description: Account Ids to return fees nullable: true additionalProperties: false description: the request body for account fees search AccountFeesUpdateRequest: required: - accountIds - fees type: object properties: accountIds: maxItems: 25 minItems: 1 type: array items: type: string description: accounts to update fees: $ref: '#/components/schemas/PrivateMarketFees' additionalProperties: false description: request body to set provided fees for the provided accounts AddFundsToBalanceV3: required: - deltaAmount type: object properties: deltaAmount: type: number description: Amount of billable funds to be added / decreased allotted to the balance. format: double memo: type: string description: Memo retailerPoNumber: type: string description: Purchase Order number. description: An object that represents the available options of adding funds to a balance. AddFundsToBalanceV3Request: type: object properties: data: $ref: '#/components/schemas/ResourceOfAddFundsToBalanceV3' description: A top-level object that encapsulates a Criteo API request for a single entity AddRemoveKeywordModel: type: object properties: isDeleted: type: boolean matchType: $ref: '#/components/schemas/MatchTypeModel' phrase: maxLength: 255 minLength: 0 type: string nullable: true additionalProperties: false description: A single keyword to be added or removed AddRemoveKeywordsModel: type: object properties: keywords: type: array items: $ref: '#/components/schemas/AddRemoveKeywordModel' nullable: true additionalProperties: false description: Data model containing keywords to be added or removed from a line item AddRemoveKeywordsModelRequest: type: object properties: data: $ref: '#/components/schemas/AddRemoveKeywordsModelResource' additionalProperties: false description: Request object to add or remove keywords from a line item AddRemoveKeywordsModelResource: type: object properties: attributes: $ref: '#/components/schemas/AddRemoveKeywordsModel' id: type: string nullable: true type: type: string nullable: true additionalProperties: false description: Resource object containing keywords to be added or removed from a line item AddToBasketIdsUpdateModel202110: type: object properties: categoryIds: type: array items: type: string description: Category ids that add to basket should target productIds: type: array items: type: string description: Product ids that add to basket should target description: Update model for updating add to basket target ids AddToBasketIdsUpdateModel202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAddToBasketIdsUpdateModel202110' description: Data model for a value type input resource AddToBasketTarget202110: required: - scope type: object properties: categoryIds: type: array items: type: string description: Category ids that add to basket should target productIds: type: array items: type: string description: Product ids that add to basket should target scope: enum: - unknown - include - exclude type: string description: Scope of the add to basket target description: Identifies add to basket targeting for a line item AddToBasketTarget202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAddToBasketTarget202110' description: Data model for a value type input resource AddToBasketTarget202110Response: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAddToBasketTarget202110' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a value type resource outcome AppendCampaignsRequestV1: required: - ids type: object properties: ids: type: array items: type: string description: The ids of the campaigns that are going to be appended to balance campaigns mapping. additionalProperties: false description: Request object for appending campaigns to balance campaigns mapping. ApplicationSummaryModel: type: object properties: applicationId: type: integer format: int32 nullable: true criteoService: type: string nullable: true description: type: string nullable: true name: type: string nullable: true organizationId: type: integer format: int32 nullable: true description: Used for the /me endpoint. Contains information about the currently authenticated application that we accept to give to our clients nullable: true ApplicationSummaryModelResource: type: object properties: attributes: $ref: '#/components/schemas/ApplicationSummaryModel' type: type: string nullable: true description: A top-level object that encapsulates a Criteo API response for a single value nullable: true ApplicationSummaryModelResponse: type: object properties: data: $ref: '#/components/schemas/ApplicationSummaryModelResource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for a single value Asset: required: - fileExtension type: object properties: fileExtension: type: string description: 'The file extension that is asset is representing. Example: jpg, png, gif or pdf.' fileLocation: type: string description: A url pointing towards the static file the asset represents. nullable: true description: Handles pointing towards binary content that advertisers can use later on, for example in their creatives. nullable: true x-criteo-canonical: infoType: entity name: RetailMediaAsset version: '202110' AssetResource: type: object properties: attributes: $ref: '#/components/schemas/Asset' id: type: string nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API nullable: true AssetResponse: type: object properties: data: $ref: '#/components/schemas/AssetResource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity AsyncAttributedTransactionsReport: required: - dimensions - endDate - filters - metrics - startDate type: object properties: clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string clickMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string default: campaign dimensions: type: array items: enum: - purchasedDate - purchasedHour - advertisedDate - advertisedHour - daysDifference - accountId - accountName - campaignId - campaignName - lineItemId - lineItemName - advertisedProductId - advertisedProductGtin - advertisedProductMpn - advertisedProductName - advertisedProductCategory - purchasedProductId - purchasedProductGtin - purchasedProductMpn - purchasedProductName - purchasedProductCategory - advertisedEngagement - advertisedToPurchasedProductRelationship - salesChannel - retailerId - retailerName - pageType - keyword - attributionWindow - saleSellerId - saleSellerName - activitySellerId - activitySellerName type: string endDate: type: string format: date-time filters: $ref: '#/components/schemas/AttributedTransactionsReportFilters' format: enum: - json - json-compact - json-newline - csv type: string metrics: type: array items: enum: - attributedUnits - attributedSales type: string startDate: type: string format: date-time timezone: type: string default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string viewMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string default: campaign description: Create payload attributes for an attributed-transactions async report. AsyncAttributedTransactionsReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncAttributedTransactionsReportResource' description: A top-level object that encapsulates an attributed-transactions async report create request. AsyncAttributedTransactionsReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncAttributedTransactionsReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AsyncFillRateReport: required: - dimensions - endDate - metrics - startDate - supplyAccountIds type: object properties: adServerType: enum: - all - gam - criteo type: string description: 'Filter on the type of the ad server: criteo, gam, all' default: all dimensions: minItems: 1 type: array items: enum: - date - retailerId - retailerName - placementId - placementName - pageTypeName - environment - servedCategory - retailerCategoryId - retailerCategoryName - adServerType type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time format: enum: - json - json-compact - json-newline - csv type: string description: Format of the output default: json metrics: minItems: 1 type: array items: enum: - pageViews - availablePlacements - unfilledPlacements - fillRate - placementImpressions - productImpressions - impressions - placementClicks - productClicks - clicks - placementImpressionsCTR - productImpressionsCTR - cpm - cpc - placementImpressionsRevenue - productClicksRevenue - revenue - workingMedia - netRevenue - nonDeliverablePlacements - deliverablePlacements - placementsWithCandidates - coveredPlacements - coverageRate type: string description: List of metrics to report on startDate: type: string description: Start date format: date-time supplyAccountIds: type: array items: type: string description: Supply account ids to report on timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC description: Async FillRate report body request AsyncFillRateReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncFillRateReportResource' description: A top-level object that encapsulates a Criteo API request for a single value AsyncFillRateReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncFillRateReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AsyncMissedOpportunitiesReport: required: - dimensions - endDate - filters - metrics - startDate type: object properties: dimensions: type: array items: enum: - date - accountId - accountName - campaignId - campaignName - lineItemId - lineItemName - retailerId - retailerName - buyType - bidStrategy type: string endDate: type: string format: date-time filters: $ref: '#/components/schemas/MissedOpportunitiesReportFilters' format: enum: - json - json-compact - json-newline - csv type: string metrics: type: array items: enum: - daypartingScheduled - totalSpend - roas - capoutHour - attributedSales - impressions - clicks - cpc - cpm - ctr - missedTraffic - missedSpend - missedClicks - missedImpressions - missedSales type: string startDate: type: string format: date-time description: Create payload attributes for a missed-opportunities async report. AsyncMissedOpportunitiesReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncMissedOpportunitiesReportResource' description: A top-level object that encapsulates a missed-opportunities async report create request. AsyncMissedOpportunitiesReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncMissedOpportunitiesReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AsyncPerformanceReport: required: - dimensions - endDate - filters - metrics - startDate type: object properties: clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string clickMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string default: campaign dimensions: type: array items: enum: - date - hour - accountId - accountName - campaignId - campaignName - campaignType - lineItemId - lineItemName - retailerId - retailerName - brandId - brandName - productCategory - productId - productName - salesChannel - mediaType - buyType - budgetModel - activationPlatform - environment - pageType - pageCategory - servedCategory - keyword - searchTerm - searchTermType - searchTermTargeting - creativeId - creativeName - creativeType - creativeTemplateId - creativeTemplateName - targetedKeywordType type: string endDate: type: string format: date-time filters: $ref: '#/components/schemas/PerformanceReportFilters' format: enum: - json - json-compact - json-newline - csv type: string metrics: type: array items: enum: - impressions - clicks - spend - attributedSales - attributedUnits - attributedOrders - assistedSales - assistedUnits - ctr - cpc - cpo - cpm - roas - videoViews - videosStarted - videosPlayedTo25 - videosPlayedTo50 - videosPlayedTo75 - videosPlayedTo100 - videoPlayingRate - videoCompletionRate - videoImpressions - videoMuted - videoUnmuted - videoPaused - videoResumed - videoAvgInteractionRate - videoViewability - videoStartingRate - videoCPC - videoCPCV - newToBrandAttributedSales - newToBrandAttributedSalesRate - newToBrandAttributedUnits - newToBrandAttributedUnitsRate - uniqueVisitors - frequency - winRate - sampledBidsWon - sampledBidsParticipated type: string startDate: type: string format: date-time timezone: type: string default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string viewMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string default: campaign description: Create payload attributes for a performance DSP analytics async report. AsyncPerformanceReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncPerformanceReportResource' description: A top-level object that encapsulates a performance DSP analytics async report create request. AsyncPerformanceReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncPerformanceReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AsyncReportResponse: type: object properties: data: $ref: '#/components/schemas/StatusResponseResource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: Async Report response format AsyncRevenueReport: required: - endDate - startDate type: object properties: accountIds: type: array items: type: string description: Account ids to filter activationPlatforms: type: array items: enum: - CommerceMax - PrivateMarket type: string description: 'Filter on the activation platform: CommerceMax, PrivateMarket' advertiserTypes: type: array items: enum: - retailer - brand - seller type: string description: 'Filter on the type of advertiser: retailer, brand, seller' budgetModels: type: array items: enum: - CriteoBudget - RetailerBudget type: string description: 'Filter on the budget model: CriteoBudget, RetailerBudget' buyType: enum: - auction - preferredDeals - sponsorship type: string description: 'Filter on buy type: Auction, Preferred Deals or Sponsorship' campaignIds: type: array items: type: string description: Campaign ids to filter campaignType: enum: - all - sponsoredProducts - onSiteDisplays type: string description: 'Filter the type of campaigns to report on: sponsoredProducts or onSiteDisplays' default: all clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string description: Click attribution window default: none clickMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string description: 'Click Match Level: Campaign, Same SKU, Same Category or Same Brand' default: campaign dimensions: type: array items: enum: - date - hour - parentAccount - accountId - accountName - accountTypeName - advertiserType - campaignId - campaignName - campaignTypeName - campaignStartDate - campaignEndDate - lineItemId - lineItemName - lineItemStartDate - lineItemEndDate - lineItemStatus - retailerId - retailerName - brandId - brandName - placementId - placementName - pageTypeName - environment - pageCategory - advProductId - advProductName - advProductGtin - advProductMpn - buyType - budgetModel - activationPlatform - soldBy - saleChannel - salesChannel - mediaType - attributionSettings - activityType - keyword - skuRelation - retailerCategoryId - retailerCategoryName - taxonomyBreadcrumb - taxonomy1Id - taxonomy1Name - taxonomy2Id - taxonomy2Name - taxonomy3Id - taxonomy3Name - taxonomy4Id - taxonomy4Name - taxonomy5Id - taxonomy5Name - taxonomy6Id - taxonomy6Name - taxonomy7Id - taxonomy7Name - targetedKeywordType type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time format: enum: - json - json-compact - json-newline - csv type: string description: Format of the output default: json id: type: string description: Supply account id to report on ids: type: array items: type: string description: Supply account ids to report on lineItemIds: type: array items: type: string description: Line item ids to filter mediaType: enum: - unknown - video - display - all type: string description: 'Filter on the type of media: unknown, display, video' default: all metrics: type: array items: enum: - numberOfCampaigns - numberOfLineItems - numberOfSkus - skuPrice - pageViews - impressions - productClicks - placementClicks - clicks - sales - units - transactions - assistedSales - assistedUnits - revenue - openAuctionRevenue - preferredDealsRevenue - ctr - cr - cpc - cpm - roas - workingMedia - netRevenue - videoViews - videosStarted - videosPlayedTo25 - videosPlayedTo50 - videosPlayedTo75 - videosPlayedTo100 - videoPlayingRate - videoCompletionRate - videoImpressions - videoMuted - videoUnmuted - videoResumed - videoPaused - videoAvgInteractionRate - videoViewability - videoStartingRate - videoCPC - videoCPCV - uniqueVisitors - frequency type: string description: List of metrics to report on reportType: enum: - advertiser - environment - pageType - productCategory - brand type: string description: Type of report, if no dimensions and metrics are provided, falls back to advertiser reportType retailerIds: type: array items: type: string description: Retailer ids to filter revenueType: enum: - auction - preferred type: string description: Type of revenue salesChannel: enum: - online - offline - all type: string description: 'Filter on specific sales channel: offline or online' default: all skuRelations: type: array items: enum: - sameSku - sameParentSku - sameCategory - sameBrand - sameSeller type: string description: 'Filter on sku relations: Same SKU, Same Parent SKU, Same Category, Same Brand or Same Seller' soldBy: enum: - directSold - indirectSold - privateMarket - authorizedBuyer type: string description: 'Filter on the seller: Indirect Sold, Direct Sold, Authorized Buyer or Private Market' startDate: type: string description: Start date format: date-time targetedKeywordTypes: type: array items: enum: - unknown - generic - branded - conquesting type: string description: 'Filter on targeted keyword type: unknown, generic, branded, conquesting' timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string description: View attribution window default: none viewMatchLevel: enum: - sameSku - sameCategory - sameBrand - campaign type: string description: 'View Match Level: Campaign, Same SKU, Same Category or Same Brand' default: campaign description: Async Revenue report body request AsyncRevenueReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncRevenueReportResource' description: A top-level object that encapsulates a Criteo API request for a single value AsyncRevenueReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncRevenueReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AsyncUnfilledPlacementsReport: required: - dimensions - endDate - metrics - startDate - supplyAccountIds type: object properties: adServerType: enum: - all - gam - criteo type: string description: 'Filter on the type of the ad server: criteo, gam, all' default: all campaignType: enum: - all - sponsoredProducts - onSiteDisplays type: string description: 'Filter on the type of the campaign: onsite display, onsite sponsored products, all' default: all dimensions: minItems: 1 type: array items: enum: - date - retailerId - retailerName - placementId - placementName - pageTypeName - servedCategory - environment - retailerCategoryId - retailerCategoryName - adServerType - campaignType type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time format: enum: - json - json-compact - json-newline - csv type: string description: Format of the output default: json metrics: minItems: 1 type: array items: enum: - totalUnfilledPlacements - unfilledUserOptOut - unfilledNotEnoughDemand - unfilledTotalAuctionSettings - unfilledTotalAuctionConsiderations - unfilledAdvertiserAuctionSettings - unfilledRetailerAuctionSettings - unfilledCriteoAuctionSettings - unfilledReturnedButNotPainted - nonDeliverableUnmappedCategories - nonDeliverablePagesWithUnknownProducts - nonDeliverableBlockedOptOut - nonDeliverableBlockedPageCategory - nonDeliverableInactivePlacement - nonDeliverableInsufficientOrganicResults - nonDeliverableInvalidTraffic - nonDeliverableTestPlacement - uncoveredUnusedFormats - uncoveredSearchTermWithoutCategory - uncoveredNoDemandBrandedKeywordConquestingEnabled - uncoveredNoDemandBrandedKeywordConquestingDisabled - uncoveredNoDemandUnbrandedInventory - uncoveredNoDemandOptOut - uncoveredFilteredOutDemand - uncoveredBrokenPlacement - uncoveredNotPainted - availablePlacements - fillRate - placementImpressions - productImpressions - placementClicks - productClicks - clicks - placementImpressionsCTR - productImpressionsCTR - cpm - cpc - placementImpressionsRevenue - productClicksRevenue - revenue - nonDeliverablePlacements - deliverablePlacements - placementsWithCandidates - coveredPlacements - coverageRate type: string description: List of metrics to report on startDate: type: string description: Start date format: date-time supplyAccountIds: type: array items: type: string description: Supply account ids to report on timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC description: Async Unfilled Placements report body request AsyncUnfilledPlacementsReportRequest: type: object properties: data: $ref: '#/components/schemas/AsyncUnfilledPlacementsReportResource' description: A top-level object that encapsulates a Criteo API request for a single value AsyncUnfilledPlacementsReportResource: type: object properties: attributes: $ref: '#/components/schemas/AsyncUnfilledPlacementsReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value AttributedTransactionsReportFilters: type: object properties: accountIds: type: array items: type: string campaignIds: type: array items: type: string lineItemIds: type: array items: type: string mediaTypes: type: array items: enum: - unknown - video - display - all type: string description: Array-valued constraints for attributed-transactions reporting. Exactly one of accountIds, campaignIds, or lineItemIds is required. AudienceError: required: - code - instance - type type: object properties: code: type: string description: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. detail: type: string description: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: (REQUIRED) A URI reference that identifies the specific occurrence of the problem source: type: object description: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: array items: type: string description: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type nullable: true traceId: type: string description: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error description: Definition of an audience error AudienceIdsUpdateModel202110: required: - audienceIds type: object properties: audienceIds: type: array items: type: string description: Audience ids that should be targeted format: long-id description: Audience ids that should be targeted description: Update model for updating audience target ids AudienceIdsUpdateModel202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAudienceIdsUpdateModel202110' description: Data model for a value type input resource AudienceTarget202110: required: - scope - audienceIds type: object properties: audienceIds: type: array items: type: string description: Audience ids that should be targeted format: long-id description: Audience ids that should be targeted scope: enum: - unknown - include - exclude type: string description: Scope of the audience target description: Identifies audience targeting for a line item AudienceTarget202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAudienceTarget202110' description: Data model for a value type input resource AudienceTarget202110Response: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfAudienceTarget202110' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a value type resource outcome AudienceWarning: required: - code - detail - instance - type type: object properties: code: type: string description: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. detail: type: string description: (REQUIRED) A human-readable explanation specific to this occurrence of the problem instance: type: string description: (REQUIRED) A URI reference that identifies the specific occurrence of the problem source: type: object description: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: array items: type: string description: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type nullable: true traceId: type: string description: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error description: Definition of the warning BalanceCampaign202110: type: object description: Campaigns related to the balance BalanceCampaign202110PagedListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfBalanceCampaign202110' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a paged list of response resources BalanceCampaignsV1: required: - ids type: object properties: ids: type: array items: type: string description: The ids of the campaigns that are mapped to the balance. additionalProperties: false description: Balance campaigns mapping object. nullable: true BalanceHistoryChangeDataCaptureV1: required: - changeDetails - changeType - dateOfModification - modifiedByUser type: object properties: changeDetails: $ref: '#/components/schemas/ChangeDetailsV1' changeType: enum: - BalanceCreated - BalanceAdded - BalanceRemoved - BalanceUncapped - BalanceCapped - EndDate - StartDate - BalanceName - RetailerPoNumber - CriteoPoNumber - RetailerId - ValueAdd - Unknown type: string description: Represent the type of change states of the history. dateOfModification: type: string description: Date when data change has occured. format: date-time memo: type: string description: Memo associate with the insertion order modification. nullable: true modifiedByUser: type: string description: Username who modified the insertion order. additionalProperties: false description: Data model represents the data change capture of balance history. nullable: true BalanceResponseV1: required: - balanceType - createdAt - deposited - endDate - memo - name - privateMarketBillingType - remaining - retailerPoNumber - spendType - spent - startDate - status - updatedAt type: object properties: balanceType: enum: - unknown - capped - uncapped type: string description: Type of the balance. createdAt: type: string description: Creation time of the balance. format: date-time deposited: type: number description: Amount of billable funds allotted to the balance. format: double nullable: true endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. privateMarketBillingType: enum: - notApplicable - billByRetailer - billByCriteo - unknown type: string description: Billing type for Private Market of the balance. remaining: type: number description: Amount of remaining funds of the balance. format: double nullable: true retailerPoNumber: type: string description: Purchase Order number. nullable: true spendType: enum: - unknown - onsite - offsite - offsiteAwareness type: string description: Spend Type of the balance. spent: type: number description: Amount of spent funds of the balance. format: double nullable: true startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. status: enum: - unknown - scheduled - active - ended type: string description: Status of the balance. updatedAt: type: string description: Update time of the balance. format: date-time additionalProperties: false description: A Retail Media Balance used to determine the funds available for any or all campaigns in an account nullable: true BalanceResponseV2: required: - name - startDate - balanceType - spendType - privateMarketBillingType type: object properties: balanceType: enum: - unknown - capped - uncapped type: string description: Type of the balance. createdAt: type: string description: Creation time of the balance. format: date-time deposited: type: number description: Amount of billable funds allotted to the balance. format: double nullable: true endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. poNumber: type: string description: Purchase Order number. nullable: true privateMarketBillingType: enum: - notApplicable - billByRetailer - billByCriteo - unknown type: string description: Billing type for Private Market of the balance. remaining: type: number description: Amount of remaining funds of the balance. format: double nullable: true spendType: enum: - Onsite - Offsite - OffsiteAwareness type: string description: Spend Type of the balance. spent: type: number description: Amount of spent funds of the balance. format: double nullable: true startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. status: enum: - unknown - scheduled - active - ended type: string description: Status of the balance. updatedAt: type: string description: Update time of the balance. format: date-time description: A Retail Media Balance used to determine the funds available for any or all campaigns in an account nullable: true BalanceResponseV2Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfBalanceResponseV2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity nullable: true BalanceResponseV3: required: - name - startDate - balanceType - spendType - privateMarketBillingType type: object properties: balanceType: enum: - unknown - capped - uncapped type: string description: Type of the balance. createdAt: type: string description: Creation time of the balance. format: date-time deposited: type: number description: Amount of billable funds allotted to the balance. format: double nullable: true endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. privateMarketBillingType: enum: - notApplicable - billByRetailer - billByCriteo - unknown type: string description: Billing type for Private Market of the balance. remaining: type: number description: Amount of remaining funds of the balance. format: double nullable: true retailerPoNumber: type: string description: Purchase Order number. nullable: true spendType: enum: - Onsite - Offsite - OffsiteAwareness type: string description: Spend Type of the balance. spent: type: number description: Amount of spent funds of the balance. format: double nullable: true startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. status: enum: - unknown - scheduled - active - ended type: string description: Status of the balance. updatedAt: type: string description: Update time of the balance. format: date-time description: A Retail Media Balance used to determine the funds available for any or all campaigns in an account nullable: true BalanceResponseV3Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfBalanceResponseV3' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity nullable: true BalanceV1: required: - balanceType - createdAt - deposited - name - privateMarketBillingType - remaining - spendType - spent - startDate - status - updatedAt type: object properties: balanceType: enum: - unknown - capped - uncapped type: string description: Type of the balance. createdAt: type: string description: Creation time of the balance. format: date-time criteoPoNumber: type: string description: Criteo purchase order number. nullable: true deposited: type: number description: Amount of billable funds allotted to the balance. format: double endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. privateMarketBillingType: enum: - notApplicable - billByRetailer - billByCriteo - unknown type: string description: Billing type for Private Market of the balance. remaining: type: number description: Amount of remaining funds of the balance. format: double retailerId: type: string description: The billing retailer id. nullable: true retailerPoNumber: type: string description: Retailer purchase order number. nullable: true spendType: enum: - onsite - offsite - offsiteAwareness - lockout - unknown type: string description: Spend Type of the balance. spent: type: number description: Amount of spent funds of the balance. format: double startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. status: enum: - unknown - scheduled - active - ended type: string description: Status of the balance. updatedAt: type: string description: Update time of the balance. format: date-time additionalProperties: false description: A Retail Media Balance used to determine the funds available for any or all campaigns in an account. nullable: true BatchStoreInventoryDeleteRequest: required: - data type: object properties: data: type: array items: $ref: '#/components/schemas/DeleteEntry' description: Batch to plan removals in Store inventory BatchStoreInventoryRequest: required: - data type: object properties: data: type: array items: $ref: '#/components/schemas/InsertEntry' description: Batch to be stored in Store inventories BrandCatalogRequestV2: type: object properties: brandIdFilter: type: array items: type: string description: The brand ids to filter the catalog by. format: long-id description: The brand ids to filter the catalog by. nullable: true includeFields: type: array items: enum: - Unknown - Description - ImageUrl - GoogleCategory - RetailerName - Category - BrandName type: string description: Out of the optional fields, only the ones specified will be included in the catalog generated. nullable: true modifiedAfter: type: string description: Only products modified after this time will be returned. format: date-time nullable: true retailerIdFilter: type: array items: type: integer format: int32 description: The retailer ids to filter the catalog by. nullable: true additionalProperties: false description: A request for a catalog under the specified format. BrandIdSearchRequest: required: - retailerIds type: object properties: brandType: enum: - uc - retailer - all type: string description: 'The type of brand, primarily where this brand belongs: UC, Retailer or All (both)' name: type: string description: The name of the brand(s) to be searched nullable: true retailerIds: minItems: 1 type: array items: type: integer format: int32 description: IDs of the retailers we want to limit the search to description: An object that represents the request of BrandIdSearch endpoint. BrandIdSearchResult: required: - brandType - id - name - retailerIds type: object properties: brandType: type: string description: The type of the brand id: type: string description: The brand id name: type: string description: The name of the brand retailerIds: type: array items: type: integer format: int32 description: The retailer ids associated to the brand description: An object that represents the result from a brand ID search. nullable: true CampaignAttributesV202301: required: - name - isAutoDailyPacing type: object properties: budget: type: number format: double nullable: true clickAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true clickAttributionWindow: enum: - 7D - 14D - 30D - unknown type: string default: 30D companyName: type: string nullable: true dailyPacing: type: number format: double nullable: true drawableBalanceIds: type: array items: type: string format: long-id endDate: type: string format: date-time nullable: true isAutoDailyPacing: type: boolean monthlyPacing: type: number format: double nullable: true name: maxLength: 255 minLength: 0 type: string onBehalfCompanyName: type: string nullable: true retailerId: type: integer format: int32 startDate: type: string format: date-time nullable: true type: enum: - unknown - auction - preferred type: string default: auction viewAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D - unknown type: string default: none description: An object that represents the available options to set when creating a Retail Media Campaign CampaignAvailabilityV2: type: object properties: budgetModelAvailabilities: type: array items: enum: - unknown - criteoBudget - retailerBudget type: string description: Possible budget models for retail media campaigns description: The budget models available for this campaign type and buy type combination. Presence of a value indicates that budget model is available. nullable: true buyType: enum: - unknown - auction - preferredDeals - sponsorship - offsite type: string description: The buy type this object represents availability for nullable: true campaignType: enum: - unknown - sponsoredProducts - onsiteDisplay - offsite type: string description: The type of campaign this object represents availability for nullable: true validCombinations: type: array items: $ref: '#/components/schemas/PageTypeCombinationV2' description: PageType-PageEnvironmentType pairs which are supported for this campaign-buy type combination nullable: true additionalProperties: false description: Information about the budget model availability for a specific campaign type and buy type combination, and page types and environments supported for that combination CampaignBudgetOverrides: required: - dailyBudgetOverrides - monthlyBudgetOverrides type: object properties: dailyBudgetOverrides: type: array items: $ref: '#/components/schemas/CampaignDailyBudgetOverride' description: Campaign budget override daily part, chronological order restricted. monthlyBudgetOverrides: type: array items: $ref: '#/components/schemas/CampaignMonthlyBudgetOverride' description: Campaign budget override monthly part, chronological order restricted. additionalProperties: false description: Campaign budget overrides including Monthly and Daily budget overrides. nullable: true CampaignDailyBudgetOverride: required: - duration - maxDailySpend type: object properties: duration: type: string description: The number of DAYs that the override is active from StartDate, e.g. "1D". Must end with 'D' or 'd'. maxDailySpend: type: number description: Daily budget override maximum daily spend amount. format: double startDate: type: string description: Daily budget override start date, format "yyyy-MM-dd". If it is null, the StartDate would be the following date of the last item in the override sequence. format: date-time nullable: true status: enum: - Expired - Active - Upcoming type: string description: Daily budget override computed status. nullable: true additionalProperties: false description: Campaign daily budget override. CampaignMonthlyBudgetOverride: required: - duration - maxMonthlySpend type: object properties: duration: type: string description: The number of MONTHs that the override is active from StartMonth, e.g. "1M". Must end with 'M' or 'm'. maxMonthlySpend: type: number description: Monthly budget override maximum monthly spend amount. format: double startMonth: type: string description: Monthly budget override start month, format "yyyy-MM". If it is null, the StartMonth would be the following month of the last item in the override sequence. format: date-time nullable: true status: enum: - Expired - Active - Upcoming type: string description: Monthly budget override computed status. nullable: true additionalProperties: false description: Campaign monthly budget override. CampaignV202301: required: - accountId - createdAt - updatedAt - name - isAutoDailyPacing type: object properties: accountId: type: string format: long-id budget: type: number format: double nullable: true budgetRemaining: type: number format: double nullable: true budgetSpent: type: number format: double nullable: true clickAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true clickAttributionWindow: enum: - 7D - 14D - 30D - unknown type: string default: 30D companyName: type: string nullable: true createdAt: type: string format: date-time dailyPacing: type: number format: double nullable: true drawableBalanceIds: type: array items: type: string format: long-id endDate: type: string format: date-time nullable: true isAutoDailyPacing: type: boolean monthlyPacing: type: number format: double nullable: true name: maxLength: 255 minLength: 0 type: string onBehalfCompanyName: type: string nullable: true promotedBrandIds: type: array items: type: string format: long-id retailerId: type: integer format: int32 nullable: true startDate: type: string format: date-time nullable: true status: enum: - unknown - active - inactive - scheduled - ended type: string type: enum: - unknown - auction - preferred type: string default: auction updatedAt: type: string format: date-time viewAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D - unknown type: string default: none description: A Retail Media Campaign used to represent an advertiser's marketing objective CatalogStatusV2: required: - createdAt - status type: object properties: createdAt: type: string description: The time this catalog was created. Represented as a UTC ISO8601 string. format: date-time fileSizeBytes: type: integer description: The size of this catalog in bytes. Available when this catalog reaches a success status. format: int32 nullable: true md5Checksum: type: string description: "An MD5 checksum of the catalog for use in confirming complete and uncorrupted retrieval.\r\nAvailable when this catalog reaches a success status." nullable: true message: type: string description: An optional information message intended for developer consumption. nullable: true rowCount: type: integer description: "An indication of the number of products contained in this catalog. Available when\r\nthis catalog reaches a success status." format: int32 nullable: true status: enum: - unknown - pending - success - failure - expired type: string description: An enumeration of the status of the catalog. additionalProperties: false description: The status of an asynchronous request to generate a catalog nullable: true CategoriesSearchRequestV1: type: object properties: categoryIds: minItems: 1 type: array items: type: string description: Categories search category ids criteria. nullable: true textSubstring: type: string description: Categories search text substring criteria. nullable: true description: An object that represents the request of CategoriesSearch endpoint. Category202204: required: - name - parentId - text type: object properties: name: type: string description: Category Name parentId: type: string description: Category ParentId text: type: string description: Category Text additionalProperties: false description: List of retailer's categories, including the full hierarchy of categories and their parent category ID nullable: true Category202204ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfCategory202204' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities. ChangeDatesOfBalanceV2: type: object properties: endDate: type: string description: End date of the balance in the format YYYY-MM-DD. memo: type: string description: Memo. startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. description: An object that represents the available options to modify schedule of a balance. ChangeDatesOfBalanceV2Request: type: object properties: data: $ref: '#/components/schemas/ResourceOfChangeDatesOfBalanceV2' description: A top-level object that encapsulates a Criteo API request for a single entity ChangeDetailsV1: type: object properties: changeValue: type: string description: Change amount of a property of the insertion order. nullable: true currentValue: type: string description: Current value of a property of the insertion order. nullable: true previousValue: type: string description: Previous value of a property of the insertion order. nullable: true additionalProperties: false description: Change details of a property of the balance. ChoiceOption: required: - dependentVariables - id type: object properties: dependentVariables: type: array items: $ref: '#/components/schemas/TemplateVariable' description: Template variables unblocked when the option is chosen id: type: string description: The id of the option additionalProperties: false description: An option given in a choice ChoiceVariableSpecification: required: - options type: object properties: maxSelected: type: integer description: The maximum number of selectable options format: int32 nullable: true minSelected: type: integer description: The minimum number of selectable options format: int32 nullable: true options: type: array items: $ref: '#/components/schemas/ChoiceOption' description: The available options additionalProperties: false description: Specification of choice variable nullable: true ChoiceVariableValue: required: - chosenOptions type: object properties: chosenOptions: type: array items: type: string description: The chosen options additionalProperties: false description: A value of a template choice variable (among different accepted options) nullable: true ColorVariableValue: required: - color type: object properties: color: pattern: ^#(([0-9a-fA-F]{2}){3}|([0-9a-fA-F]){3})$ type: string description: The displayed color (HEX format) nullable: true additionalProperties: false description: A value of a template color variable nullable: true CommonError: type: object properties: code: type: string description: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. nullable: true detail: type: string description: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem. nullable: true instance: type: string description: (REQUIRED) A URI reference that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string description: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type. nullable: true traceId: type: string description: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error. nullable: true additionalProperties: false description: A JSON:API Common error structure CommonLineItem: required: - name - type - startDate - targetRetailerId - campaignId type: object properties: budget: type: number format: double nullable: true budgetRemaining: type: number format: double nullable: true budgetSpent: type: number format: double campaignId: type: string format: long-id createdAt: type: string format: date-time endDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date nullable: true id: type: string nullable: true name: maxLength: 255 minLength: 0 type: string startDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date status: enum: - unknown - active - scheduled - draft - paused - budgetHit - ended - archived - noFunds type: string targetRetailerId: type: string format: long-id type: enum: - unknown - auction - preferred type: string updatedAt: type: string format: date-time description: A common line item to hold line item information shared between preferred and auction line items CommonLineItemPagedListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfCommonLineItem' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a paged list of response resources CommonLineItemResponse: type: object properties: data: $ref: '#/components/schemas/ResourceOfCommonLineItem' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity CommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true traceIdentifier: type: string description: The request correlation ID this problem comes from. (deprecated, use traceId instead) nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true description: Common problem object. CommonWarning: type: object properties: code: type: string description: (REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case. nullable: true detail: type: string description: (RECOMMENDED) A human-readable explanation specific to this occurrence of the problem. nullable: true instance: type: string description: (REQUIRED) A URI reference that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: (OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string description: (NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology nullable: true title: type: string description: (RECOMMENDED) A short, human-readable summary of the problem type. nullable: true traceId: type: string description: (REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem. nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: (REQUIRED) The classification of the error. nullable: true additionalProperties: false description: A JSON:API Base common warning CpcMinBidsRequest: required: - skuIds type: object properties: skuIds: type: array items: type: string description: Sku id list for which minimum bid amounts are requested. additionalProperties: false description: Cpc Min Bids request object. CpcMinBidsResponse: required: - overallMinBid - skuMinBids type: object properties: overallMinBid: type: number description: Overall minimum bid amount for the given list of sku ids. format: double skuMinBids: type: array items: $ref: '#/components/schemas/SkuMinBid' description: Minimum bid amounts for each of the given list of sku ids. additionalProperties: false description: Cpc Min Bids response object. nullable: true CreateBalanceV3: required: - name - startDate - spendType type: object properties: deposited: type: number description: Amount of billable funds allotted to the balance. format: double endDate: type: string description: End date of the balance in the format YYYY-MM-DD. nullable: true memo: type: string description: Memo nullable: true name: type: string description: Name of the balance. retailerPoNumber: type: string description: Purchase Order number. nullable: true spendType: enum: - Onsite - Offsite - OffsiteAwareness type: string description: Type of the balance spend. startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. description: An object that represents the available options to set when creating a Retail Media Balance CreateBalanceV3Request: type: object properties: data: $ref: '#/components/schemas/ResourceOfCreateBalanceV3' description: A top-level object that encapsulates a Criteo API request for a single entity Creative2: required: - creativeFormatV2Type - environments - formatId - name - retailerId - status - templateId - templateName - templateVariableValues type: object properties: associatedLineItemIds: type: array items: type: string description: Associated Line Item Ids nullable: true brandId: type: integer description: Brand Id format: int64 nullable: true creativeFormatV2Type: enum: - Unknown - FlagShip - Showcase - SponsoredProducts - Butterfly - BundleBoost - IAB - Custom - DisplayPanel - DigitalShelfTalker type: string description: Creative format type environments: type: array items: $ref: '#/components/schemas/PageTypeEnvironment2' description: Environment type (e.g. mobile, web, app) formatId: type: integer description: Format Id format: int32 id: type: string nullable: true name: type: string description: Name retailerId: type: integer description: Retailer Id format: int32 status: enum: - Ready - InUse - Archived - Deleted type: string description: Creative Status templateId: type: integer description: Template Id format: int32 templateName: type: string description: Template Name templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values updatedAt: type: string description: Updated at time format: date-time nullable: true additionalProperties: false description: A creative entity nullable: true Creative202110: required: - name - retailerId - status type: object properties: associatedLineItemIds: type: array items: type: string nullable: true brandId: type: integer format: int64 nullable: true id: type: string nullable: true name: type: string retailerId: type: integer format: int32 status: enum: - Ready - In_Use - Archived - Deleted type: string updatedAt: type: string format: date-time nullable: true additionalProperties: false description: Metadata and usage info of a preferred deals creative nullable: true Creative202110ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfCreative202110' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities. Creative202210: required: - creativeFormatType - environments - formatId - name - retailerId - status - templateId - templateName - templateVariableValues type: object properties: associatedLineItemIds: type: array items: type: string description: Associated Line Item Ids nullable: true brandId: type: integer description: Brand Id format: int64 nullable: true creativeFormatType: enum: - Unknown - FlagShip - Showcase - SponsoredProducts - Butterfly - BundleBoost - IAB - CUSTOM - DisplayPanel - DigitalShelfTalker - CommerceVideoSpotlight - BrandingVideoStandout - CommerceDisplaySpotlight - BrandingDisplaySpotlightSolo - CommerceDisplayGridShelf - CommerceDisplayGridDuet - BrandingDisplayGridSolo - CommerceVideoGridDuet type: string description: Creative format type environments: type: array items: $ref: '#/components/schemas/PageTypeEnvironment202210' description: Environment type (e.g. mobile, web, app) formatId: type: integer description: Format Id format: int32 id: type: string nullable: true name: type: string description: Name retailerId: type: integer description: Retailer Id format: int32 status: enum: - Ready - In_Use - Archived - Deleted type: string description: Creative Status templateId: type: integer description: Template Id format: int32 templateName: type: string description: Template Name templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values updatedAt: type: string description: Updated at time format: date-time nullable: true additionalProperties: false description: A creative entity nullable: true Creative202210Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfCreative202210' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. Creative2ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfCreative2' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities. Creative2Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfCreative2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. CreativeCreateModel202207: required: - name - retailerId - templateId - templateVariableValues type: object properties: brandId: type: integer description: The brand associated to the creative format: int64 nullable: true id: type: string nullable: true name: type: string description: The name of the creative retailerId: type: integer description: The retailer associated to the creative format: int32 templateId: type: integer description: The creative template used for this creative format: int32 templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values additionalProperties: false description: Create model of a creative CreativeUpdateModel202207: required: - name - retailerId - templateId - templateVariableValues type: object properties: brandId: type: integer description: The brand associated to the creative format: int64 id: type: string nullable: true name: type: string description: The name of the creative retailerId: type: integer description: The retailer associated to the creative format: int32 templateId: type: integer description: The creative template used for this creative format: int32 templateVariableValues: type: array items: $ref: '#/components/schemas/TemplateVariableValue' description: The template chosen values additionalProperties: false description: Update model of a creative DailyLineItemBudgetOverride: required: - duration type: object properties: duration: type: string description: The number of DAYs that the override is active from StartDate, e.g. "1D". Must end with 'D' or 'd'. maxDailySpend: type: number description: Daily budget override maximum daily spend amount. format: double nullable: true startDate: type: string description: Daily budget override start date, format "yyyy-MM-dd". If it is null, the StartDate would be the following date of the last item in the override sequence. format: date-time nullable: true status: enum: - Expired - Active - Upcoming type: string description: Daily budget override computed status. nullable: true additionalProperties: false description: The details for a daily budget override DataCompleteThrough: type: object properties: dateTime: type: string description: The instant through which data is complete, in the format "yyyy-MM-dd HH:mm:ss" in the timezone given by the {timezone} field. nullable: true timezone: type: string description: IANA timezone for the {dateTime} field (e.g. "UTC", "America/New_York"). Matches the query timezone. nullable: true description: 'Data freshness: the instant through which report data is complete, expressed in the report''s request timezone.' nullable: true DeleteCampaignsRequestV1: required: - ids type: object properties: ids: type: array items: type: string description: The ids of the campaigns that are going to be deleted from balance campaigns mapping. additionalProperties: false description: Request object for deleting campaigns from balance campaigns mapping. DeleteEntry: required: - attributes - type type: object properties: attributes: $ref: '#/components/schemas/StoreInventoryDelete' type: enum: - Delete type: string description: Defines a reference to inventory DemandManagedFee: required: - rate type: object properties: rate: maximum: 1 minimum: 0 type: number description: decimal fee rate between 0 and 1 format: double additionalProperties: false description: settings for DSP fees nullable: true EditableCampaignAttributesV202301: required: - name - isAutoDailyPacing - clickAttributionWindow - viewAttributionWindow type: object properties: budget: type: number format: double nullable: true clickAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true clickAttributionWindow: enum: - 7D - 14D - 30D - unknown type: string companyName: type: string nullable: true dailyPacing: type: number format: double nullable: true endDate: type: string format: date-time nullable: true isAutoDailyPacing: type: boolean monthlyPacing: type: number format: double nullable: true name: maxLength: 255 minLength: 0 type: string onBehalfCompanyName: type: string nullable: true startDate: type: string format: date-time nullable: true viewAttributionScope: enum: - unknown - sameSku - sameSkuCategory - sameSkuCategoryBrand type: string nullable: true viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D - unknown type: string description: An object that represents the available options to set when editing a Retail Media Campaign EntityResourceBalanceV1: type: object properties: attributes: $ref: '#/components/schemas/BalanceV1' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true EntityResourceBrandIdSearchResult: type: object properties: attributes: $ref: '#/components/schemas/BrandIdSearchResult' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true description: A domain entity exposed by the API, identified by a unique id. EntityResourceCategory202204: type: object properties: attributes: $ref: '#/components/schemas/Category202204' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true description: A domain entity exposed by the API, identified by a unique id. EntityResourceCollectionOutcomeBalanceV1AndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceBalanceV1' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeBrandIdSearchResultPagingOffsetLimitMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceBrandIdSearchResult' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/PagingOffsetLimitMetadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeCategory202204: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceCategory202204' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities. EntityResourceCollectionOutcomeCategory202204Metadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceCategory202204' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeLineItemKeywordReviewReportAndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceLineItemKeywordReviewReport' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true meta: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeOfRetailerResultV2AndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceOfRetailerResultV2' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeOfRetailMediaChildAccountAndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceOfRetailMediaChildAccount' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceCollectionOutcomeOfSponsoredProductsLineItemAndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/EntityResourceOfSponsoredProductsLineItem' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities and metadata. EntityResourceLineItemKeywordReviewReport: type: object properties: attributes: $ref: '#/components/schemas/LineItemKeywordReviewReport' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. EntityResourceOfBalanceResponseV1: type: object properties: attributes: $ref: '#/components/schemas/BalanceResponseV1' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true EntityResourceOfCatalogStatusV2: type: object properties: attributes: $ref: '#/components/schemas/CatalogStatusV2' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true EntityResourceOfRetailerResultV2: type: object properties: attributes: $ref: '#/components/schemas/RetailerResultV2' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. EntityResourceOfRetailMediaAccount: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaAccount' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true EntityResourceOfRetailMediaChildAccount: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaChildAccount' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. EntityResourceOfSponsoredProductsLineItem: type: object properties: attributes: $ref: '#/components/schemas/SponsoredProductsLineItem' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true EntityResourceOutcomeBalanceV1: type: object properties: data: $ref: '#/components/schemas/EntityResourceBalanceV1' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourceOutcomeOfBalanceResponseV1: type: object properties: data: $ref: '#/components/schemas/EntityResourceOfBalanceResponseV1' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourceOutcomeOfCatalogStatusV2: type: object properties: data: $ref: '#/components/schemas/EntityResourceOfCatalogStatusV2' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourceOutcomeOfRetailMediaAccount: type: object properties: data: $ref: '#/components/schemas/EntityResourceOfRetailMediaAccount' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourceOutcomeOfSponsoredProductsLineItem: type: object properties: data: $ref: '#/components/schemas/EntityResourceOfSponsoredProductsLineItem' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourceOutcomePartnerBillingReportStatusV1: type: object properties: data: $ref: '#/components/schemas/EntityResourcePartnerBillingReportStatusV1' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. EntityResourcePartnerBillingReportStatusV1: type: object properties: attributes: $ref: '#/components/schemas/PartnerBillingReportStatusV1' id: type: string description: Unique id of the entity. nullable: true type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A domain entity exposed by the API, identified by a unique id. nullable: true ExportReportColumn: required: - name - role - type type: object properties: currency: type: string description: Currency of the column nullable: true deprecated: type: boolean description: Flag for deprecated column nullable: true description: type: string description: Description of the exported column nullable: true duration: type: string description: Duration of the column nullable: true name: type: string description: Name of the exported column role: enum: - Dimension - Property - Interval - Metric type: string description: Role of the column timezone: type: string description: Timezone of the column nullable: true title: type: string description: Title of the exported column nullable: true type: enum: - Boolean - Number - Money - String - Date - DateTime - Interval - Duration type: string description: Type of the column description: Description of a column from an async report request ExportReportMetaData: type: object properties: columns: type: array items: $ref: '#/components/schemas/ExportReportColumn' nullable: true dataCompleteThrough: $ref: '#/components/schemas/DataCompleteThrough' rows: type: integer format: int32 nullable: true description: 'Metadata for a report response: data freshness, column descriptions, and row count.' nullable: true ExternalAccount: required: - countries - currency - name - parentAccountLabel - timeZone - type type: object properties: companyName: type: string nullable: true countries: type: array items: type: string currency: type: string name: maxLength: 510 minLength: 0 type: string onBehalfCompanyName: type: string nullable: true parentAccountLabel: maxLength: 510 minLength: 0 type: string subtype: enum: - unknown - brand - seller type: string nullable: true timeZone: type: string type: enum: - unknown - supply - demand type: string additionalProperties: false description: A Retail Media Account used to launch campaigns and line items nullable: true ExternalBrand: required: - name type: object properties: name: maxLength: 120 minLength: 0 type: string additionalProperties: false description: A Retail Media Brand used to represent a collection of products sold under the same umbrella name nullable: true ExternalCatalogRequest: type: object properties: brandIdFilter: type: array items: type: string format: long-id nullable: true format: enum: - unknown - json-newline type: string description: An enumeration of Catalog formats default: json-newline additionalProperties: false description: A request for a catalog under the specified format. Currently "json-newline" is supported. ExternalCatalogStatus: required: - createdAt - currency - fileSizeBytes - md5Checksum - message - rowCount - status type: object properties: createdAt: type: string description: The time this catalog was created. Represented as a UTC ISO8601 string. format: date-time currency: type: string description: An ISO4217 representation of the currency products are listed under in this catalog. nullable: true fileSizeBytes: type: integer description: The size of this catalog in bytes. Available when this catalog reaches a success status. format: int32 nullable: true md5Checksum: type: string description: "An MD5 checksum of the catalog for use in confirming complete and uncorrupted retrieval.\r\nAvailable when this catalog reaches a success status." nullable: true message: type: string description: An optional information message intended for developer consumption. nullable: true rowCount: type: integer description: "An indication of the number of products contained in this catalog. Available when\r\nthis catalog reaches a success status." format: int32 nullable: true status: enum: - unknown - pending - success - failure - expired type: string description: An enumeration of the status of the catalog. additionalProperties: false description: The status of an asynchronous request to generate a catalog nullable: true ExternalRetailMediaAccount: type: object properties: companyName: type: string description: Paying entity name of ads for the Digital Services Act nullable: true countryIds: type: array items: type: string description: list of countries associated with the account nullable: true currencyId: type: string description: the currency for the account nullable: true name: type: string description: account name nullable: true onBehalfCompanyName: type: string description: On behalf entity name of ads for the Digital Services Act nullable: true parentAccountLabel: type: string description: parent account label for the account nullable: true subType: enum: - Unknown - Brand - Seller type: string description: subtype for the account nullable: true timeZone: type: string description: the timezone for the account nullable: true type: enum: - Unknown - Supply - Demand type: string description: Type for the account nullable: true additionalProperties: false description: The details for a newly created account nullable: true ExternalRetailMediaBrandAccountCreation: type: object properties: brands: type: array items: type: integer format: int64 description: list of brands to link to the new account nullable: true companyName: type: string description: Display name for reporting the owning entity of ads for the Digital Services Act in the European Union nullable: true name: type: string description: the name of the account, must be unique across all accounts nullable: true onBehalfCompanyName: type: string description: On behalf entity name of ads for the Digital Services Act nullable: true additionalProperties: false description: the initial set up and configuration options for a new private market demand brand account ExternalRetailMediaBrands: required: - brandIds type: object properties: brandIds: type: array items: type: integer format: int64 additionalProperties: false description: A collection of brand ids nullable: true ExternalRetailMediaChildAccount: type: object properties: companyName: type: string description: Paying entity name of ads for the Digital Services Act nullable: true countryIds: type: array items: type: string description: list of countries associated with the account nullable: true currencyId: type: string description: the currency for the account nullable: true name: type: string description: account name nullable: true onBehalfCompanyName: type: string description: On behalf entity name of ads for the Digital Services Act nullable: true subType: enum: - Unknown - Brand - Seller type: string description: subtype for the account nullable: true timeZone: type: string description: the timezone for the account nullable: true type: enum: - Unknown - Supply - Demand type: string description: Type for the account nullable: true additionalProperties: false description: The details for a newly created account nullable: true ExternalRetailMediaSeller: required: - retailerId - sellerId type: object properties: retailerId: type: integer description: the retailer id format: int32 sellerId: type: string description: the seller id additionalProperties: false description: used to define the exact seller linked with an account nullable: true ExternalRetailMediaSellerAccountCreation: required: - sellers type: object properties: companyName: type: string description: Display name for reporting the owning entity of ads for the Digital Services Act in the European Union nullable: true name: type: string description: the name of the account, must be unique across all accounts nullable: true onBehalfCompanyName: type: string description: On behalf entity name of ads for the Digital Services Act nullable: true sellers: type: array items: $ref: '#/components/schemas/ExternalRetailMediaSeller' description: list of sellers to associate to the new account additionalProperties: false description: the initial set up and configuration options for a new private market demand brand account FilesVariablesSpecification: required: - extensions type: object properties: extensions: type: array items: enum: - Unknown - Jpeg - Png - Gif - Pdf - Mp4 type: string description: File extensions supported in templates description: The accepted file extensions maxBytes: type: integer description: The maximum amount of bytes per file format: int32 nullable: true maxFile: type: integer description: The maximum amount of files required format: int32 nullable: true minFiles: type: integer description: The minimum amount of files requires format: int32 nullable: true additionalProperties: false description: Specification of a file variable nullable: true FilesVariableValue: required: - assetIds type: object properties: assetIds: type: array items: type: string description: The assets representing the images to be displayed additionalProperties: false description: A value of a template file variable (one or several files), like images in a creative nullable: true FlightLeg: required: - dayOfWeek - endTime - startTime type: object properties: dayOfWeek: enum: - sunday - monday - tuesday - wednesday - thursday - friday - saturday - everyday - weekdays - weekends type: string description: Enum for the days of the week. endTime: pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]$ type: string description: Wall-clock time of day in HH:mm, 24-hour. No timezone. startTime: pattern: ^([01][0-9]|2[0-3]):[0-5][0-9]$ type: string description: Wall-clock time of day in HH:mm, 24-hour. No timezone. additionalProperties: false description: A leg of a flight schedule outlining which days and times the line item will run. FlightSchedule: type: object properties: legs: type: array items: $ref: '#/components/schemas/FlightLeg' description: A list of flight legs on which the line item will run. nullable: true additionalProperties: false description: A flight schedule for a line item. nullable: true GrantConsentInput: type: object properties: data: $ref: '#/components/schemas/GrantConsentModelValueResource' description: An object that encapsulates GrantConsentModel GrantConsentModel: required: - callbackUrl - clientId type: object properties: callbackState: type: string callbackUrl: type: string clientId: type: string description: An object that represents the required (ClientId and CallbackUrl) and optional (CallbackState) parameters when granting consents on behalf of a Private Market demand account GrantConsentModelValueResource: type: object properties: attributes: $ref: '#/components/schemas/GrantConsentModel' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value HyperlinkVariableValue: required: - url type: object properties: url: type: string description: The url to redirect to nullable: true additionalProperties: false description: A value of a template hyperlink variable nullable: true InputKeywords: type: object properties: negativeBroad: type: array items: type: string description: The collection of supplied negative broad phrased nullable: true negativeExact: type: array items: type: string description: The collection of supplied negative exact phrase nullable: true positiveExact: type: array items: type: string description: The collection of supplied positive exact phrases nullable: true additionalProperties: false description: Keywords submitted by the user binned by type after some cleanup has been performed InputKeywordsModel: type: object properties: negativeBroad: type: array items: type: string description: The collection of supplied negative broad phrases. nullable: true negativeExact: type: array items: type: string description: The collection of supplied negative exact phrases. nullable: true positiveExact: type: array items: type: string description: The collection of supplied positive exact phrases. nullable: true additionalProperties: false description: The keywords to be added or removed from a line item. InputResourceOfPreferredLineItemCreateModelV2: type: object properties: attributes: $ref: '#/components/schemas/PreferredLineItemCreateModelV2' type: type: string description: Data model for a Resource InsertEntry: required: - attributes - type type: object properties: attributes: $ref: '#/components/schemas/StoreInventoryUpsert' type: enum: - Upsert type: string description: Defines a pack of inventories JsonApiBodyWithExternalIdOfEditableCampaignAttributesV202301AndCampaignV202301: required: - id - type type: object properties: attributes: $ref: '#/components/schemas/EditableCampaignAttributesV202301' id: type: string format: long-id type: type: string description: "A JSON:API wrapper class to format a with Id, Type, and\r\nAttributes properties" JsonApiBodyWithIdOfInt64AndAccountAndAccount: required: - id - type type: object properties: attributes: $ref: '#/components/schemas/ExternalAccount' id: type: string format: long-id type: type: string additionalProperties: false description: "A JSON:API wrapper class to format a with external Id, Type, and\r\nAttributes properties" JsonApiBodyWithIdOfInt64AndBrandAndBrand: required: - id - type type: object properties: attributes: $ref: '#/components/schemas/ExternalBrand' id: type: string format: long-id type: type: string additionalProperties: false description: "A JSON:API wrapper class to format a with external Id, Type, and\r\nAttributes properties" JsonApiBodyWithIdOfInt64AndCampaignV202301AndCampaignV202301: required: - id - type type: object properties: attributes: $ref: '#/components/schemas/CampaignV202301' id: type: string format: long-id type: type: string description: "A JSON:API wrapper class to format a with Id, Type, and\r\nAttributes properties" JsonApiBodyWithIdOfInt64AndCatalogStatusAndCatalogStatus: required: - id - type type: object properties: attributes: $ref: '#/components/schemas/ExternalCatalogStatus' id: type: string format: long-id type: type: string additionalProperties: false description: "A JSON:API wrapper class to format a with external Id, Type, and\r\nAttributes properties" JsonApiBodyWithLineItemBidMultipliersV2: required: - type type: object properties: attributes: $ref: '#/components/schemas/LineItemBidMultipliersV2' type: type: string description: "A JSON:API wrapper class to format a with Id, Type, and\r\nAttributes properties" JsonApiBodyWithoutIdOfCampaignAttributesV202301AndCampaignV202301: required: - type type: object properties: attributes: $ref: '#/components/schemas/CampaignAttributesV202301' type: type: string description: "A JSON:API wrapper class to format a with Type, and\r\nAttributes properties" JsonApiBodyWithoutIdOfCatalogRequestAndCatalogRequest: required: - type type: object properties: attributes: $ref: '#/components/schemas/ExternalCatalogRequest' type: type: string additionalProperties: false description: "A JSON:API wrapper class to format a with Type, and\r\nAttributes properties" JsonApiBodyWithoutIdOfSellerCatalogRequestAndSellerCatalogRequest: required: - type type: object properties: attributes: $ref: '#/components/schemas/SellerCatalogRequest' type: type: string additionalProperties: false description: "A JSON:API wrapper class to format a with Type, and\r\nAttributes properties" JsonApiPageResponseOfAccount: required: - data - metadata type: object properties: data: type: array items: $ref: '#/components/schemas/JsonApiBodyWithIdOfInt64AndAccountAndAccount' errors: type: array items: $ref: '#/components/schemas/CommonError' nullable: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonWarning' nullable: true additionalProperties: false description: A wrapper class to return a single page of with metadata JsonApiPageResponseOfBrand: required: - data - metadata type: object properties: data: type: array items: $ref: '#/components/schemas/JsonApiBodyWithIdOfInt64AndBrandAndBrand' errors: type: array items: $ref: '#/components/schemas/CommonError' nullable: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonWarning' nullable: true additionalProperties: false description: A wrapper class to return a single page of with metadata JsonApiPageResponseOfCampaignV202301: required: - metadata - data type: object properties: data: type: array items: $ref: '#/components/schemas/JsonApiBodyWithIdOfInt64AndCampaignV202301AndCampaignV202301' errors: type: array items: $ref: '#/components/schemas/CommonError' metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonWarning' description: A wrapper class to return a single page of with metadata JsonApiRequestOfCatalogRequest: type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithoutIdOfCatalogRequestAndCatalogRequest' additionalProperties: false description: A JSON:API wrapper class to format a with Type, and Attributes properties JsonApiRequestOfSellerCatalogRequest: type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithoutIdOfSellerCatalogRequestAndSellerCatalogRequest' additionalProperties: false description: A JSON:API wrapper class to format a with Type, and Attributes properties JsonApiSingleResponseOfCampaignV202301: required: - data type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithIdOfInt64AndCampaignV202301AndCampaignV202301' errors: type: array items: $ref: '#/components/schemas/CommonError' warnings: type: array items: $ref: '#/components/schemas/CommonWarning' description: A JSON:API wrapper class to add one JSON:API within a data property JsonApiSingleResponseOfCatalogStatus: required: - data type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithIdOfInt64AndCatalogStatusAndCatalogStatus' errors: type: array items: $ref: '#/components/schemas/CommonError' nullable: true warnings: type: array items: $ref: '#/components/schemas/CommonWarning' nullable: true additionalProperties: false description: A JSON:API wrapper class to add one JSON:API within a data property JsonApiSingleResponseOfLineItemBidMultipliersV2: required: - data type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithLineItemBidMultipliersV2' errors: type: array items: $ref: '#/components/schemas/CommonError' nullable: true warnings: type: array items: $ref: '#/components/schemas/CommonWarning' nullable: true description: A JSON:API wrapper class to add one JSON:API within a data property KeywordDataModel: type: object properties: bid: type: number description: The bid to use when a positive keyword matches the shopper search phrase. format: double nullable: true createdAt: type: string description: The time at which this keyword was created in UTC. format: date-time inputKeywords: $ref: '#/components/schemas/InputKeywordsModel' matchType: enum: - PositiveExactMatch - NegativeExactMatch - NegativeBroadMatch type: string description: The matching algorithm to be used when comparing this keyword with the shopper search phrase. reviewState: $ref: '#/components/schemas/ReviewStateModel' updatedAt: type: string description: The time at which this keyword was last modified in UTC. format: date-time additionalProperties: false description: A single keyword and associated bid override. Keywords: type: object properties: bid: type: number description: The bid to use when a positive keyword matches the shopper search phrase format: double nullable: true createdAt: type: string description: The time at which this keyword was created in UTC format: date-time inputKeywords: $ref: '#/components/schemas/InputKeywords' matchType: enum: - PositiveExactMatch - NegativeExactMatch - NegativeBroadMatch - Unknown type: string description: The matching algorthim to be use when comparing this keyword with the shopper search phrase reviewState: enum: - InReview - Recommended - Approved - AutoApproved - Rejected - AutoRejected - Unkown type: string description: Review status of the keyword updatedAt: type: string description: The time at which the keyword was last modified in UTC format: date-time additionalProperties: false description: Data associated with a normalized keyword phrase KeywordsModel: type: object properties: keywords: type: object additionalProperties: $ref: '#/components/schemas/KeywordDataModel' description: A dictionary of normalized keywords mapped to their properties. nullable: true rank: type: array items: type: string description: The top suggested keywords for products in this line item ranked by popularity score. nullable: true additionalProperties: false description: The keywords associated with a line item. nullable: true KeywordsModelResource: type: object properties: attributes: $ref: '#/components/schemas/KeywordsModel' id: type: string nullable: true type: type: string nullable: true additionalProperties: false description: Resource object containing keywords associated with a line item. nullable: true KeywordsModelResponse: type: object properties: data: $ref: '#/components/schemas/KeywordsModelResource' errors: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true additionalProperties: false description: Response object containing keywords associated with a line item. LineItemBidMultipliersV2: type: object properties: category: type: number description: Categories Page Type Bid Multiplier format: double nullable: true categoryMenu: type: number description: CategoryMenu Page Type Bid Multiplier format: double nullable: true checkout: type: number description: Checkout Page Type Bid Multiplier format: double nullable: true confirmation: type: number description: Confirmation Page Type Bid Multiplier format: double nullable: true deals: type: number description: Deals Page Type Bid Multiplier format: double nullable: true favorites: type: number description: Favorites Page Type Bid Multiplier format: double nullable: true home: type: number description: Home Page Type Bid Multiplier format: double nullable: true id: type: string nullable: true merchandising: type: number description: Merchandising Page Type Bid Multiplier format: double nullable: true productDetail: type: number description: ProductDetail Page Type Bid Multiplier format: double nullable: true search: type: number description: Search Page Type Bid Multiplier format: double nullable: true searchBar: type: number description: SearchBar Page Type Bid Multiplier format: double nullable: true description: The Bid Multiplier Entity of a LineItem nullable: true LineItemBidMultipliersV2Request: type: object properties: data: $ref: '#/components/schemas/ResourceOfLineItemBidMultipliersV2' description: A top-level object that encapsulates a Criteo API request for a single entity nullable: true LineItemBidMultipliersV2Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfLineItemBidMultipliersV2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity nullable: true LineItemBudgetOverrides: required: - dailyLineItemBudgetOverrides - monthlyLineItemBudgetOverrides type: object properties: dailyLineItemBudgetOverrides: type: array items: $ref: '#/components/schemas/DailyLineItemBudgetOverride' description: Line item budget override daily part, chronological order restricted. monthlyLineItemBudgetOverrides: type: array items: $ref: '#/components/schemas/MonthlyLineItemBudegetOverride' description: Line item budget override monthly part, chronological order restricted. additionalProperties: false description: Line item budget overrides including Monthly and Daily budget overrides. nullable: true LineItemCappingV2: required: - type - count type: object properties: count: type: integer format: int32 type: enum: - unknown - day - session type: string description: Line Item Capping Type Enum description: Frequency Capping for a Preferred Line Item nullable: true LineItemKeywordReviewReport: required: - accountId - accountName - campaignId - campaignName - countKeywords - lineItemId - lineItemName - retailerId - retailerName type: object properties: accountId: type: string description: External ID of the account containing the campaign containing the line item this report is for accountName: type: string description: Name of the account containing the campaign containing the line item this report is for campaignId: type: string description: External ID of the campaign containing the line item this report is for campaignName: type: string description: Name of the campaign containing the line item this report is for countKeywords: type: integer description: Number of PositiveExactMatch keywords on this line item that are in either "InReview" or "Pending" state format: int32 lineItemId: type: string description: External ID of the line item that this report is for lineItemName: type: string description: Name of the line item that this report is for retailerId: type: string description: Retailer ID connected to the line item this report is for retailerName: type: string description: Name of the retailer connected to the line item this report is for additionalProperties: false description: Reports on a line item which contains one or more actionable keyword reviews nullable: true LineItemPageCategoryV2: required: - categoryId type: object properties: categoryId: type: string includeChildren: type: boolean default: true description: Category information for a preferred line item page LineItemPageV2: required: - pageType type: object properties: categories: type: array items: $ref: '#/components/schemas/LineItemPageCategoryV2' nullable: true pageType: enum: - unknown - search - home - browse - checkout - category - productDetail - confirmation - merchandising - deals - favorites - searchBar - categoryMenu type: string description: Page Type Enum searchKeywords: type: array items: type: string nullable: true description: Page information for a preferred line item nullable: true LineItemProductStatus: enum: - unknown - active - paused type: string description: The status of a promoted product in the context of the line item. nullable: true ManagedServiceFee: required: - onsiteDisplayEnabled - onsiteSponsoredProductsEnabled - rate type: object properties: onsiteDisplayEnabled: type: boolean description: whether fee is enabled for display campaigns onsiteSponsoredProductsEnabled: type: boolean description: whether fee is enabled for sponsored product campaigns rate: maximum: 1 minimum: 0 type: number description: decimal fee rate between 0 and 1 format: double additionalProperties: false description: settings for managed service fees nullable: true MatchTypeModel: enum: - PositiveExactMatch - NegativeExactMatch - NegativeBroadMatch type: string description: The match type of a keyword. Metadata: required: - limit - offset type: object properties: count: type: integer format: int64 nullable: true limit: type: integer description: The number of elements to be returned. format: int32 offset: type: integer description: The (zero-based) starting offset in the collection. format: int32 additionalProperties: false description: Metadata related to the current request. nullable: true MissedOpportunitiesReportFilters: type: object properties: accountIds: type: array items: type: string campaignIds: type: array items: type: string lineItemIds: type: array items: type: string description: Array-valued constraints for missed-opportunities reporting. Exactly one of accountIds, campaignIds, or lineItemIds is required. MonthlyLineItemBudegetOverride: required: - duration - maxMonthlySpend type: object properties: duration: type: string description: The number of MONTHs that the override is active from StartMonth, e.g. "1M". Must end with 'M' or 'm'. maxMonthlySpend: type: number description: Monthly budget override maximum monthly spend amount. format: double startMonth: type: string description: Monthly budget override start month, format "yyyy-MM". If it is null, the StartMonth would be the following month of the last item in the override sequence. format: date-time nullable: true status: enum: - Expired - Active - Upcoming type: string description: Monthly budget override computed status. nullable: true additionalProperties: false description: The details for a monthly budget override NillableDecimal: type: object properties: value: type: number description: The value. If missing or null the value is set to "null" format: double nullable: true description: Placeholder object for value for which "null" is a valid business value nullable: true NillableOfNullableOfDateOnly: type: object properties: value: type: string description: Underlying actual value nullable: true additionalProperties: false description: represents a value that can be set to null explicitly nullable: true NillableString: type: object properties: value: type: string description: The string's value. If missing or null the string's value is set to "null" nullable: true description: Placeholder object for string value for which "null" is a valid business value nullable: true PageMetadata: required: - currentPageIndex - currentPageSize type: object properties: currentPageIndex: type: integer format: int32 currentPageSize: type: integer format: int32 nextPage: type: string nullable: true previousPage: type: string nullable: true totalItemsAcrossAllPages: type: integer format: int64 nullable: true totalPages: type: integer format: int64 nullable: true additionalProperties: false description: Metadata related to the current request PageTypeCombinationV2: type: object properties: pageEnvironmentType: enum: - unknown - web - mobile - app - lockout - mixed - ios - android type: string description: The page environment type supported for this campaign-buy type combination nullable: true pageType: enum: - unknown - search - home - checkout - category - productDetail - confirmation - merchandising - deals - favorites - searchbar - categoryMenu - aiAssistant type: string description: The page type supported for this campaign-buy type combination nullable: true additionalProperties: false description: Represents a combination of page type and page environment type for a specific campaign-buy type. PageTypeEnvironment2: type: object properties: environments: type: array items: enum: - Web - Mobile - App - Lockout - Mixed - iOS - Android type: string description: Creative format, defining where the creative can be served description: List of environments per PageType nullable: true pageType: enum: - Unknown - Search - Home - Browse - Checkout - Category - ProductDetail - Confirmation - Merchandising - Deals - Favorites - SearchBar - CategoryMenu type: string description: Creative PageType nullable: true additionalProperties: false description: The PageType-Environment Tuples for creatives PageTypeEnvironment202210: type: object properties: environments: type: array items: enum: - Web - Mobile - App - Lockout - Mixed - iOS - Android type: string description: Creative format, defining where the creative can be served description: List of environments per PageType nullable: true pageType: enum: - Search - Home - Browse - Checkout - Category - ProductDetail - Confirmation - Merchandising - Deals type: string description: Creative PageType nullable: true additionalProperties: false description: The PageType-Environment Tuples for creatives PagingOffsetLimitMetadata: required: - limit - offset type: object properties: count: type: integer format: int64 nullable: true limit: type: integer description: The number of elements to be returned. format: int32 offset: type: integer description: The (zero-based) starting offset in the collection. format: int32 description: Metadata for paging data. nullable: true PartnerBillingReportRequestV1: required: - endDate - startDate type: object properties: accountIds: minItems: 1 type: array items: type: string description: On which accounts the report is created. nullable: true endDate: type: string description: End date of the report (ISO 8601 format, e.g. YYYY-MM-DD). format: date format: enum: - json - csv type: string description: Format type of the report. default: json retailerIds: minItems: 1 type: array items: type: integer format: int32 description: On which retailers the report is created. nullable: true startDate: type: string description: Start date of the report (ISO 8601 format, e.g. YYYY-MM-DD). format: date additionalProperties: false description: The request object of a Partner Billing Report. PartnerBillingReportStatusV1: required: - createdAt - status type: object properties: createdAt: type: string description: The date when the report request is created. format: date-time errorMessage: type: string description: Possible error message along with the status. nullable: true status: enum: - pending - success - failed - expired type: string description: Status of the report. additionalProperties: false description: Status info of a Partner Billing Report. nullable: true PerformanceReportFilters: type: object properties: accountIds: type: array items: type: string activationPlatforms: type: array items: enum: - CommerceMax - PrivateMarket type: string budgetModels: type: array items: enum: - CriteoBudget - RetailerBudget type: string buyTypes: type: array items: enum: - auction - preferredDeals - sponsorship type: string campaignIds: type: array items: type: string campaignTypes: type: array items: enum: - all - sponsoredProducts - onSiteDisplays type: string lineItemIds: type: array items: type: string mediaTypes: type: array items: enum: - unknown - video - display - all type: string salesChannels: type: array items: enum: - online - offline - all type: string searchTermTargetings: type: array items: enum: - unknown - automatic - manual type: string searchTermTypes: type: array items: enum: - unknown - searched - entered type: string targetedKeywordTypes: type: array items: enum: - unknown - generic - branded - conquesting type: string description: Array-valued constraints for performance DSP analytics. Exactly one of accountIds, campaignIds, or lineItemIds is required. PostCampaignV202301: type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithoutIdOfCampaignAttributesV202301AndCampaignV202301' description: An object that represents the available options to set when creating a Retail Media Campaign PreferredLineItemCreateModelV2: required: - name - startDate - endDate - pacing - page - targetRetailerId - budget type: object properties: budget: type: number format: double capping: $ref: '#/components/schemas/LineItemCappingV2' creativeId: type: string format: long-id endDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date name: maxLength: 255 minLength: 0 type: string pacing: enum: - unknown - standard - accelerated type: string description: Line Item Pacing Enum page: $ref: '#/components/schemas/LineItemPageV2' startDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date status: enum: - unknown - active - scheduled - draft - paused - budgetHit - ended - archived - noFunds type: string description: Line Item Status Enum targetRetailerId: type: string format: long-id description: Model used to create a preferred line item PreferredLineItemCreateModelV2Request: type: object properties: data: $ref: '#/components/schemas/InputResourceOfPreferredLineItemCreateModelV2' description: Data model for a create input resource PreferredLineItemUpdateModelV2: required: - name - startDate - endDate - status type: object properties: budget: type: number format: double capping: $ref: '#/components/schemas/LineItemCappingV2' creativeId: type: string format: long-id endDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date name: maxLength: 255 minLength: 0 type: string pacing: enum: - unknown - standard - accelerated type: string default: accelerated page: $ref: '#/components/schemas/LineItemPageV2' startDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date status: enum: - unknown - active - scheduled - draft - paused - budgetHit - ended - archived - noFunds type: string description: Line Item Status Enum description: Model used to update a preferred line item PreferredLineItemUpdateModelV2Request: type: object properties: data: $ref: '#/components/schemas/ResourceOfPreferredLineItemUpdateModelV2' description: A top-level object that encapsulates a Criteo API request for a single entity PreferredLineItemV2: required: - name - startDate - status - targetRetailerId - budget - campaignId type: object properties: budget: type: number format: double budgetRemaining: type: number format: double nullable: true budgetSpent: type: number format: double nullable: true campaignId: type: string format: long-id capping: $ref: '#/components/schemas/LineItemCappingV2' createdAt: type: string format: date-time creativeId: type: string description: creative Id format: long-id nullable: true endDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date nullable: true id: type: string nullable: true name: maxLength: 255 minLength: 0 type: string pacing: enum: - unknown - standard - accelerated type: string nullable: true page: $ref: '#/components/schemas/LineItemPageV2' startDate: type: string description: Represents the Date as a year, month, and day in the format YYYY-MM-DD format: date status: enum: - unknown - active - scheduled - draft - paused - budgetHit - ended - archived - noFunds type: string description: Line Item Status Enum targetRetailerId: type: string format: long-id updatedAt: type: string format: date-time description: A Retail Media Preferred Line Item used to hold bid settings for one or many promoted products on a single retailer PreferredLineItemV2PagedListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfPreferredLineItemV2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true metadata: $ref: '#/components/schemas/PageMetadata' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a paged list of response resources PreferredLineItemV2Response: type: object properties: data: $ref: '#/components/schemas/ResourceOfPreferredLineItemV2' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity PrivateMarketAccountFees: type: object properties: accountId: type: string description: The account Id nullable: true fees: $ref: '#/components/schemas/PrivateMarketFees' additionalProperties: false description: The Fees for a Specific private market account nullable: true PrivateMarketFees: type: object properties: demandManaged: $ref: '#/components/schemas/DemandManagedFee' managedService: $ref: '#/components/schemas/ManagedServiceFee' additionalProperties: false description: fees for a private market account nullable: true ProductMetadata: type: object properties: count: type: integer description: Total number of items available. format: int32 nullable: true limit: type: integer description: Maximum number of items in the response. format: int32 nullable: true offset: type: integer description: Zero based offset of the first item in the response. format: int32 nullable: true responseCount: type: integer description: Number of items in the response. format: int32 nullable: true additionalProperties: false description: Metadata about the response. Used for pagination. nullable: true ProductResourceOutcome: type: object properties: errors: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true warnings: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true additionalProperties: false description: Outcome object containing errors and warnings. PromotedProduct: type: object properties: bidOverride: type: number description: The bid override for the promoted product for this line item. Ignored unless adding a product. format: decimal nullable: true id: type: string description: A retailer defined SKU ID for the promoted product. nullable: true status: $ref: '#/components/schemas/LineItemProductStatus' additionalProperties: false description: A promoted product. nullable: true PromotedProductResource: type: object properties: attributes: $ref: '#/components/schemas/PromotedProduct' id: type: string nullable: true type: type: string nullable: true additionalProperties: false description: Resource object containing a promoted product. PromotedProductResourceCollectionInput: type: object properties: data: type: array items: $ref: '#/components/schemas/PromotedProductResource' additionalProperties: false description: Request object containing promoted products to be appended, deleted, paused or unpaused. PromotedProductResourceCollectionOutcome: type: object properties: data: type: array items: $ref: '#/components/schemas/PromotedProductResource' nullable: true errors: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/ProductMetadata' warnings: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true additionalProperties: false description: Outcome object containing promoted products. PutCampaignV202301: type: object properties: data: $ref: '#/components/schemas/JsonApiBodyWithExternalIdOfEditableCampaignAttributesV202301AndCampaignV202301' description: An object that represents the available options to set when editing a Retail Media Campaign RecommendedCategoriesRequestV1: required: - productIds type: object properties: productIds: maxItems: 1000 minItems: 1 type: array items: type: string description: Sku id list. description: An object that represents the request of RecommendCategories endpoint. RecommendedKeywordsRequestV1: required: - productIds type: object properties: productIds: maxItems: 1000 minItems: 1 type: array items: type: string description: Product Id list that the recommended keywords generated on. additionalProperties: false description: Request model of RecommendedKeywords RecommendedKeywordsResponseV1: required: - recommendedKeywords type: object properties: recommendedKeywords: type: array items: type: string description: Recommended keywords generated by given retailer Id and sku Ids. additionalProperties: false description: Response model of Recommended Keywords nullable: true RecommendedKeywordsResult: type: object properties: keywords: type: object additionalProperties: $ref: '#/components/schemas/Keywords' description: Dictionary of keywords to their keyword models nullable: true recommendedKeywords: type: array items: type: string description: Collection of recommended keywords nullable: true additionalProperties: false description: Response model for recommended keywords nullable: true ReportDataResponseResource: type: object properties: attributes: type: array items: type: array items: type: object description: Data response format nullable: true type: type: string nullable: true description: A top-level object that encapsulates a Criteo API response for a single value nullable: true ReportResponse: type: object properties: data: $ref: '#/components/schemas/ReportDataResponseResource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/ExportReportMetaData' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: Report response format ResourceOfAddFundsToBalanceV3: type: object properties: attributes: $ref: '#/components/schemas/AddFundsToBalanceV3' id: type: string description: Id of the entity type: type: string description: Canonical type name of the entity description: A class that represents a domain entity exposed by an API ResourceOfBalanceCampaign202110: type: object properties: attributes: $ref: '#/components/schemas/BalanceCampaign202110' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API ResourceOfBalanceResponseV2: type: object properties: attributes: $ref: '#/components/schemas/BalanceResponseV2' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API nullable: true ResourceOfBalanceResponseV3: type: object properties: attributes: $ref: '#/components/schemas/BalanceResponseV3' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API nullable: true ResourceOfCategory202204: type: object properties: attributes: $ref: '#/components/schemas/Category202204' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false description: A class that represents a domain entity exposed by an API. ResourceOfChangeDatesOfBalanceV2: type: object properties: attributes: $ref: '#/components/schemas/ChangeDatesOfBalanceV2' id: type: string description: Id of the entity type: type: string description: Canonical type name of the entity description: A class that represents a domain entity exposed by an API ResourceOfCommonLineItem: type: object properties: attributes: $ref: '#/components/schemas/CommonLineItem' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API ResourceOfCreateBalanceV3: type: object properties: attributes: $ref: '#/components/schemas/CreateBalanceV3' id: type: string description: Id of the entity type: type: string description: Canonical type name of the entity description: A class that represents a domain entity exposed by an API ResourceOfCreative2: type: object properties: attributes: $ref: '#/components/schemas/Creative2' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false description: A class that represents a domain entity exposed by an API. nullable: true ResourceOfCreative202110: type: object properties: attributes: $ref: '#/components/schemas/Creative202110' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false description: A class that represents a domain entity exposed by an API. ResourceOfCreative202210: type: object properties: attributes: $ref: '#/components/schemas/Creative202210' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false description: A class that represents a domain entity exposed by an API. nullable: true ResourceOfLineItemBidMultipliersV2: type: object properties: attributes: $ref: '#/components/schemas/LineItemBidMultipliersV2' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API nullable: true ResourceOfPreferredLineItemUpdateModelV2: type: object properties: attributes: $ref: '#/components/schemas/PreferredLineItemUpdateModelV2' id: type: string description: Id of the entity type: type: string description: Canonical type name of the entity description: A class that represents a domain entity exposed by an API ResourceOfPreferredLineItemV2: type: object properties: attributes: $ref: '#/components/schemas/PreferredLineItemV2' id: type: string description: Id of the entity nullable: true type: type: string description: Canonical type name of the entity nullable: true description: A class that represents a domain entity exposed by an API nullable: true ResourceOfTemplate: type: object properties: attributes: $ref: '#/components/schemas/Template' id: type: string description: Unique identifier of this resource. nullable: true type: type: string nullable: true additionalProperties: false description: A class that represents a domain entity exposed by an API. nullable: true ResourceOutcome: type: object properties: errors: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/RmcaCommonProblem' nullable: true readOnly: true additionalProperties: false description: Outcome object containing errors and warnings. RetailerPages202110: required: - pageTypes type: object properties: pageTypes: type: array items: type: string description: List of valid pages for a retailer additionalProperties: false description: Wraps a list of valid pages for a retailer RetailerResultV2: type: object properties: campaignAvailabilities: type: array items: $ref: '#/components/schemas/CampaignAvailabilityV2' description: A list of campaign availabilities for the retailer, each showing the budget models available for a specific campaign type and buy type combination nullable: true name: type: string description: Name of the retailer nullable: true additionalProperties: false description: The result of a query for the configuration of a retailer nullable: true RetailerSearchRequestV2: type: object properties: retailerIdFilter: type: array items: type: string description: Optional list of retailer IDs to filter the results nullable: true additionalProperties: false description: Request model for searching retailers RetailMediaContactlistAmendment: required: - attributes type: object properties: attributes: required: - identifiers - operation type: object properties: identifiers: type: array items: type: string description: The users to add or remove, each in the schema specified identifierType: enum: - Email - UserIdentifier - IdentityLink - Gum - CustomerId - PhoneNumber type: string description: What type of identifiers are used operation: enum: - add - remove type: string description: Whether to add or remove users description: Attributes of retail media contact list amendment type: type: string description: User List example: AddRemoveContactlist description: Request data of retail media contact list amendment RetailMediaContactlistAmendmentRequest: required: - data type: object properties: data: $ref: '#/components/schemas/RetailMediaContactlistAmendment' description: Request of Retail Media contactlist RetailMediaContactlistOperation: required: - data - errors - warnings type: object properties: data: $ref: '#/components/schemas/RetailMediaContactlistOperationResponseAttributes' errors: type: array items: $ref: '#/components/schemas/AudienceError' type: type: string description: the name of the entity type nullable: true example: AddRemoveContactlistResult warnings: type: array items: $ref: '#/components/schemas/AudienceWarning' description: Operation on Retail Media contact list RetailMediaContactlistOperationResponseAttributes: required: - contactListId - operation - requestDate type: object properties: contactListId: type: integer description: The affected user list id format: int64 identifierType: type: string description: The schema specified for of the identifiers nullable: true nbInvalidIdentifiers: type: integer description: How many identifiers were invalid for the specified schema format: int32 nullable: true nbValidIdentifiers: type: integer description: How many identifiers were valid for the specified schema format: int32 nullable: true operation: type: string description: The action recorded requestDate: type: string description: When the action was recorded format: date-time sampleInvalidIdentifiers: type: array items: type: string description: A sample of invalid identifiers if there is some nullable: true description: The attributes of Retail Media contact list operation RetailMediaKeywordsReview: required: - keywords type: object properties: keywords: minItems: 1 type: array items: $ref: '#/components/schemas/ReviewSetState' additionalProperties: false description: Request object for approval of keyword reviews, containing a list of Phrase-ReviewState pairs RetailMediaKeywordsReviewResult: required: - keywords type: object properties: keywords: minItems: 1 type: array items: $ref: '#/components/schemas/ReviewSetState' additionalProperties: false description: Response object for approval of keyword reviews, containing a list of Phrase-ReviewState pairs nullable: true RetailMediaSeller: type: object properties: name: type: string description: seller name nullable: true retailerId: type: integer description: the retailer id format: int32 nullable: true sellerId: type: string description: the seller id nullable: true additionalProperties: false description: used to define the exact seller linked with an account ReviewSetState: required: - phrase - reviewState type: object properties: phrase: type: string description: Normalized key phrase for keyword review to update reviewState: enum: - Unknown - InReview - Recommended - Approved - AutoApproved - Rejected - AutoRejected type: string description: Keyword review state to set for a phrase additionalProperties: false description: A Phrase-ReviewState pair describing an update to a keyword review ReviewStateModel: enum: - InReview - Recommended - Approved - AutoApproved - Rejected - AutoRejected type: string description: The state of a keyword in the context of a line item. RmAlgebraNodeV1: type: object properties: and: type: array items: $ref: '#/components/schemas/RmAlgebraNodeV1' nullable: true audienceSegmentId: type: string nullable: true not: $ref: '#/components/schemas/RmAlgebraNodeV1' or: type: array items: $ref: '#/components/schemas/RmAlgebraNodeV1' nullable: true description: Node in the audience algebra definition. nullable: true RmAudienceEntityV1: type: object properties: accountId: type: string description: Account associated to the audience nullable: true algebra: $ref: '#/components/schemas/RmAlgebraNodeV1' channels: type: array items: enum: - Unknown - Onsite - Offsite type: string description: Channels associated to the audience (read-only) nullable: true createdAt: type: string description: ISO-8601 timestamp in UTC of audience creation (read-only) format: date-time nullable: true createdById: type: string description: User that created the audience nullable: true description: type: string description: Description of the audience nullable: true name: type: string description: Name of the audience nullable: true retailerId: type: string description: Retailer associated to the audience nullable: true updatedAt: type: string description: ISO-8601 timestamp in UTC of audience update (read-only) format: date-time nullable: true description: Audience of people of interest for a marketer. nullable: true x-criteo-canonical: infoType: entity name: RetailMediaAudience version: v1 RmAudienceEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API RmAudienceEntityV1RmAudienceSearchMetadataV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/RmAudienceSearchMetadataV1' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities and metadata RmAudienceSearchEntityV1: type: object properties: audienceIds: type: array items: type: string description: List of audience ids audienceSegmentIds: type: array items: type: string description: List of segment ids (linked to the result audiences) retailerIds: type: array items: type: string description: List of retailer ids description: Available filters to perform a search on audiences. If present, the filters are AND'ed together when applied. RmAudienceSearchEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSearchEntityV1' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value RmAudienceSearchInputV1: type: object properties: data: $ref: '#/components/schemas/RmAudienceSearchEntityV1Resource' description: A top-level object that encapsulates a Criteo API request for a single value. RmAudienceSearchMetadataV1: type: object properties: limit: type: integer description: Max item of the current page format: int32 nullable: true offset: type: integer description: Number of item to skip format: int32 nullable: true totalItems: type: integer description: Total number of items format: int32 nullable: true description: Metadata for the audience search response. nullable: true RmAudienceSegmentBulkCreateInputV1: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentCreateEntityV1Resource' description: A top-level object that encapsulates a Criteo API request for several values. RmAudienceSegmentBulkDeleteInputV1: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentDeleteEntityV1Resource' description: A top-level object that encapsulates a Criteo API request for several entities. RmAudienceSegmentBulkUpdateInputV1: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentUpdateEntityV1Resource' description: A top-level object that encapsulates a Criteo API request for several entities. RmAudienceSegmentCreateEntityV1: required: - name - retailerId type: object properties: contactList: $ref: '#/components/schemas/RmContactListCreateV1' description: type: string description: Description of the segment events: $ref: '#/components/schemas/RmEventsCreateV1' name: type: string description: Name of the segment retailerId: type: string description: Retailer associated to the segment description: Set of rules that defines specific people to target. RmAudienceSegmentCreateEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentCreateEntityV1' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value RmAudienceSegmentDeleteEntityV1: type: object description: Segment to delete x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmAudienceSegmentDeleteEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentDeleteEntityV1' id: type: string description: Id of the entity type: type: string description: A class that represents a domain entity exposed by an API RmAudienceSegmentEntityV1: type: object properties: accountId: type: string description: Account associated to the segment nullable: true channels: type: array items: enum: - Unknown - Onsite - Offsite type: string description: Channels associated to the segment (read-only) nullable: true contactList: $ref: '#/components/schemas/RmContactListV1' createdAt: type: string description: ISO-8601 timestamp in UTC of segment creation (read-only) format: date-time nullable: true createdById: type: string description: User that created the segment nullable: true description: type: string description: Description of the segment nullable: true events: $ref: '#/components/schemas/RmEventsV1' name: type: string description: Name of the segment nullable: true retailerId: type: string description: Retailer associated to the segment nullable: true type: enum: - Unknown - ContactList - Events type: string description: Type of segment (read-only) nullable: true updatedAt: type: string description: ISO-8601 timestamp in UTC of segment update (read-only) format: date-time nullable: true description: Set of rules that defines specific people to target. nullable: true x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmAudienceSegmentEntityV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities RmAudienceSegmentEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API RmAudienceSegmentEntityV1RmAudienceSegmentSearchMetadataV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true meta: $ref: '#/components/schemas/RmAudienceSegmentSearchMetadataV1' warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities and metadata RmAudienceSegmentIdEntityV1: type: object description: Audience Segment entity only with its ID nullable: true x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmAudienceSegmentIdEntityV1ListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/RmAudienceSegmentIdEntityV1Resource' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for several entities RmAudienceSegmentIdEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentIdEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API RmAudienceSegmentSearchEntityV1: type: object properties: audienceSegmentIds: type: array items: type: string description: List of segment ids audienceSegmentTypes: type: array items: enum: - Unknown - ContactList - Events type: string description: List of segment types retailerIds: type: array items: type: string description: List of retailer ids description: Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied. RmAudienceSegmentSearchEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentSearchEntityV1' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value RmAudienceSegmentSearchInputV1: type: object properties: data: $ref: '#/components/schemas/RmAudienceSegmentSearchEntityV1Resource' description: A top-level object that encapsulates a Criteo API request for a single value. RmAudienceSegmentSearchMetadataV1: type: object properties: limit: type: integer description: Max item of the current page format: int32 nullable: true offset: type: integer description: Number of item to skip format: int32 nullable: true totalItems: type: integer description: Total number of items format: int32 nullable: true description: Metadata for the audience segment search response. nullable: true RmAudienceSegmentUpdateEntityV1: type: object properties: contactList: $ref: '#/components/schemas/RmContactListUpdateV1' description: $ref: '#/components/schemas/NillableString' events: $ref: '#/components/schemas/RmEventsUpdateV1' name: type: string description: Name of the segment description: Set of rules that defines specific people to target. x-criteo-canonical: infoType: entity name: RetailMediaAudienceSegment version: v1 RmAudienceSegmentUpdateEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmAudienceSegmentUpdateEntityV1' id: type: string description: Id of the entity type: type: string description: A class that represents a domain entity exposed by an API RmcaCommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: A human-readable explanation specific to this occurrence of the problem nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: A machine-readable structure to reference to the exact location(s) causing the error(s) nullable: true stackTrace: type: string nullable: true status: type: integer description: The problem's HTTP Status code. format: int32 nullable: true title: type: string description: A short human-readable description of the problem type nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true additionalProperties: {} description: Common problem object. RmContactListCreateV1: type: object properties: identifierType: enum: - Email - UserIdentifier - IdentityLink - CustomerId - PhoneNumber type: string description: Indicates contact list type description: Settings to target users with your contact lists. RmContactListStatisticsEntityV1: type: object properties: matchRate: type: number description: "Percentage of matched identifiers in the contact list.\r\nCan differ from matches/identifiers depending on the contact list type." format: double nullable: true numberOfIdentifiers: type: integer description: Number of identifiers in the contact list. format: int32 nullable: true numberOfMatches: type: integer description: Number of matched identifiers in the contact list. format: int32 nullable: true description: Contact list statistics. nullable: true x-criteo-canonical: infoType: entity name: ContactListStatistics version: v1 RmContactListStatisticsEntityV1Resource: type: object properties: attributes: $ref: '#/components/schemas/RmContactListStatisticsEntityV1' id: type: string description: Id of the entity nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API nullable: true RmContactListStatisticsEntityV1Response: type: object properties: data: $ref: '#/components/schemas/RmContactListStatisticsEntityV1Resource' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true description: A top-level object that encapsulates a Criteo API response for a single entity RmContactListUpdateV1: type: object description: Settings to update the contact list of the segment RmContactListV1: type: object properties: identifierType: enum: - Unknown - Email - UserIdentifier - IdentityLink - CustomerId - PhoneNumber type: string description: Indicates contact list identifier's type nullable: true isReadOnly: type: boolean description: Is the segment read-only nullable: true sharingStatus: enum: - Unknown - NotShared - SharedWithAll - SharedWithDemandAccounts type: string description: Indicates if the contact list is shared with other accounts nullable: true description: Settings to target users with your contact lists. nullable: true RmEventsCreateV1: required: - lookbackDays - shopperActivity type: object properties: brandIds: uniqueItems: true type: array items: type: string description: Choose the brands your segment might be interested in categoryIds: uniqueItems: true type: array items: type: string description: Choose the categories your segment might be interested in lookbackDays: enum: - Last7Days - Last14Days - Last30Days - Last45Days - Last60Days - Last90Days - Last120Days - Last150Days - Last180Days type: string description: Number of days of the lookback windows maxPrice: type: number description: Reach people who’ve shown interest in products with a maximum price format: double minPrice: type: number description: Reach people who’ve shown interest in products with a minimum price format: double shopperActivity: enum: - View - Buy - AddToCart type: string description: Types of shopper activity. description: Settings to target users based on their behavior RmEventsUpdateV1: type: object properties: brandIds: type: array items: type: string description: Choose the brands your segment might be interested in categoryIds: type: array items: type: string description: Choose the categories your segment might be interested in lookbackDays: enum: - Last7Days - Last14Days - Last30Days - Last45Days - Last60Days - Last90Days - Last120Days - Last150Days - Last180Days type: string description: Number of days of the lookback windows maxPrice: $ref: '#/components/schemas/NillableDecimal' minPrice: $ref: '#/components/schemas/NillableDecimal' shopperActivity: enum: - View - Buy - AddToCart type: string description: Types of shopper activity. description: Settings to target users based on their behavior RmEventsV1: type: object properties: brandIds: type: array items: type: string description: The list of brand ids nullable: true categoryIds: type: array items: type: string description: The list of category ids nullable: true lookbackDays: enum: - Unknown - Last7Days - Last14Days - Last30Days - Last45Days - Last60Days - Last90Days - Last120Days - Last150Days - Last180Days type: string description: The number of days to look back nullable: true maxPrice: type: number description: Maximum price of the products format: double nullable: true minPrice: type: number description: Minimum price of the products format: double nullable: true shopperActivity: enum: - Unknown - View - Buy - AddToCart type: string description: Reach people who performed specific action nullable: true description: Settings to target users based on their behavior nullable: true SdkApiRestCommonProblem: type: object properties: code: type: string description: A machine-readable error code, expressed as a string value. nullable: true detail: type: string description: A human-readable explanation specific to this occurrence of the problem. nullable: true instance: type: string description: A URI that identifies the specific occurrence of the problem. nullable: true source: type: object additionalProperties: type: string description: A machine-readable structure to reference to the exact location(s) causing the error(s). nullable: true stackTrace: type: string description: '' nullable: true title: type: string description: A short human-readable description of the problem type. nullable: true traceId: type: string description: The request correlation ID this problem comes from. nullable: true type: enum: - unknown - access-control - authentication - authorization - availability - deprecation - quota - validation type: string description: The problem's category. nullable: true additionalProperties: false description: Common problem object. Section: required: - templateVariables type: object properties: description: type: string nullable: true templateVariables: type: array items: $ref: '#/components/schemas/TemplateVariable' title: type: string nullable: true additionalProperties: false description: Section object that hold template variables SellerCatalogRequest: required: - sellers type: object properties: sellers: type: array items: $ref: '#/components/schemas/SellerIdentifier' description: A list of sellers to restrict the catalog to. additionalProperties: false description: Used to request a catalog of seller SKUs SellerCatalogRequestV2: type: object properties: includeFields: type: array items: enum: - Unknown - Description - ImageUrl - GoogleCategory - RetailerName - Category - BrandName type: string description: Out of the optional fields, only the ones specified will be included in the catalog generated. nullable: true modifiedAfter: type: string description: Only products modified after this time will be returned. format: date-time nullable: true sellers: type: array items: $ref: '#/components/schemas/SellerIdentifierV2' description: A list of sellers to restrict the catalog to. nullable: true additionalProperties: false description: Used to request a catalog of seller SKUs SellerIdentifier: required: - retailerId - sellerId type: object properties: retailerId: type: string description: The retailer Id that the seller operates under sellerId: type: string description: The id for the seller based on the corresponding retailer additionalProperties: false description: Identifies a Unique Seller SellerIdentifierV2: required: - retailerId - sellerId type: object properties: retailerId: type: string description: The retailer Id that the seller operates under sellerId: type: string description: The id for the seller based on the corresponding retailer additionalProperties: false description: Identifies a Unique Seller SellerSearch: required: - accountIds type: object properties: accountIds: maxItems: 25 type: array items: type: string description: list of accounts to return seller information for. max length of 25 includeDetails: type: boolean description: "whether to include additional fields beyond the sellerId and retailerId in the response.\r\nMay improve performance when set to false." default: false additionalProperties: false description: request body for the seller search endpoint SellerSearchResult: type: object properties: accountId: type: string description: the id for the account nullable: true sellers: type: array items: $ref: '#/components/schemas/RetailMediaSeller' description: the details for mapped sellers for the account nullable: true additionalProperties: false description: holds an AccountId and the mapped seller information for that account nullable: true SetBidModel: type: object properties: bid: type: number format: double nullable: true phrase: maxLength: 255 minLength: 0 type: string nullable: true additionalProperties: false description: A single keyword and associated bid override SetBidsModel: type: object properties: keywords: type: array items: $ref: '#/components/schemas/SetBidModel' nullable: true additionalProperties: false description: Data model containing keywords and their associated bid overrides SetBidsModelRequest: type: object properties: data: $ref: '#/components/schemas/SetBidsModelResource' additionalProperties: false description: Request object to set bid overrides for keywords associated with a line item SetBidsModelResource: type: object properties: attributes: $ref: '#/components/schemas/SetBidsModel' id: type: string nullable: true type: type: string nullable: true additionalProperties: false description: Resource object containing keywords and their associated bid overrides SkuMinBid: required: - minBid - skuId type: object properties: minBid: type: number description: Minimum bid amount value. format: double skuId: type: string description: Sku id. additionalProperties: false description: An object represents the minimum bid amount value of a sku. SponsoredProductsLineItem: required: - budgetRemaining - campaignId - createdAt - name - startDate - targetRetailerId - updatedAt type: object properties: bidStrategy: enum: - manual - automated - unknown type: string description: Bid strategy for the line item. nullable: true budget: type: number description: The total budget allocated for this line item. format: double nullable: true budgetRemaining: type: number description: The amount of the budget that remains available. format: double nullable: true budgetSpent: type: number description: The amount of the budget that has been spent so far. format: double nullable: true campaignId: type: string description: The ID of the campaign this line item belongs to. format: long-id createdAt: type: string description: The date and time when the line item was created. format: date-time dailyPacing: type: number description: The daily pacing limit for budget spending. format: double nullable: true endDate: type: string description: The date and time when the line item stops running. format: date-time nullable: true flightSchedule: $ref: '#/components/schemas/FlightSchedule' isAutoDailyPacing: type: boolean description: Indicates whether automatic daily pacing is enabled. nullable: true keywordStrategy: enum: - unknown - conquesting - genericAndBranded - genericBrandedAndConquesting type: string description: The keyword targeting strategy for this line item. nullable: true maxBid: type: number description: The maximum bid amount allowed for this line item. format: double nullable: true monthlyPacing: type: number description: The monthly pacing limit for budget spending. format: double nullable: true name: maxLength: 255 minLength: 0 type: string description: The name of the line item. optimizationStrategy: enum: - conversion - clicks - revenue - unknown type: string description: The optimization strategy for this line item. nullable: true startDate: type: string description: The date and time when the line item starts running. format: date-time status: enum: - unknown - active - scheduled - draft - paused - budgetHit - ended - archived - noFunds type: string description: The current status of the line item. nullable: true targetBid: type: number description: The target bid amount for the line item. format: double nullable: true targetRetailerId: type: string description: The ID of the retailer targeted by this line item. format: long-id updatedAt: type: string description: The date and time when the line item was last updated. format: date-time additionalProperties: false description: Model of a retail media auction line item. nullable: true SponsoredProductsLineItemCreateRequestModel: required: - name - startDate - targetRetailerId type: object properties: bidStrategy: enum: - manual - automated type: string description: "The bidding strategy for this line item.\r\nDefault value is manual." default: manual budget: type: number description: The total budget allocated for this line item. format: double nullable: true dailyPacing: type: number description: The daily pacing limit for budget spending. format: double nullable: true endDate: type: string description: The date and time when the line item stops running. format: date-time nullable: true flightSchedule: $ref: '#/components/schemas/FlightSchedule' isAutoDailyPacing: type: boolean description: "Indicates whether automatic daily pacing is enabled.\r\nDefault value is false." default: false keywordStrategy: enum: - conquesting - genericAndBranded - genericBrandedAndConquesting type: string description: The keyword targeting strategy for this line item. nullable: true maxBid: type: number description: The maximum bid amount allowed for this line item. format: double nullable: true monthlyPacing: type: number description: The monthly pacing limit for budget spending. format: double nullable: true name: maxLength: 255 minLength: 0 type: string description: The name of the line item. optimizationStrategy: enum: - conversion - clicks - revenue type: string description: "The optimization strategy to use for this line item.\r\nDefault value is Conversion." default: conversion startDate: type: string description: The date and time when the line item starts running. format: date-time targetBid: type: number description: The target bid amount for the line item. format: double nullable: true targetRetailerId: type: string description: The ID of the retailer to target for this line item. format: long-id additionalProperties: false description: Model to create a retail media auction line item SponsoredProductsLineItemUpdateRequestModel: required: - isAutoDailyPacing - name - startDate - status type: object properties: bidStrategy: enum: - manual - automated type: string description: The bid strategy for the line item. default: manual budget: type: number description: The total budget allocated for this line item. format: double nullable: true dailyPacing: type: number description: The daily pacing amount for the line item. format: double nullable: true endDate: type: string description: The date and time when the line item stops running. format: date-time nullable: true flightSchedule: $ref: '#/components/schemas/FlightSchedule' isAutoDailyPacing: type: boolean description: True if daily pacing is automatic, false if manual. maxBid: type: number description: The maximum bid amount for the line item. format: double nullable: true monthlyPacing: type: number description: The monthly pacing amount for the line item. format: double nullable: true name: maxLength: 255 minLength: 0 type: string description: The name of this line item. optimizationStrategy: enum: - conversion - clicks - revenue type: string description: The optimization strategy for the line item. default: conversion startDate: type: string description: The date and time when the line item starts running. format: date-time status: enum: - active - paused - draft type: string description: The current status of the line item. targetBid: type: number description: The target bid amount for the line item. format: double nullable: true additionalProperties: false description: A request to update a Sponsored Products Line Item. StatusResponse: type: object properties: createdAt: type: string nullable: true expiresAt: type: string nullable: true fileSizeBytes: type: integer format: int64 nullable: true id: type: string nullable: true md5CheckSum: type: string nullable: true message: type: string nullable: true rowCount: type: integer format: int32 nullable: true status: enum: - pending - success - failure - expired type: string nullable: true description: Status of an async report request nullable: true x-criteo-canonical: infoType: entity StatusResponseResource: type: object properties: attributes: $ref: '#/components/schemas/StatusResponse' id: type: string nullable: true type: type: string nullable: true description: A class that represents a domain entity exposed by an API nullable: true StoreIdsUpdateModel202110: required: - storeIds type: object properties: storeIds: type: array items: type: string description: Store ids that should be targeted description: Update model for updating store target ids StoreIdsUpdateModel202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfStoreIdsUpdateModel202110' description: Data model for a value type input resource StoreInventoryDelete: required: - batchId - productId - storeId type: object properties: batchId: type: string description: Identifies this array entry productId: type: string description: ' Identifies a product' storeId: type: string description: Identifies the store, for the customer description: References a store inventory to be deleted. See StoreInventoryUpsert StoreInventoryUpsert: required: - availability - batchId - price - productId - storeId type: object properties: availability: enum: - backorder - in_stock - out_of_stock - preorder type: string description: 'Might be: In stock, Out of stock, Preorder, Backorder' batchId: type: string description: Identifies this array entry price: type: string description: Product's price at this store productId: type: string description: ' Identifies a product' salePrice: type: string description: The sale price of the product. storeId: type: string description: Identifies the store, for the customer description: Defines a store inventory to be upserted. Inspired from google spec.See https://developers.google.com/shopping-content/reference/rest/v2.1/localinventory/custombatch#LocalinventoryCustomBatchRequestEntry StoreTarget202110: required: - scope - storeIds type: object properties: scope: enum: - unknown - include - exclude type: string description: Scope of the store target storeIds: type: array items: type: string description: Store ids that should be targeted description: Identifies store targeting for a line item StoreTarget202110Request: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfStoreTarget202110' description: Data model for a value type input resource StoreTarget202110Response: type: object properties: data: $ref: '#/components/schemas/ValueTypeResourceOfStoreTarget202110' errors: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' readOnly: true description: Data model for a value type resource outcome SyncAttributedTransactionsReport: required: - accountId - endDate - startDate type: object properties: accountId: type: string description: Account id to report on campaignIds: type: array items: type: string description: Campaign ids to filter campaignType: enum: - all - sponsoredProducts - onSiteDisplays type: string description: 'Filter the type of campaigns to report on: sponsoredProducts or onSiteDisplays' default: all clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string description: Click attribution window default: none dimensions: type: array items: enum: - purchasedDate - purchasedHour - advDate - advHour - daysDifference - campaignId - campaignName - lineItemId - lineItemName - advProductId - advProductGtin - advProductMpn - advProductName - advProductCategory - purchasedProductId - purchasedProductGtin - purchasedProductMpn - purchasedProductName - purchasedProductCategory - advEngagement - advToPurchasedProductRelationship - salesChannel - retailerName - pageTypeName - keyword - attributionWindow - saleSellerId - saleSellerName - activitySellerId - activitySellerName type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time lineItemIds: type: array items: type: string description: Line item ids to filter mediaType: enum: - unknown - video - display - all type: string description: 'Filter on the type of media: unknown, display, video' default: all metrics: type: array items: enum: - attributedUnits - attributedSales type: string description: List of metrics to report on salesChannel: enum: - online - offline - all type: string description: 'Filter on specific sales channel: offline or online' default: all startDate: type: string description: Start date format: date-time timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string description: View attribution window default: none description: Attributed Transactions report body request SyncAttributedTransactionsReportRequest: type: object properties: data: $ref: '#/components/schemas/SyncAttributedTransactionsReportResource' description: A top-level object that encapsulates a Criteo API request for a single value SyncAttributedTransactionsReportResource: type: object properties: attributes: $ref: '#/components/schemas/SyncAttributedTransactionsReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value SyncCampaignsReport: required: - accountId - endDate - startDate type: object properties: accountId: type: string description: Account id to report on campaignIds: type: array items: type: string description: Campaign ids to filter campaignType: enum: - all - sponsoredProducts - onSiteDisplays type: string description: 'Filter the type of campaigns to report on: sponsoredProducts or onSiteDisplays' default: all clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string description: Click attribution window default: none dimensions: type: array items: enum: - date - hour - accountId - accountName - campaignId - campaignName - campaignTypeName - lineItemId - lineItemName - retailerId - retailerName - brandId - brandName - advProductCategory - advProductId - advProductName - salesChannel - environment - pageTypeName - pageCategory - servedCategory - taxonomyBreadcrumb type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time metrics: type: array items: enum: - impressions - clicks - spend - attributedSales - attributedUnits - attributedOrders - assistedSales - assistedUnits - ctr - cpc - cpo - cpm - roas - uniqueVisitors - frequency type: string description: List of metrics to report on reportType: enum: - summary - pageType - productCategory - product - environment - servedCategory type: string description: Type of report, if no dimensions and metrics are provided, falls back to summary reportType default: summary salesChannel: enum: - online - offline - all type: string description: 'Filter on specific sales channel: offline or online' default: all startDate: type: string description: Start date format: date-time timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string description: View attribution window default: none description: Campaigns report body request SyncCampaignsReportRequest: type: object properties: data: $ref: '#/components/schemas/SyncCampaignsReportResource' description: A top-level object that encapsulates a Criteo API request for a single value SyncCampaignsReportResource: type: object properties: attributes: $ref: '#/components/schemas/SyncCampaignsReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value SyncLineItemsReport: required: - accountId - endDate - startDate type: object properties: accountId: type: string description: Account id to report on campaignIds: type: array items: type: string description: Campaign ids to filter campaignType: enum: - all - sponsoredProducts - onSiteDisplays type: string description: 'Filter the type of campaigns to report on: sponsoredProducts or onSiteDisplays' default: all clickAttributionWindow: enum: - none - 7D - 14D - 30D type: string description: Click attribution window default: none dimensions: type: array items: enum: - date - hour - accountId - accountName - campaignId - campaignName - campaignTypeName - lineItemId - lineItemName - retailerId - retailerName - brandId - brandName - advProductCategory - advProductId - advProductName - salesChannel - environment - pageTypeName - pageCategory - servedCategory - taxonomyBreadcrumb type: string description: List of dimensions to report on endDate: type: string description: End date format: date-time lineItemIds: type: array items: type: string description: Line Item ids to filter metrics: type: array items: enum: - impressions - clicks - spend - attributedSales - attributedUnits - attributedOrders - assistedSales - assistedUnits - ctr - cpc - cpo - cpm - roas - uniqueVisitors - frequency type: string description: List of metrics to report on reportType: enum: - summary - pageType - productCategory - product - environment - servedCategory type: string description: Type of report, if no dimensions and metrics are provided, falls back to summary reportType default: summary salesChannel: enum: - online - offline - all type: string description: 'Filter on specific sales channel: offline or online' default: all startDate: type: string description: Start date format: date-time timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC viewAttributionWindow: enum: - none - 1D - 7D - 14D - 30D type: string description: View attribution window default: none description: Line Items report body request SyncLineItemsReportRequest: type: object properties: data: $ref: '#/components/schemas/SyncLineItemsReportResource' description: A top-level object that encapsulates a Criteo API request for a single value SyncLineItemsReportResource: type: object properties: attributes: $ref: '#/components/schemas/SyncLineItemsReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value SyncRealTimePerformanceReport: required: - startDate type: object properties: accountIds: type: array items: type: string description: Account ids to filter (plural; base has AccountId for single account). campaignIds: type: array items: type: string description: Campaign ids to filter. dimensions: type: array items: enum: - date - hour - accountId - accountName - campaignId - campaignName - lineItemId - lineItemName - retailerId - retailerName type: string description: "Dimensions supported by the real-time performance report (streaming + hourly stats).\r\nOnly these values are accepted; invalid values cause deserialization to fail." description: 'List of dimensions to report on (real-time: at least one required). Only the supported dimension values are valid.' endDate: type: string description: "Optional end date/time (inclusive in the request timezone). If empty or not provided, no end date filter is applied.\r\nWhen provided, used as the inclusive upper bound for the report range.\r\nHides base Report.EndDate so this report can treat end date as optional (no [Required])." format: date-time lineItemIds: type: array items: type: string description: Line item ids to filter. metrics: type: array items: enum: - impressions - clicks - spend type: string description: "Metrics supported by the real-time performance report (streaming + hourly stats).\r\nOnly these values are accepted; invalid values cause deserialization to fail." description: 'List of metrics to report on (real-time: at least one required). Only the supported metric values are valid.' retailerIds: type: array items: type: string description: Retailer ids to filter. This is not used for security, so no need to check for > 0 elements startDate: type: string description: 'Start date (real-time: must be within the last 7 days).' format: date-time timezone: type: string description: 'Time zone : see criteo developer portal for supported time zones' default: UTC description: "Real Time Performance report body request (one sheeter: startDate, endDate (optional), RetailerIds, accountIds, campaignIds, lineItemIds, dimensions, metrics, timezones).\r\nExtends SyncReport only (no default filters); adds entry filter arrays.\r\nDimensions and metrics are restricted to their supported enumerated values; invalid values cause deserialization to fail." SyncRealTimePerformanceReportRequest: type: object properties: data: $ref: '#/components/schemas/SyncRealTimePerformanceReportResource' description: A top-level object that encapsulates a Criteo API request for a single value SyncRealTimePerformanceReportResource: type: object properties: attributes: $ref: '#/components/schemas/SyncRealTimePerformanceReport' type: type: string description: A top-level object that encapsulates a Criteo API response for a single value Template: required: - allCollectionsMandatory - createdAt - creativeFormat - name - sections - skuCollectionMin - skuPerCollectionMin - updatedAt type: object properties: allCollectionsMandatory: type: boolean description: Marks whether or not all collections are mandatory createdAt: type: string description: The time at which the template was created format: date-time creativeFormat: enum: - Unknown - FlagShip - Showcase - SponsoredProducts - Butterfly - BundleBoost - IAB - CUSTOM - DisplayPanel - DigitalShelfTalker - CommerceVideoSpotlight - BrandingVideoStandout - CommerceDisplaySpotlight - BrandingDisplaySpotlightSolo - CommerceDisplayGridShelf - CommerceDisplayGridDuet - BrandingDisplayGridSolo - CommerceVideoGridDuet type: string description: The kind of creative this template can be used to build. displayableSkusMax: type: integer description: Maximum number of displayable skus format: int32 nullable: true id: type: string nullable: true name: type: string description: The name of the template sections: type: array items: $ref: '#/components/schemas/Section' description: The sections holding various template variables skuCollectionMax: type: integer description: Maximum number of skus in the collection format: int32 nullable: true skuCollectionMin: type: integer description: Minimum number of skus in the collection format: int32 skuPerCollectionMax: type: integer description: Maximum number of skus per collection format: int32 nullable: true skuPerCollectionMin: type: integer description: Minimum number of skus per collection format: int32 updatedAt: type: string description: The time at which the template was updated format: date-time additionalProperties: false description: A template for creating creatives. nullable: true TemplateListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/ResourceOfTemplate' nullable: true errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several entities. TemplateResponse: type: object properties: data: $ref: '#/components/schemas/ResourceOfTemplate' errors: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/CommonProblem' nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single entity. TemplateVariable: required: - id - required - type type: object properties: choiceVariableSpecification: $ref: '#/components/schemas/ChoiceVariableSpecification' filesVariablesSpecification: $ref: '#/components/schemas/FilesVariablesSpecification' id: type: string description: The id of the variable required: type: boolean description: Whether the variable is required textVariableSpecification: $ref: '#/components/schemas/TextVariableSpecification' type: enum: - Text - Choice - Color - Files - Hyperlink - Video type: string description: The type of the variable additionalProperties: false description: A variable in a creative template TemplateVariableValue: required: - id type: object properties: choiceVariableValue: $ref: '#/components/schemas/ChoiceVariableValue' colorVariableValue: $ref: '#/components/schemas/ColorVariableValue' filesVariableValue: $ref: '#/components/schemas/FilesVariableValue' hyperlinkVariableValue: $ref: '#/components/schemas/HyperlinkVariableValue' id: type: string description: The id of the template variable the value is applied to textVariableValue: $ref: '#/components/schemas/TextVariableValue' videoVariableValue: $ref: '#/components/schemas/VideoVariableValue' additionalProperties: false description: A value for a variable in a creative template. TextVariableSpecification: type: object properties: maxChars: type: integer description: The maximum amount of characters accepted for the text format: int32 nullable: true additionalProperties: false description: Specification of a text variable nullable: true TextVariableValue: required: - text type: object properties: text: type: string description: The displayed text nullable: true additionalProperties: false description: A value of a template text variable nullable: true UpdateBalanceModelV1: type: object properties: endDate: $ref: '#/components/schemas/NillableOfNullableOfDateOnly' memo: type: string description: Memo. nullable: true name: type: string description: Name of the balance. nullable: true retailerPoNumber: type: string description: Purchase Order number. nullable: true startDate: type: string description: Start date of the balance in the format YYYY-MM-DD. nullable: true additionalProperties: false description: An object that represents the available options to set when updating a Retail Media Balance. ValueResourceAccountFeesSearchRequest: type: object properties: attributes: $ref: '#/components/schemas/AccountFeesSearchRequest' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceAccountFeesUpdateRequest: type: object properties: attributes: $ref: '#/components/schemas/AccountFeesUpdateRequest' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceAppendCampaignsRequestV1: type: object properties: attributes: $ref: '#/components/schemas/AppendCampaignsRequestV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceBalanceCampaignsV1: type: object properties: attributes: $ref: '#/components/schemas/BalanceCampaignsV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceBalanceHistoryChangeDataCaptureV1: type: object properties: attributes: $ref: '#/components/schemas/BalanceHistoryChangeDataCaptureV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceBrandIdSearchRequest: type: object properties: attributes: $ref: '#/components/schemas/BrandIdSearchRequest' type: type: string description: Type of the resource. nullable: true description: A value resource exposed by the API. ValueResourceCategoriesSearchRequestV1: type: object properties: attributes: $ref: '#/components/schemas/CategoriesSearchRequestV1' type: type: string description: Type of the resource. nullable: true description: A value resource exposed by the API. ValueResourceCollectionInputOfRetailMediaSeller: type: object properties: data: type: array items: $ref: '#/components/schemas/ValueResourceOfRetailMediaSeller' nullable: true additionalProperties: false description: A top-level object that encapsulates a Criteo API request for several value objects. ValueResourceCollectionOutcomeBalanceHistoryChangeDataCaptureV1AndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/ValueResourceBalanceHistoryChangeDataCaptureV1' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several value objects and metadata. ValueResourceCollectionOutcomeOfRetailMediaSeller: type: object properties: data: type: array items: $ref: '#/components/schemas/ValueResourceOfRetailMediaSeller' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several value objects. ValueResourceCollectionOutcomeOfSellerSearchResult: type: object properties: data: type: array items: $ref: '#/components/schemas/ValueResourceOfSellerSearchResult' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several value objects. ValueResourceCollectionOutcomePrivateMarketAccountFeesAndMetadata: type: object properties: data: type: array items: $ref: '#/components/schemas/ValueResourcePrivateMarketAccountFees' nullable: true errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true metadata: $ref: '#/components/schemas/Metadata' warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for several value objects and metadata. ValueResourceCpcMinBidsRequest: type: object properties: attributes: $ref: '#/components/schemas/CpcMinBidsRequest' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceCpcMinBidsResponse: type: object properties: attributes: $ref: '#/components/schemas/CpcMinBidsResponse' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceDeleteCampaignsRequestV1: type: object properties: attributes: $ref: '#/components/schemas/DeleteCampaignsRequestV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceInputAccountFeesSearchRequest: type: object properties: data: $ref: '#/components/schemas/ValueResourceAccountFeesSearchRequest' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputAccountFeesUpdateRequest: type: object properties: data: $ref: '#/components/schemas/ValueResourceAccountFeesUpdateRequest' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputAppendCampaignsRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceAppendCampaignsRequestV1' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputBrandIdSearchRequest: type: object properties: data: $ref: '#/components/schemas/ValueResourceBrandIdSearchRequest' description: A top-level object that encapsulates a Criteo API request for a single value objects. ValueResourceInputCategoriesSearchRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceCategoriesSearchRequestV1' description: A top-level object that encapsulates a Criteo API request for a single value objects. ValueResourceInputCpcMinBidsRequest: type: object properties: data: $ref: '#/components/schemas/ValueResourceCpcMinBidsRequest' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value objects. ValueResourceInputDeleteCampaignsRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceDeleteCampaignsRequestV1' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfBrandCatalogRequestV2: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfBrandCatalogRequestV2' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfCampaignBudgetOverrides: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfCampaignBudgetOverrides' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfLineItemBudgetOverrides: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfLineItemBudgetOverrides' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfRetailerSearchRequestV2: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRetailerSearchRequestV2' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfRetailMediaBrandAccountCreation: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRetailMediaBrandAccountCreation' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfRetailMediaBrands: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRetailMediaBrands' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfRetailMediaSellerAccountCreation: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRetailMediaSellerAccountCreation' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfSellerCatalogRequestV2: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfSellerCatalogRequestV2' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfSellerSearch: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfSellerSearch' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfSponsoredProductsLineItemCreateRequestModel: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfSponsoredProductsLineItemCreateRequestModel' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfSponsoredProductsLineItemUpdateRequestModel: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfSponsoredProductsLineItemUpdateRequestModel' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputOfUpdateBalanceModelV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfUpdateBalanceModelV1' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputPartnerBillingReportRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourcePartnerBillingReportRequestV1' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceInputRecommendedCategoriesRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceRecommendedCategoriesRequestV1' description: A top-level object that encapsulates a Criteo API request for a single value objects. ValueResourceInputRecommendedKeywordsRequestV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceRecommendedKeywordsRequestV1' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value objects. ValueResourceInputRetailMediaKeywordsReview: type: object properties: data: $ref: '#/components/schemas/ValueResourceRetailMediaKeywordsReview' additionalProperties: false description: A top-level object that encapsulates a Criteo API request for a single value object. ValueResourceOfBrandCatalogRequestV2: type: object properties: attributes: $ref: '#/components/schemas/BrandCatalogRequestV2' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfCampaignBudgetOverrides: type: object properties: attributes: $ref: '#/components/schemas/CampaignBudgetOverrides' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceOfLineItemBudgetOverrides: type: object properties: attributes: $ref: '#/components/schemas/LineItemBudgetOverrides' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceOfRecommendedKeywordsResult: type: object properties: attributes: $ref: '#/components/schemas/RecommendedKeywordsResult' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceOfRetailerSearchRequestV2: type: object properties: attributes: $ref: '#/components/schemas/RetailerSearchRequestV2' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfRetailMediaBrandAccountCreation: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaBrandAccountCreation' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfRetailMediaBrands: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaBrands' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceOfRetailMediaSeller: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaSeller' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfRetailMediaSellerAccountCreation: type: object properties: attributes: $ref: '#/components/schemas/ExternalRetailMediaSellerAccountCreation' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfSellerCatalogRequestV2: type: object properties: attributes: $ref: '#/components/schemas/SellerCatalogRequestV2' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfSellerSearch: type: object properties: attributes: $ref: '#/components/schemas/SellerSearch' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfSellerSearchResult: type: object properties: attributes: $ref: '#/components/schemas/SellerSearchResult' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfSponsoredProductsLineItemCreateRequestModel: type: object properties: attributes: $ref: '#/components/schemas/SponsoredProductsLineItemCreateRequestModel' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfSponsoredProductsLineItemUpdateRequestModel: type: object properties: attributes: $ref: '#/components/schemas/SponsoredProductsLineItemUpdateRequestModel' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOfUpdateBalanceModelV1: type: object properties: attributes: $ref: '#/components/schemas/UpdateBalanceModelV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceOutcomeBalanceCampaignsV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceBalanceCampaignsV1' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeCpcMinBidsResponse: type: object properties: data: $ref: '#/components/schemas/ValueResourceCpcMinBidsResponse' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeOfCampaignBudgetOverrides: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfCampaignBudgetOverrides' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeOfLineItemBudgetOverrides: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfLineItemBudgetOverrides' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeOfRecommendedKeywordsResult: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRecommendedKeywordsResult' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeOfRetailMediaBrands: type: object properties: data: $ref: '#/components/schemas/ValueResourceOfRetailMediaBrands' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeRecommendedKeywordsResponseV1: type: object properties: data: $ref: '#/components/schemas/ValueResourceRecommendedKeywordsResponseV1' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourceOutcomeRetailMediaKeywordsReviewResult: type: object properties: data: $ref: '#/components/schemas/ValueResourceRetailMediaKeywordsReviewResult' errors: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Errors that occured during this call. nullable: true readOnly: true warnings: type: array items: $ref: '#/components/schemas/SdkApiRestCommonProblem' description: Warnings that occured during this call. nullable: true readOnly: true additionalProperties: false description: A top-level object that encapsulates a Criteo API response for a single value object. ValueResourcePartnerBillingReportRequestV1: type: object properties: attributes: $ref: '#/components/schemas/PartnerBillingReportRequestV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourcePrivateMarketAccountFees: type: object properties: attributes: $ref: '#/components/schemas/PrivateMarketAccountFees' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceRecommendedCategoriesRequestV1: type: object properties: attributes: $ref: '#/components/schemas/RecommendedCategoriesRequestV1' type: type: string description: Type of the resource. nullable: true description: A value resource exposed by the API. ValueResourceRecommendedKeywordsRequestV1: type: object properties: attributes: $ref: '#/components/schemas/RecommendedKeywordsRequestV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceRecommendedKeywordsResponseV1: type: object properties: attributes: $ref: '#/components/schemas/RecommendedKeywordsResponseV1' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueResourceRetailMediaKeywordsReview: type: object properties: attributes: $ref: '#/components/schemas/RetailMediaKeywordsReview' type: type: string description: Type of the resource. nullable: true additionalProperties: false description: A value resource exposed by the API. ValueResourceRetailMediaKeywordsReviewResult: type: object properties: attributes: $ref: '#/components/schemas/RetailMediaKeywordsReviewResult' type: type: string nullable: true additionalProperties: false description: A value resource exposed by the API. nullable: true ValueTypeResourceOfAddToBasketIdsUpdateModel202110: type: object properties: attributes: $ref: '#/components/schemas/AddToBasketIdsUpdateModel202110' type: type: string description: Data model for a value type resource ValueTypeResourceOfAddToBasketTarget202110: type: object properties: attributes: $ref: '#/components/schemas/AddToBasketTarget202110' type: type: string description: Data model for a value type resource ValueTypeResourceOfAudienceIdsUpdateModel202110: type: object properties: attributes: $ref: '#/components/schemas/AudienceIdsUpdateModel202110' type: type: string description: Data model for a value type resource ValueTypeResourceOfAudienceTarget202110: type: object properties: attributes: $ref: '#/components/schemas/AudienceTarget202110' type: type: string description: Data model for a value type resource ValueTypeResourceOfStoreIdsUpdateModel202110: type: object properties: attributes: $ref: '#/components/schemas/StoreIdsUpdateModel202110' type: type: string description: Data model for a value type resource ValueTypeResourceOfStoreTarget202110: type: object properties: attributes: $ref: '#/components/schemas/StoreTarget202110' type: type: string description: Data model for a value type resource VideoVariableValue: required: - duration - height - url - width type: object properties: duration: minLength: 1 type: string description: The video's duration height: type: integer description: The video's height format: int32 url: minLength: 1 type: string description: The vast video url width: type: integer description: The video's width format: int32 additionalProperties: false description: A value of a template video variable nullable: true securitySchemes: oauth: type: oauth2 flows: clientCredentials: tokenUrl: https://api.criteo.com/oauth2/token scopes: {} authorizationCode: authorizationUrl: https://api.criteo.com/oauth2 tokenUrl: https://api.criteo.com/oauth2/token scopes: {} security: - oauth: [] tags: - name: Accounts - name: Analytics - name: Audience - name: Balance - name: Billing - name: Campaign - name: Catalog - name: Gateway x-samples-languages: - java - python - php - csharp - javascript - curl - ruby