Skip to main content
GET
/
products
/
featured
List featured products
curl --request GET \
  --url https://api.salesive.com/api/v1/products/featured \
  --header 'Authorization: Bearer <token>'
{
  "status": 200,
  "success": true,
  "message": "List featured products",
  "data": {
    "products": [
      {
        "_id": "66a1f2c4e1b3a40012ab34cd",
        "name": "Classic Tee",
        "slug": "classic-tee",
        "price": 19.99,
        "promoPrice": 14.99,
        "quantity": 120,
        "featured": true,
        "images": [
          "https://cdn.salesive.com/p/classic-tee.jpg"
        ],
        "shop": {
          "_id": "66a1eee0e1b3a40012ab0001",
          "name": "Acme Store",
          "currency": {
            "symbol": "$",
            "code": "USD"
          }
        },
        "createdAt": "2026-06-01T10:00:00.000Z"
      }
    ]
  }
}
Returns the store’s featured products (those flagged featured: true), sorted by rating descending. Requires the READ_INVENTORY scope.

Authorizations

​
Authorization
string
header
required

Installed-app access token (prefix app_), issued by the OAuth install flow. The store is bound to the token server-side — never send a shop id.

Query Parameters

​
limit
integer
default:5

Maximum number of featured products to return.

Response

List featured products — success.

​
status
integer
required
Example:

200

​
success
boolean
required
Example:

true

​
message
string
required
Example:

"List featured products"

​
data
object
required
Example:
{
  "products": [
    {
      "_id": "66a1f2c4e1b3a40012ab34cd",
      "name": "Classic Tee",
      "slug": "classic-tee",
      "price": 19.99,
      "promoPrice": 14.99,
      "quantity": 120,
      "featured": true,
      "images": [
        "https://cdn.salesive.com/p/classic-tee.jpg"
      ],
      "shop": {
        "_id": "66a1eee0e1b3a40012ab0001",
        "name": "Acme Store",
        "currency": { "symbol": "$", "code": "USD" }
      },
      "createdAt": "2026-06-01T10:00:00.000Z"
    }
  ]
}