How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Criteo Segment API

The Segment API from Criteo — 7 operation(s) for segment.

Criteo Segment API is one of 13 APIs that Criteo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Segment. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a changelog, and authentication docs.

This API exposes 7 operations across 7 paths, and defines 33 schemas. It is described by OpenAPI 3.2.0, at version 2026-01.

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

7 operations 7 paths 33 schemas 1 GET1 PATCH5 POST

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 1

Criteo Segment 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 7

Across 7 paths, the API surfaces 7 operations — 1 GET, 1 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.

Segment 7
PATCH
/2026-01/commerce-grid/audience-segments
/2026-01/commerce-grid/audience-segments
bulkUpdateAudienceSegments body → 200
POST
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove
AddRemoveContactListByAudienceSegment 1 param body → 200
POST
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/clear
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/clear
ClearContactListByAudienceSegment 1 param → 204
GET
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/statistics
/2026-01/commerce-grid/audience-segments/{audience-segment-id}/contact-list/statistics
getAudienceSegmentContactListStatistics 1 param → 200
POST
/2026-01/commerce-grid/audience-segments/create
/2026-01/commerce-grid/audience-segments/create
bulkCreateAudienceSegments body → 200
POST
/2026-01/commerce-grid/audience-segments/delete
/2026-01/commerce-grid/audience-segments/delete
bulkDeleteAudienceSegments body → 200
POST
/2026-01/commerce-grid/audience-segments/search
/2026-01/commerce-grid/audience-segments/search
searchAudienceSegments 2 params body → 200

Schemas 33

The contract defines 33 schemas that model the data the API accepts and returns. The most detailed are CommonProblem (9 properties), AudienceWarning (8 properties), CgAudienceSegmentEntityV1 (8 properties), AudienceError (8 properties). Each schema is shown below with its type and property counts.

CommonProblem
object
Common problem object.
9 properties
CgContactListStatisticsEntityV1
objectnull
Contact list statistics.
3 properties
CgAudienceSegmentUpdateEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
CommerceGridContactlistOperationResponseAttributes
object
Response data of Commerce Grid contact list amendment
2 properties 1 required
CgAudienceSegmentEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
CgAudienceSegmentSearchMetadataV1
objectnull
Metadata for the audience segment search response.
3 properties
CgContactListStatisticsEntityV1Response
object
A top-level object that encapsulates a Criteo API response for a single entity
3 properties
CgAudienceSegmentEntityV1
objectnull
Set of rules that defines specific people to target.
8 properties
CgAudienceSegmentIdEntityV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities
3 properties
CgAudienceSegmentBulkDeleteInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
CgAudienceSegmentSearchEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
CgContactListV1
objectnull
Settings to target users with your contact lists.
CgAudienceSegmentCreateEntityV1Resource
object
A top-level object that encapsulates a Criteo API response for a single value
2 properties
CommerceGridContactlistAmendment
object
Request data of Commerce Grid contact list amendment
2 properties 1 required
CommerceGridContactlistAmendmentRequest
object
Request of Commerce Grid contact list
1 property 1 required
CgAudienceSegmentSearchEntityV1
object
Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied.
4 properties
CgAudienceSegmentDeleteEntityV1
object
Segment to delete
NillableString
objectnull
Placeholder object for string value for which "null" is a valid business value
1 property
AudienceWarning
object
Definition of the warning
8 properties 4 required
CgAudienceSegmentBulkCreateInputV1
object
A top-level object that encapsulates a Criteo API request for several values.
1 property
CgAudienceSegmentDeleteEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
CgAudienceSegmentSearchInputV1
object
A top-level object that encapsulates a Criteo API request for a single value.
1 property
CgContactListStatisticsEntityV1Resource
objectnull
A class that represents a domain entity exposed by an API
3 properties
CgAudienceSegmentIdEntityV1
objectnull
Audience Segment entity only with its ID
CgContactListCreateV1
object
Settings to target users with your contact lists.
1 property
CgAudienceSegmentUpdateEntityV1
object
Set of rules that defines specific people to target.
2 properties
CgAudienceSegmentEntityV1CgAudienceSegmentSearchMetadataV1ListResponse
object
A top-level object that encapsulates a Criteo API response for several entities and metadata
4 properties
CgAudienceSegmentCreateEntityV1
object
Set of rules that defines specific people to target.
4 properties 2 required
CgAudienceSegmentIdEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
CgAudienceSegmentBulkUpdateInputV1
object
A top-level object that encapsulates a Criteo API request for several entities.
1 property
CgAudienceSegmentEntityV1Resource
object
A class that represents a domain entity exposed by an API
3 properties
AudienceError
object
Definition of an audience error
8 properties 3 required
CommerceGridContactlistOperation
object
Operation on Commerce Grid contact list
3 properties 3 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

criteo-segment-api-openapi.yml Raw ↑

Other APIs Criteo publishes across the network.

Criteo MCP Servers
Criteo Accounts API
Criteo Advertiser API
Criteo Analytics API
Criteo Audience API
Criteo Balance API
Criteo Billing API
Criteo Campaign API
Criteo Catalog API
Criteo Creative API
Criteo Gateway API
Criteo Reco API
Where this information came from

This is an independent, third-party profile of Criteo Segment 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.