---
title: "/2026-01/retail-media/accounts/{accountId}/retailers/search"
method: POST
path: "/2026-01/retail-media/accounts/{accountId}/retailers/search"
tags: ["Campaign"]
---

# /2026-01/retail-media/accounts/{accountId}/retailers/search

`POST /2026-01/retail-media/accounts/{accountId}/retailers/search`

Searches for retailers associated with the specified account based on provided search criteria

## Path parameters

- `accountId` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Request body

- ValueResourceInputOfRetailerSearchRequest — A top-level object that encapsulates a Criteo API request for a single value object.
  - `data` ValueResourceOfRetailerSearchRequest — A value resource exposed by the API.
    - `attributes` RetailerSearchRequest — Request model for searching retailers
      - `retailerIdFilter` string[], nullable — Optional list of retailer IDs to filter the results
    - `type` string, nullable — Type of the resource.

## Response `200`

Success

- EntityResourceCollectionOutcomeOfRetailerResultAndMetadata — A top-level object that encapsulates a Criteo API response for several entities and metadata.
  - `data` EntityResourceOfRetailerResult[], nullable
    - `attributes` RetailerResult, nullable — The result of a query for the configuration of a retailer
      - `campaignAvailabilities` CampaignAvailability[], nullable — A list of campaign availabilities for the retailer, each of which shows the availability of a specific campaign type and buy type combination
        - `buyType` 'unknown' | 'auction' | 'preferredDeals' | 'sponsorship' | 'offsite', nullable — The buy type this object represents availability for
        - `campaignType` 'unknown' | 'sponsoredProducts' | 'onsiteDisplay' | 'offsite', nullable — The type of campaign this object represents availability for
        - `isAvailable` boolean, nullable — Indicates whether the campaign type and buy type combination is available for the retailer
        - `validCombinations` PageTypeCombination[], nullable — PageType-PageEnvironmentType pairs which are supported for this campaign-buy type combination
          - `pageEnvironmentType` 'unknown' | 'web' | 'mobile' | 'app' | 'lockout' | 'mixed' | 'ios' | 'android', nullable — The page types which are supported for this campaign-buy type combination
          - `pageType` 'unknown' | 'search' | 'home' | 'checkout' | 'category' | 'productDetail' | 'confirmation' | 'merchandising' | 'deals' | 'favorites' | 'searchbar' | 'categoryMenu', nullable — The page types which are supported for this campaign-buy type combination
      - `name` string, nullable — Name of the retailer
    - `id` string, nullable — Unique id of the entity.
    - `type` string, nullable — Type of the resource.
  - `errors` SdkApiRestCommonProblem[], nullable — Errors that occured during this call.
    - `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.
    - `type` 'unknown' | 'access-control' | 'authentication' | 'authorization' | 'availability' | 'deprecation' | 'quota' | 'validation', nullable — The problem's category.
  - `metadata` Metadata, nullable — Metadata related to the current request.
    - `count` integer, nullable
    - `limit` integer, required — The number of elements to be returned.
    - `offset` integer, required — The (zero-based) starting offset in the collection.
  - `warnings` SdkApiRestCommonProblem[], nullable — Warnings that occured during this call.
    - `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.
    - `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)