Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

HookLogic (Criteo) Accounts API

The Accounts API from HookLogic (Criteo) — 12 operation(s) for accounts.

HookLogic (Criteo) Accounts API is one of 8 APIs that HookLogic (Criteo) publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Accounts. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 12 paths, and defines 57 schemas. It is described by OpenAPI 3.0.1, at version 2026-07.

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

12 operations 12 paths 57 schemas 2 GET9 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

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

Paths & Operations 12

Across 12 paths, the API surfaces 12 operations — 2 GET, 9 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Accounts 12
POST
/2026-07/retail-media/account-management/accounts/{accountId}/brands/add
/2026-07/retail-media/account-management/accounts/{accountId}/brands/add
AddBrands 1 param body → 200
POST
/2026-07/retail-media/account-management/accounts/{accountId}/brands/remove
/2026-07/retail-media/account-management/accounts/{accountId}/brands/remove
RemoveBrands 1 param body → 200
POST
/2026-07/retail-media/account-management/accounts/{accountId}/create-brand-account
/2026-07/retail-media/account-management/accounts/{accountId}/create-brand-account
CreatePrivateMarketDemandBrandAccount 1 param body → 201
POST
/2026-07/retail-media/account-management/accounts/{accountId}/create-seller-account
/2026-07/retail-media/account-management/accounts/{accountId}/create-seller-account
CreatePrivateMarketDemandSellerAccount 1 param body → 201
GET
/2026-07/retail-media/account-management/accounts/{accountId}/private-market-child-accounts
/2026-07/retail-media/account-management/accounts/{accountId}/private-market-child-accounts
GetPrivateMarketChildAccountsByAccountId 3 params → 200
PUT
/2026-07/retail-media/account-management/accounts/{accountId}/sellers
/2026-07/retail-media/account-management/accounts/{accountId}/sellers
UpdateSellers 1 param body → 200
GET
/2026-07/retail-media/accounts
/2026-07/retail-media/accounts
GetAccounts 3 params → 200
POST
/2026-07/retail-media/accounts/{accountId}/grant-consent
/2026-07/retail-media/accounts/{accountId}/grant-consent
GrantConsent 1 param body → 204
POST
/2026-07/retail-media/accounts/fees/search
/2026-07/retail-media/accounts/fees/search
AccountFeesSearch 2 params body → 200
POST
/2026-07/retail-media/accounts/fees/update
/2026-07/retail-media/accounts/fees/update
UpdateAccountFees body → 204
POST
/2026-07/retail-media/accounts/sellers/search
/2026-07/retail-media/accounts/sellers/search
SearchSellers body → 200
POST
/2026-07/retail-media/brands/search
/2026-07/retail-media/brands/search
SearchBrands 2 params body → 200

Schemas 57

The contract defines 57 schemas that model the data the API accepts and returns. The most detailed are ExternalRetailMediaAccount (9 properties), ExternalAccount (9 properties), CommonError (8 properties), ExternalRetailMediaChildAccount (8 properties). Each schema is shown below with its type and property counts.

ExternalAccount
object
A Retail Media Account used to launch campaigns and line items
9 properties 6 required
GrantConsentModelValueResource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
ValueResourcePrivateMarketAccountFees
object
A value resource exposed by the API.
2 properties
ValueResourceCollectionOutcomeOfRetailMediaSeller
object
A top-level object that encapsulates a Criteo API response for several value objects.
3 properties
ValueResourceOutcomeOfRetailMediaBrands
object
A top-level object that encapsulates a Criteo API response for a single value object.
3 properties
ExternalRetailMediaChildAccount
object
The details for a newly created account
8 properties
ValueResourceAccountFeesUpdateRequest
object
A value resource exposed by the API.
2 properties
AccountFeesUpdateRequest
object
request body to set provided fees for the provided accounts
2 properties 2 required
ExternalRetailMediaBrandAccountCreation
object
the initial set up and configuration options for a new private market demand brand account
4 properties
RetailMediaSeller
object
used to define the exact seller linked with an account
3 properties
ValueResourceInputOfSellerSearch
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property
EntityResourceCollectionOutcomeBrandIdSearchResultPagingOffsetLimitMetadata
object
A top-level object that encapsulates a Criteo API response for several entities and metadata.
4 properties
ValueResourceInputOfRetailMediaBrands
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property
GrantConsentInput
object
An object that encapsulates GrantConsentModel
1 property
Metadata
object
Metadata related to the current request.
3 properties 2 required
ValueResourceInputAccountFeesUpdateRequest
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property
GrantConsentModel
object
An object that represents the required (ClientId and CallbackUrl) and optional (CallbackState) parameters when granting consents on behalf of a Private Market…
3 properties 2 required
BrandIdSearchResult
object
An object that represents the result from a brand ID search.
4 properties 4 required
EntityResourceCollectionOutcomeOfRetailMediaChildAccountAndMetadata
object
A top-level object that encapsulates a Criteo API response for several entities and metadata.
4 properties
ExternalRetailMediaSeller
object
used to define the exact seller linked with an account
2 properties 2 required
ExternalRetailMediaBrands
object
A collection of brand ids
1 property 1 required
ValueResourceBrandIdSearchRequest
object
A value resource exposed by the API.
2 properties
ValueResourceCollectionInputOfRetailMediaSeller
object
A top-level object that encapsulates a Criteo API request for several value objects.
1 property
SdkApiRestCommonProblem
object
Common problem object.
8 properties
ValueResourceCollectionOutcomeOfSellerSearchResult
object
A top-level object that encapsulates a Criteo API response for several value objects.
3 properties
ValueResourceOfRetailMediaSellerAccountCreation
object
A value resource exposed by the API.
2 properties
AccountFeesSearchRequest
object
the request body for account fees search
1 property
ManagedServiceFee
object
settings for managed service fees
3 properties 3 required
ValueResourceAccountFeesSearchRequest
object
A value resource exposed by the API.
2 properties
BrandIdSearchRequest
object
An object that represents the request of BrandIdSearch endpoint.
3 properties 1 required
EntityResourceOfRetailMediaChildAccount
object
A domain entity exposed by the API, identified by a unique id.
3 properties
PagingOffsetLimitMetadata
object
Metadata for paging data.
3 properties 2 required
SellerSearchResult
object
holds an AccountId and the mapped seller information for that account
2 properties
CommonError
object
A JSON:API Common error structure
8 properties
ExternalRetailMediaAccount
object
The details for a newly created account
9 properties
EntityResourceOutcomeOfRetailMediaAccount
object
A top-level object that encapsulates a Criteo API response for a single entity.
3 properties
PageMetadata
object
Metadata related to the current request
6 properties 2 required
CommonWarning
object
A JSON:API Base common warning
8 properties
PrivateMarketAccountFees
object
The Fees for a Specific private market account
2 properties
ValueResourceInputOfRetailMediaSellerAccountCreation
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property
JsonApiBodyWithIdOfInt64AndAccountAndAccount
object
A JSON:API wrapper class to format a with external Id, Type, and Attributes properties
3 properties 2 required
PrivateMarketFees
object
fees for a private market account
2 properties
ValueResourceInputOfRetailMediaBrandAccountCreation
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property
ValueResourceOfRetailMediaBrandAccountCreation
object
A value resource exposed by the API.
2 properties
ValueResourceOfSellerSearch
object
A value resource exposed by the API.
2 properties
ValueResourceInputBrandIdSearchRequest
object
A top-level object that encapsulates a Criteo API request for a single value objects.
1 property
EntityResourceBrandIdSearchResult
object
A domain entity exposed by the API, identified by a unique id.
3 properties
JsonApiPageResponseOfAccount
object
A wrapper class to return a single page of with metadata
4 properties 2 required
ValueResourceOfSellerSearchResult
object
A value resource exposed by the API.
2 properties
ValueResourceOfRetailMediaSeller
object
A value resource exposed by the API.
2 properties
SellerSearch
object
request body for the seller search endpoint
2 properties 1 required
ValueResourceOfRetailMediaBrands
object
A value resource exposed by the API.
2 properties
ValueResourceCollectionOutcomePrivateMarketAccountFeesAndMetadata
object
A top-level object that encapsulates a Criteo API response for several value objects and metadata.
4 properties
DemandManagedFee
object
settings for DSP fees
1 property 1 required
ExternalRetailMediaSellerAccountCreation
object
the initial set up and configuration options for a new private market demand brand account
4 properties 1 required
EntityResourceOfRetailMediaAccount
object
A domain entity exposed by the API, identified by a unique id.
3 properties
ValueResourceInputAccountFeesSearchRequest
object
A top-level object that encapsulates a Criteo API request for a single value object.
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hooklogic-criteo-accounts-api-openapi.yml Raw ↑

Other APIs HookLogic (Criteo) publishes across the network.

HookLogic (Criteo) Analytics API
HookLogic (Criteo) Audience API
HookLogic (Criteo) Balance API
HookLogic (Criteo) Billing API
HookLogic (Criteo) Campaign API
HookLogic (Criteo) Catalog API
HookLogic (Criteo) Gateway API