---
title: "/2026-01/retail-media/retailers/{retailerId}/recommend-keywords"
method: POST
path: "/2026-01/retail-media/retailers/{retailerId}/recommend-keywords"
tags: ["Campaign"]
---

# /2026-01/retail-media/retailers/{retailerId}/recommend-keywords

`POST /2026-01/retail-media/retailers/{retailerId}/recommend-keywords`

Recommend keywords by given retailer id and sku ids.

## Path parameters

- `retailerId` string, required

## Request body

- ValueResourceInputRecommendedKeywordsRequestV1 — A top-level object that encapsulates a Criteo API request for a single value objects.
  - `data` ValueResourceRecommendedKeywordsRequestV1 — A value resource exposed by the API.
    - `attributes` RecommendedKeywordsRequestV1 — Request model of RecommendedKeywords
      - `productIds` string[], required — Product Id list that the recommended keywords generated on.
    - `type` string, nullable — Type of the resource.

## Response `200`

Success

- ValueResourceOutcomeRecommendedKeywordsResponseV1 — A top-level object that encapsulates a Criteo API response for a single value object.
  - `data` ValueResourceRecommendedKeywordsResponseV1, nullable — A value resource exposed by the API.
    - `attributes` RecommendedKeywordsResponseV1, nullable — Response model of Recommended Keywords
      - `recommendedKeywords` string[], required — Recommended keywords generated by given retailer Id and sku Ids.
    - `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.
  - `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)