Products

Get product

GET/api/v1/products/slug/:slug

Returns a published product's full detail, including its rating summary, recent reviews, and purchase count. Records a view for popularity ranking.

No authentication required

Public

Path parameters

slugstringrequired

Product slug.

Possible errors

404

NOT_FOUND

Produit introuvable.

Request

curl --request GET \
  --url https://api.swiftgoma.com/api/v1/products/slug/:slug

200Example response

{
  "success": true,
  "data": {
    "id": "prod_7c8d9e",
    "shopId": "shop_2b3c4d",
    "subcategoryId": "sub_1a2b3c",
    "name": "Riz parfumé 25kg",
    "slug": "riz-parfume-25kg",
    "description": "Riz parfumé de qualité supérieure, sac de 25kg, idéal pour la revente ou la consommation familiale.",
    "brand": "Uncle Sam",
    "unit": "piece",
    "weightGrams": 25000,
    "currency": "USD",
    "status": "PUBLISHED",
    "hasVariants": false,
    "images": [
      {
        "id": "img_1",
        "url": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/products/riz-1.jpg",
        "position": 0
      }
    ],
    "variants": [
      {
        "id": "var_4d5e6f",
        "name": null,
        "attributes": null,
        "sku": null,
        "price": "12.50",
        "stock": 40,
        "isDefault": true
      }
    ],
    "createdAt": "2026-01-10T09:00:00.000Z",
    "updatedAt": "2026-01-14T10:32:00.000Z",
    "subcategory": {
      "id": "sub_1a2b3c",
      "categoryId": "cat_9f1e2a3b",
      "name": "Boissons",
      "slug": "boissons",
      "sortOrder": 0,
      "isActive": true
    },
    "shop": {
      "id": "shop_2b3c4d",
      "name": "Boutique Aline",
      "slug": "boutique-aline",
      "status": "PUBLISHED",
      "logoUrl": "https://res.cloudinary.com/dx3wclabo/image/upload/v1/shops/aline-logo.jpg",
      "sellerProfile": {
        "city": "Goma"
      }
    },
    "rating": {
      "average": 4.5,
      "count": 12
    },
    "reviews": [
      {
        "id": "rev_1",
        "authorName": "Aline Mapendo",
        "rating": 5,
        "comment": "Excellent produit, livraison rapide.",
        "createdAt": "2026-01-20T12:00:00.000Z"
      }
    ],
    "purchaseCount": 34
  }
}