---
title: "/2026-01/commerce-grid/audience-segments/search"
method: POST
path: "/2026-01/commerce-grid/audience-segments/search"
tags: ["Segment"]
---

# /2026-01/commerce-grid/audience-segments/search

`POST /2026-01/commerce-grid/audience-segments/search`

## Request

- Base URL: `https://api.criteo.com`
- URL: `https://api.criteo.com/2026-01/commerce-grid/audience-segments/search`
- Auth: OAuth 2
  - Authorization code: `https://api.criteo.com/oauth2`
  - Client credentials
  - Token URL: `https://api.criteo.com/oauth2/token` scopes: `CommerceGrid_Segment_Read`
- TypeScript: <https://skmtc.dev/criteo/apis/criteo-api/docs/2026-01/commerce-grid/audience-segments/search/post.ts> (a function with typed inputs; its response is checked against the schema)

Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- CgAudienceSegmentSearchInputV1: A top-level object that encapsulates a Criteo API request for a single value.
  - `data` CgAudienceSegmentSearchEntityV1Resource: A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` CgAudienceSegmentSearchEntityV1: Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied.
      - `audienceSegmentIds` string[]: List of segment ids
      - `audienceSegmentTypes` string[]: List of segment types
      - `dataProviderIds` string[]: List of data provider ids
      - `remoteIds` string[]: List of ids used to identify the segment in the data provider's system
    - `type` string

## Response `200`

Success

- CgAudienceSegmentEntityV1CgAudienceSegmentSearchMetadataV1ListResponse: A top-level object that encapsulates a Criteo API response for several entities and metadata
  - `data` CgAudienceSegmentEntityV1Resource[], nullable
    - `attributes` CgAudienceSegmentEntityV1, nullable: Set of rules that defines specific people to target.
      - `contactList` CgContactListV1, nullable: Settings to target users with your contact lists.
      - `createdAt` string, date-time, nullable: ISO-8601 timestamp in UTC of segment creation (read-only)
      - `dataProviderId` string, nullable: Data provider associated to the segment (read-only)
      - `description` string, nullable: Description of the segment
      - `name` string, nullable: Name of the segment
      - `remoteId` string, nullable: The ID used to identify the segment in the data provider's system (read-only)
      - `type` 'Unknown' | 'ContactList', nullable: Type of segment (read-only)
      - `updatedAt` string, date-time, nullable: ISO-8601 timestamp in UTC of segment update (read-only)
    - `id` string, nullable: Id of the entity
    - `type` string, nullable
  - `errors` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.
  - `meta` CgAudienceSegmentSearchMetadataV1, nullable: Metadata for the audience segment search response.
    - `limit` integer, nullable: Max item of the current page
    - `offset` integer, nullable: Number of item to skip
    - `totalItems` integer, nullable: Total number of items
  - `warnings` CommonProblem[], nullable
    - `code` string, nullable: A machine-readable error code, expressed as a string value.
    - `detail` string, nullable: A human-readable explanation specific to this occurrence of the problem
    - `instance` string, nullable: A URI that identifies the specific occurrence of the problem.
    - `source` object, nullable: A machine-readable structure to reference to the exact location(s) causing the error(s)
    - `stackTrace` string, nullable
    - `title` string, nullable: A short human-readable description of the problem type
    - `traceId` string, nullable: The request correlation ID this problem comes from.
    - `traceIdentifier` string, nullable: The request correlation ID this problem comes from. (deprecated, use traceId instead)
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable: The problem's category.

---

[API](https://skmtc.dev/criteo/apis/criteo-api.md) - [All operations](https://skmtc.dev/criteo/apis/criteo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/criteo/apis/criteo-api/revisions/c1721589426a?raw)