HookLogic (Criteo) Audience API
The Audience API from HookLogic (Criteo) — 8 operation(s) for audience.
HookLogic (Criteo) Audience 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 Audience. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.
This API exposes 8 operations across 8 paths, and defines 46 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.
8 operations
8 paths
46 schemas
1 GET1 PATCH6 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
HookLogic (Criteo) Audience 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 8
Across 8 paths, the API surfaces 8 operations — 1 GET, 1 PATCH, 6 POST. Each is listed below with its method, path, parameters, and response codes.
Audience 8
PATCH
/2026-07/retail-media/accounts/{account-id}/audience-segments
/2026-07/retail-media/accounts/{account-id}/audience-segments
GET
/2026-07/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list
/2026-07/retail-media/accounts/{account-id}/audience-segments/{audience-segment-id}/contact-list
POST
/2026-07/retail-media/accounts/{account-id}/audience-segments/create
/2026-07/retail-media/accounts/{account-id}/audience-segments/create
POST
/2026-07/retail-media/accounts/{account-id}/audience-segments/delete
/2026-07/retail-media/accounts/{account-id}/audience-segments/delete
POST
/2026-07/retail-media/accounts/{account-id}/audience-segments/search
/2026-07/retail-media/accounts/{account-id}/audience-segments/search
POST
/2026-07/retail-media/accounts/{account-id}/audiences/search
/2026-07/retail-media/accounts/{account-id}/audiences/search
POST
/2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove
/2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/add-remove
POST
/2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/clear
/2026-07/retail-media/audience-segments/{audience-segment-id}/contact-list/clear
Schemas 46
The contract defines 46 schemas that model the data the API accepts and returns. The most detailed are RmAudienceSegmentEntityV1 (11 properties), CommonProblem (9 properties), RmAudienceEntityV1 (9 properties), AudienceWarning (8 properties). Each schema is shown below with its type and property counts.
RmAudienceSegmentSearchEntityV1
object
Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied.
3 properties
RmAudienceSearchInputV1
object
A top-level object that encapsulates a Criteo API request for a single value.
1 property
RmAudienceSegmentUpdateEntityV1
object
Set of rules that defines specific people to target.
4 properties
RetailMediaContactlistOperationResponseAttributes
object
The attributes of Retail Media contact list operation
7 properties
3 required
RmAudienceSegmentBulkDeleteInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
RmAudienceSegmentBulkCreateInputV1
object
A top-level object that encapsulates a Criteo API request for several values.
1 property
RmAudienceSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
CommonProblem
object
Common problem object.
9 properties
RmAudienceSegmentCreateEntityV1
object
Set of rules that defines specific people to target.
5 properties
2 required
RmContactListV1
object
Settings to target users with your contact lists.
3 properties
RmAudienceSegmentIdEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAudienceSegmentSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
RmAudienceSegmentDeleteEntityV1
object
Segment to delete
RmAudienceSearchMetadataV1
object
Metadata for the audience search response.
3 properties
RmAudienceSearchEntityV1
object
Available filters to perform a search on audiences. If present, the filters are AND'ed together when applied.
3 properties
RmEventsCreateV1
object
Settings to target users based on their behavior
6 properties
2 required
RmAudienceSegmentCreateEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
NillableDecimal
object
Placeholder object for value for which "null" is a valid business value
1 property
RmEventsUpdateV1
object
Settings to target users based on their behavior
6 properties
RmAudienceEntityV1RmAudienceSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
RmContactListStatisticsEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmContactListStatisticsEntityV1
object
Contact list statistics.
3 properties
RetailMediaContactlistOperation
object
Operation on Retail Media contact list
4 properties
3 required
AudienceWarning
object
Definition of the warning
8 properties
4 required
RmAudienceSegmentSearchInputV1
object
A top-level object that encapsulates a Criteo API request for a single value.
1 property
RmAudienceSegmentEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAlgebraNodeV1
object
Node in the audience algebra definition.
4 properties
AudienceError
object
Definition of an audience error
8 properties
3 required
RmAudienceSegmentIdEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
RmAudienceSegmentIdEntityV1
object
Audience Segment entity only with its ID
RetailMediaContactlistAmendment
object
Request data of retail media contact list amendment
2 properties
1 required
NillableString
object
Placeholder object for string value for which "null" is a valid business value
1 property
RmAudienceEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAudienceSegmentDeleteEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAudienceSegmentEntityV1RmAudienceSegmentSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
RmContactListUpdateV1
object
Settings to update the contact list of the segment
RmContactListCreateV1
object
Settings to target users with your contact lists.
1 property
RmAudienceSegmentEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
RmAudienceSegmentEntityV1
object
Set of rules that defines specific people to target.
11 properties
RmContactListStatisticsEntityV1Response
object
A top-level object that encapsulates a Criteo API response for a single entity
3 properties
RmAudienceSegmentUpdateEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmEventsV1
object
Settings to target users based on their behavior
6 properties
RetailMediaContactlistAmendmentRequest
object
Request of Retail Media contactlist
1 property
1 required
RmAudienceSegmentSearchMetadataV1
object
Metadata for the audience segment search response.
3 properties
RmAudienceSegmentBulkUpdateInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
RmAudienceEntityV1
object
Audience of people of interest for a marketer.
9 properties
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from HookLogic (Criteo) 7
Other APIs HookLogic (Criteo) publishes across the network.
HookLogic (Criteo) Accounts API
HookLogic (Criteo) Analytics API
HookLogic (Criteo) Balance API
HookLogic (Criteo) Billing API
HookLogic (Criteo) Campaign API
HookLogic (Criteo) Catalog API
HookLogic (Criteo) Gateway API
#Audience