Criteo Audience API
The Audience API from Criteo — 24 operation(s) for audience.
Criteo Audience API is one of 13 APIs that 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, an API reference, a changelog, and authentication docs.
This API exposes 25 operations across 24 paths, and defines 150 schemas. It is described by OpenAPI 3.2.0, at version 2026-07.
Requests are made against a single base URL, https://api.criteo.com.
25 operations
24 paths
150 schemas
1 DELETE4 GET4 PATCH16 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
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 25
Across 24 paths, the API surfaces 25 operations — 1 DELETE, 4 GET, 4 PATCH, 16 POST. Each is listed below with its method, path, parameters, and response codes.
Audience 25
PATCH
/2026-07/marketing-solutions/audience-segments
/2026-07/marketing-solutions/audience-segments
DELETE
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
PATCH
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list
GET
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics
/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics
POST
/2026-07/marketing-solutions/audience-segments/compute-sizes
/2026-07/marketing-solutions/audience-segments/compute-sizes
POST
/2026-07/marketing-solutions/audience-segments/create
/2026-07/marketing-solutions/audience-segments/create
POST
/2026-07/marketing-solutions/audience-segments/delete
/2026-07/marketing-solutions/audience-segments/delete
POST
/2026-07/marketing-solutions/audience-segments/estimate-size
/2026-07/marketing-solutions/audience-segments/estimate-size
GET
/2026-07/marketing-solutions/audience-segments/in-market-brands
/2026-07/marketing-solutions/audience-segments/in-market-brands
GET
/2026-07/marketing-solutions/audience-segments/in-market-interests
/2026-07/marketing-solutions/audience-segments/in-market-interests
POST
/2026-07/marketing-solutions/audience-segments/search
/2026-07/marketing-solutions/audience-segments/search
PATCH
/2026-07/marketing-solutions/audiences
/2026-07/marketing-solutions/audiences
POST
/2026-07/marketing-solutions/audiences/compute-sizes
/2026-07/marketing-solutions/audiences/compute-sizes
POST
/2026-07/marketing-solutions/audiences/create
/2026-07/marketing-solutions/audiences/create
POST
/2026-07/marketing-solutions/audiences/delete
/2026-07/marketing-solutions/audiences/delete
POST
/2026-07/marketing-solutions/audiences/estimate-size
/2026-07/marketing-solutions/audiences/estimate-size
POST
/2026-07/marketing-solutions/audiences/search
/2026-07/marketing-solutions/audiences/search
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 150
The contract defines 150 schemas that model the data the API accepts and returns. The most detailed are AudienceSegmentEntityV1 (13 properties), RmAudienceSegmentEntityV1 (11 properties), AudienceSegmentCreateEntityV1 (9 properties), CommonProblem (9 properties). Each schema is shown below with its type and property counts.
AudienceIdEntityV1
objectnull
Audience entity with only its ID
AudienceEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
LookalikeCreateV1
object
Settings to target users close to a given seed segment.
2 properties
1 required
AudienceSegmentUpdateEntityV1
object
Set of rules that defines specific people to target.
7 properties
InMarketAudienceSegmentBrandEntityV1
objectnull
In-market segment brand entity
2 properties
AudienceSegmentSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
InMarketV1
objectnull
Settings to target users based on high shopping intents and demographics.
6 properties
AudienceSegmentSizeEstimationV1Response
object
A top-level object that encapsulates a Criteo API response for a single value
3 properties
ContactListCreateV1
object
Settings to target users with your contact lists.
AudienceSegmentDeleteEntityV1
object
Segment to delete
AudienceSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AudienceNameDescription
objectnull
Description of an audience with name and detailed description
2 properties
InMarketSizeEstimationV1
object
Settings to target users based on high shopping intents and demographics.
6 properties
1 required
ProspectingCreateV1
object
Settings to target prospecting users to website visitors.
3 properties
1 required
AudienceSegmentSizeEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
AudienceBulkUpdateInputV1
object
Input to update one or more audiences.
1 property
AudienceUpdateEntityV1
object
Audience of people of interest for a marketer.
3 properties
ContactlistAmendmentRequest
object
Request for a contactlist amendment
1 property
1 required
ContactlistAmendment
object
Parameters for the amendment of a contactlist
2 properties
2 required
InMarketAudienceSegmentInterestEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
NillableString
objectnull
Placeholder object for string value for which "null" is a valid business value
1 property
AlgebraNodeV1
objectnull
Node in the audience algebra definition.
4 properties
AudienceCreateEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AudienceSegmentEntityV1
objectnull
Set of rules that defines specific people to target.
13 properties
AudienceSegmentSearchInputV1
object
Audience segment search parameter
1 property
PointOfInterestV1
object
Named coordinate defined by its latitude and longitude. Latitude and Longitude are rounded at 5 decimals.
3 properties
AudienceSegmentEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RetargetingCreateV1
object
Settings to target users based on its type and days since last visit.
3 properties
3 required
InMarketAudienceSegmentBrandEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSizeEstimationV1
objectnull
Audience size estimation
1 property
LocationUpdateV1
object
Settings to target users based on their location.
3 properties
AudienceEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
AudienceSegmentSizeEstimationV1
objectnull
Segment size estimation
1 property
InMarketAudienceSegmentBrandEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
NillableGenderV1
objectnull
Placeholder object for value for which "null" is a valid business value
1 property
AudienceSizeEstimationV1Response
object
A top-level object that encapsulates a Criteo API response for a single value
3 properties
AudienceSearchEntityV1
object
Available filters to perform a search on segments. If present, the filters are AND'ed together when applied.
4 properties
AudienceSegmentEstimateSizeInputV1
object
Input to estimate the size of an audience segment..
1 property
AudienceIdEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
ModifyAudienceResponse
object
Parameters to modify an audience
3 properties
3 required
AudienceSearchInputV1
object
Audience search parameter
1 property
ContactListStatisticsEntityV1Resource
objectnull
A class that represents a domain entity exposed by an API
3 properties
AudienceEntityV1
objectnull
Audience of people of interest for a marketer.
7 properties
AudienceEntityV1AudienceSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
LookalikeV1
objectnull
Settings to target users that behave like a given seed segment
2 properties
ContactListStatisticsEntityV1
objectnull
Contact list statistics.
3 properties
LocationCreateV1
object
Settings to target users based on their location.
2 properties
2 required
AudienceComputeSizesInputV1
object
Input to retrieve the size of one or more audiences.
1 property
NillableInt32
objectnull
Placeholder object for value for which "null" is a valid business value
1 property
InMarketCreateV1
object
Settings to target users based on high shopping intents and demographics.
6 properties
1 required
AudienceBulkDeleteInputV1
object
Input to delete one or more audiences.
1 property
AudienceSizeEntityV1
objectnull
Audience entity only with its size
1 property
AudienceSegmentSizeEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceIdEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentIdEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
InMarketAudienceSegmentInterestEntityV1
objectnull
In-market segment interest entity
1 property
AudienceCreateEntityV1
object
Audience of people of interest for a marketer.
4 properties
3 required
LocationSizeEstimationV1
object
Settings to define your audience based on their location.
2 properties
2 required
AudienceEstimateSizeEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AudienceSegmentUpdateEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentComputeSizesInputV1
object
Input to retrieve the size of one or more segments.
1 property
BasicAudienceDefinition
object
Common definition of an audience
3 properties
2 required
AudienceSegmentSizeEntityV1
objectnull
Set of rules that defines specific people to target.
1 property
AudienceDeleteEntityV1
object
Audience to delete
AudienceSegmentBulkDeleteInputV1
object
Input to delete one or more segments.
1 property
AudienceSizeEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
AudienceEstimateSizeEntityV1
object
Audience of people of interest for a marketer.
2 properties
2 required
AudienceSegmentComputeSizeEntityV1
object
Set of rules that defines specific people to target.
AudienceBulkCreateInputV1
object
Input to create one or more audiences.
1 property
InMarketUpdateV1
object
Settings to target users based on high shopping intents and demographics.
6 properties
ContactListStatisticsEntityV1Response
object
A top-level object that encapsulates a Criteo API response for a single entity
3 properties
AudienceSegmentCreateEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
DeleteAudienceContactListResponse
object
Response of a contactlist deletion
3 properties
3 required
AudienceSegmentIdEntityV1
objectnull
Audience Segment entity only with its ID
RetargetingUpdateV1
object
Settings to target users based on its type and days since last visit.
3 properties
AudienceError
object
Definition of an audience error
8 properties
3 required
AudienceSegmentIdEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
AudienceSearchMetadataV1
objectnull
Metadata for the audience search response.
3 properties
AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
RetargetingV1
objectnull
Settings to target users based on its type and days since last visit.
3 properties
CommonProblem
object
Common problem object.
9 properties
AudienceSizeEstimationV1Resource
objectnull
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AudienceSegmentSizeEstimationV1Resource
objectnull
A top-level object that encapsulates a Criteo API response for a single value
2 properties
InMarketAudienceSegmentInterestEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
ContactListV1
objectnull
Settings to target users with your contact lists.
1 property
LookalikeUpdateV1
object
Settings to target users that behave like a given seed segment
1 property
AudienceSegmentComputeSizeEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentBulkCreateInputV1
object
Input to create one or more audience segments.
1 property
AudienceSegmentSizeEstimationEntityV1
object
Set of rules that defines specific people to target.
3 properties
1 required
AudienceSegmentSearchEntityV1
object
Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied.
3 properties
ProspectingV1
objectnull
Settings to target prospecting users to website visitors.
3 properties
AudienceSegmentSearchMetadataV1
objectnull
Metadata for the audience segment search response.
3 properties
ContactlistOperation
object
Response definition of a contactlist operation
2 properties
2 required
BehavioralV1
objectnull
Settings of a behavioral set of users provided by Criteo.
4 properties
1 required
AudienceComputeSizeEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
AudienceWarning
object
Definition of the warning
8 properties
4 required
AudienceSizeEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentDeleteEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceDeleteEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentSizeEstimationEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
AudienceEstimateSizeInputV1
object
Input to estimate the size of an audience.
1 property
LocationV1
objectnull
Settings to target users based on their location.
3 properties
ProspectingUpdateV1
object
Settings to target prospecting users to website visitors.
3 properties
AudienceComputeSizeEntityV1
object
Audience of people of interest for a marketer.
AudienceSegmentCreateEntityV1
object
Set of rules that defines specific people to target.
9 properties
2 required
AudienceUpdateEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceSegmentBulkUpdateInputV1
object
Input to update one or more segments.
1 property
RmAudienceSegmentIdEntityV1
objectnull
Audience Segment entity only with its ID
RmEventsCreateV1
object
Settings to target users based on their behavior
6 properties
2 required
RmAudienceSegmentBulkCreateInputV1
object
A top-level object that encapsulates a Criteo API request for several values.
1 property
RmAudienceSegmentEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmContactListUpdateV1
object
Settings to update the contact list of the segment
RmAudienceEntityV1RmAudienceSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
NillableDecimal
objectnull
Placeholder object for value for which "null" is a valid business value
1 property
RmAudienceSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
RmAudienceSegmentBulkDeleteInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
RmAudienceSegmentCreateEntityV1
object
Set of rules that defines specific people to target.
5 properties
2 required
RmAudienceSegmentDeleteEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAudienceSegmentIdEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
RmAudienceSegmentEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
RmContactListV1
objectnull
Settings to target users with your contact lists.
3 properties
RmAudienceSegmentSearchInputV1
object
A top-level object that encapsulates a Criteo API request for a single value.
1 property
RetailMediaContactlistAmendment
object
Request data of retail media contact list amendment
2 properties
1 required
RmEventsV1
objectnull
Settings to target users based on their behavior
6 properties
RetailMediaContactlistAmendmentRequest
object
Request of Retail Media contactlist
1 property
1 required
RmContactListStatisticsEntityV1Response
object
A top-level object that encapsulates a Criteo API response for a single entity
3 properties
RmAudienceSegmentIdEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmAudienceSegmentSearchEntityV1
object
Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied.
3 properties
RmAudienceSearchEntityV1
object
Available filters to perform a search on audiences. If present, the filters are AND'ed together when applied.
3 properties
RmAudienceSearchMetadataV1
objectnull
Metadata for the audience search response.
3 properties
RmContactListStatisticsEntityV1Resource
objectnull
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
RetailMediaContactlistOperationResponseAttributes
object
The attributes of Retail Media contact list operation
7 properties
3 required
RmAudienceSegmentCreateEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
RmAudienceSegmentEntityV1
objectnull
Set of rules that defines specific people to target.
11 properties
RmAudienceSegmentSearchMetadataV1
objectnull
Metadata for the audience segment search response.
3 properties
RmAlgebraNodeV1
objectnull
Node in the audience algebra definition.
4 properties
RmAudienceSegmentUpdateEntityV1
object
Set of rules that defines specific people to target.
4 properties
RetailMediaContactlistOperation
object
Operation on Retail Media contact list
4 properties
3 required
RmContactListCreateV1
object
Settings to target users with your contact lists.
1 property
RmAudienceSegmentUpdateEntityV1Resource
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
RmAudienceEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
RmContactListStatisticsEntityV1
objectnull
Contact list statistics.
3 properties
RmAudienceSegmentBulkUpdateInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
RmAudienceEntityV1
objectnull
Audience of people of interest for a marketer.
9 properties
RmAudienceSearchInputV1
object
A top-level object that encapsulates a Criteo API request for a single value.
1 property
RmEventsUpdateV1
object
Settings to target users based on their behavior
6 properties
RmAudienceSegmentDeleteEntityV1
object
Segment to delete
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Criteo 12
Other APIs Criteo publishes across the network.
Criteo MCP Servers
Criteo Accounts API
Criteo Advertiser API
Criteo Analytics API
Criteo Balance API
Criteo Billing API
Criteo Campaign API
Criteo Catalog API
Criteo Creative API
Criteo Gateway API
Criteo Reco API
Criteo Segment API
#Audience
Where this information came from
This is an independent, third-party profile of Criteo Audience API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.