---
title: "/2026-01/retail-media/accounts/{account-id}/audiences/search"
method: POST
path: "/2026-01/retail-media/accounts/{account-id}/audiences/search"
tags: ["Audience"]
---

# /2026-01/retail-media/accounts/{account-id}/audiences/search

`POST /2026-01/retail-media/accounts/{account-id}/audiences/search`

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

## Path parameters

- `account-id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- RmAudienceSearchInputV1 — A top-level object that encapsulates a Criteo API request for a single value.
  - `data` RmAudienceSearchEntityV1Resource — A top-level object that encapsulates a Criteo API response for a single value
    - `attributes` RmAudienceSearchEntityV1 — Available filters to perform a search on audiences. If present, the filters are AND'ed together when applied.
      - `audienceIds` string[] — List of audience ids
      - `audienceSegmentIds` string[] — List of segment ids (linked to the result audiences)
      - `retailerIds` string[] — List of retailer ids
    - `type` string

## Response `200`

Success or partial success

- RmAudienceEntityV1RmAudienceSearchMetadataV1ListResponse — A top-level object that encapsulates a Criteo API response for several entities and metadata
  - `data` RmAudienceEntityV1Resource[], nullable
    - `attributes` RmAudienceEntityV1, nullable — Audience of people of interest for a marketer.
      - `accountId` string, nullable — Account associated to the audience
      - `algebra` RmAlgebraNodeV1, nullable — Node in the audience algebra definition.
        - `and` RmAlgebraNodeV1[], nullable
        - `audienceSegmentId` string, nullable
        - `not` RmAlgebraNodeV1 — recursive
        - `or` RmAlgebraNodeV1[], nullable
      - `channels` string[], nullable — Channels associated to the audience (read-only)
      - `createdAt` string, date-time, nullable — ISO-8601 timestamp in UTC of audience creation (read-only)
      - `createdById` string, nullable — User that created the audience
      - `description` string, nullable — Description of the audience
      - `name` string, nullable — Name of the audience
      - `retailerId` string, nullable — Retailer associated to the audience
      - `updatedAt` string, date-time, nullable — ISO-8601 timestamp in UTC of audience 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` RmAudienceSearchMetadataV1, nullable — Metadata for the audience 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.net/criteo/apis/criteo-api.md) · [All operations](https://skmtc.net/criteo/apis/criteo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/criteo/criteo-api/revisions/c1721589426a/schema)