---
title: "Promoted Products"
method: GET
path: "/v2/{account_id}/promoted_products"
---

# Promoted Products

`GET /v2/{account_id}/promoted_products`

## Request

- Base URL: `https://developers.yotpo.com`
- URL: `https://developers.yotpo.com/v2/{account_id}/promoted_products`
- Auth: API key in header `X-Yotpo-Token`

Yotpo's smart algorithm automatically promotes your most popular products by purchase date, star rating, number of reviews, and manually selected products. <a href="https://support.yotpo.com/docs/promoted-products-in-the-reviews-widget-2446379" target="_blank">Promoted Products</a> are a great way to showcase your most popular or complementary products for better exposure.

## Path parameters

- `account_id` string, required

## Response `200`

200

- object
  - `status` object
    - `code` integer
    - `message` string
  - `pagination` unknown
  - `promoted_products` object
    - `products` object[]
      - `external_product_id` string
      - `type` string
      - `position` integer

## Other responses

- `400`: 400
- `401`: Missing or invalid access token. Send a valid token in the `X-Yotpo-Token` header.

## Changes

- **2026-11-03** `5bcae8239b6e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/yotpo/apis/app-developer-api/changes/v2/:account_id/promoted_products/get.md)

---

[API](https://skmtc.dev/yotpo/apis/app-developer-api.md) - [All operations](https://skmtc.dev/yotpo/apis/app-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/yotpo/apis/app-developer-api/revisions/5bcae8239b6e?raw)