> Documentation index: https://docs.sellhidden.com/llms.txt

# Public

Source: https://docs.sellhidden.com/reference/public

One store's catalogue for any site.

## Base URL and the five calls

- Base URL: `https://api.sellhidden.com/v1`

- [GET /public/products/{storeSlug}](https://docs.sellhidden.com/reference/public#public-products): Products of a store
- [GET /public/products/{storeSlug}/{slug}](https://docs.sellhidden.com/reference/public#public-product): One product
- [GET /public/categories/{storeSlug}](https://docs.sellhidden.com/reference/public#public-categories): Categories of a store
- [GET /public/reviews/{storeSlug}](https://docs.sellhidden.com/reference/public#public-reviews): Visible reviews
- [GET /public/recent-sales/{storeSlug}](https://docs.sellhidden.com/reference/public#public-recent-sales): Recent sales

**Details**

Success is `{ "ok": true, ... }`, with no data wrapper.

No key, safe to call from a browser: products, categories, visible reviews and recent sales of any live store.

- **No key.** Safe to call from a browser: every answer allows any origin.
- **Cache.** Cached 60 seconds at the edge, so prices and stock can lag a little.
- **Rate limit.** 120 requests a minute per IP address, shared by the five calls.
- **Live stores only.** A suspended or Private store answers `404`. Buyer emails in reviews are masked; order ids are never shown.
- **Money and time.** US dollars as JSON numbers, rounded to cents (`49`, `9.5`). Times in ISO 8601 UTC.
- **Lists.** `?limit=&cursor=`, forward only. Stop when `hasMore` is false.

Every rule in full: [the API basics](https://docs.sellhidden.com/reference#authentication).

## Products of a store.

### GET /public/products/{storeSlug}

Active products in storefront order. `displayPriceUsd` is the lowest variation price (or the base price when there are no variations). For serial-key products `stock` is the number of unused keys. When the seller hides sold-out products on the storefront, they are omitted here too. No key needed.

**Path**

| Path | Type | Description |
| --- | --- | --- |
| `storeSlug` (required) | string | The store's slug, as in its address. |

**Query parameters**

| Query parameters | Type | Description |
| --- | --- | --- |
| `categorySlug` | string | Only products in this category. |
| `limit` | 1..100 | Page size. Default 50. |
| `cursor` | string | nextCursor from the previous page. |

```bash
curl \
  "https://api.sellhidden.com/v1/public/products/my-store"
```

Response (200):

```json
{
  "ok": true,
  "store": {
    "slug": "my-store",
    "name": "My Store"
  },
  "products": [
    {
      "slug": "lifetime-license",
      "name": "Lifetime license",
      "displayPriceUsd": 29,
      "inStock": true,
      …
    }
  ],
  "nextCursor": null,
  "hasMore": false
}
```

## One product.

### GET /public/products/{storeSlug}/{slug}

One product with its variations, category, stock and rating. This is the call the live-price embed makes. No key needed.

**Path**

| Path | Type | Description |
| --- | --- | --- |
| `storeSlug` (required) | string | The store's slug, as in its address. |
| `slug` (required) | string | The product's slug. |

```bash
curl \
  "https://api.sellhidden.com/v1/public/products/my-store/lifetime-license"
```

Response (200):

```json
{
  "ok": true,
  "store": {
    "slug": "my-store",
    "name": "My Store"
  },
  "product": {
    "id": "clx…",
    "slug": "lifetime-license",
    "name": "Lifetime license",
    "description": "…",
    "priceUsd": 49,
    "displayPriceUsd": 29,
    "compareAtUsd": null,
    "currency": "USD",
    "coverImage": "https://…/cover.png",
    "galleryImages": [],
    "deliveryType": "keys",
    "deliveryTypes": [ "keys" ],
    "inStock": true,
    "stock": 120,
    "variations": [
      {
        "id": "clx…",
        "label": "1 device",
        "priceUsd": 29,
        "compareAtUsd": null,
        "inStock": true,
        "stock": 80,
        "description": null,
        "deliveryTypes": [ "keys" ]
      },
      {
        "id": "clx…",
        "label": "5 devices",
        "priceUsd": 49,
        "compareAtUsd": 69,
        "inStock": true,
        "stock": 40,
        "description": "Team pack",
        "deliveryTypes": [ "keys" ]
      }
    ],
    "category": {
      "id": "clx…",
      "name": "Software",
      "slug": "software"
    },
    "salesCount": 312,
    "reviewCount": 41,
    "averageRating": 4.8,
    "url": "https://my-store.sellhidden.com/p/lifetime-license",
    "createdAt": "2026-06-01T10:00:00.000Z",
    "updatedAt": "2026-09-20T08:12:44.000Z"
  }
}
```

## Categories of a store.

### GET /public/categories/{storeSlug}

Categories in display order with the number of active products in each. Use `slug` as `categorySlug` on the products endpoint. No key needed.

**Path**

| Path | Type | Description |
| --- | --- | --- |
| `storeSlug` (required) | string | The store's slug, as in its address. |

```bash
curl \
  "https://api.sellhidden.com/v1/public/categories/my-store"
```

Response (200):

```json
{
  "ok": true,
  "store": {
    "slug": "my-store",
    "name": "My Store"
  },
  "categories": [
    {
      "id": "clx…",
      "name": "Software",
      "slug": "software",
      "position": 0,
      "productCount": 12,
      "createdAt": "2026-05-02T09:00:00.000Z"
    }
  ]
}
```

## Visible reviews.

### GET /public/reviews/{storeSlug}

Visible reviews with a store-wide summary. `distribution` counts one to five stars in order. Every review is tied to a paid order; sellers can hide reviews but never edit or delete them. `source` is `buyer`, or `auto` for an automatic rating recorded when the buyer wrote nothing for seven days (never `verified`, and replaced as soon as the buyer writes their own). `editedAt` is set when the buyer changed their review. `sellerReply` is the store's public reply (null if none), with `sellerRepliedAt`. No key needed.

**Path**

| Path | Type | Description |
| --- | --- | --- |
| `storeSlug` (required) | string | The store's slug, as in its address. |

**Query parameters**

| Query parameters | Type | Description |
| --- | --- | --- |
| `productSlug` | string | Only reviews of this product. |
| `rating` | 1..5 | Only this star rating. |
| `limit` | 1..100 | Page size. Default 20. |
| `cursor` | string | nextCursor from the previous page. |

```bash
curl "https://api.sellhidden.com/v1/public/reviews/my-store"
```

Response (200):

```json
{
  "ok": true,
  "store": {
    "slug": "my-store",
    "name": "My Store"
  },
  "summary": {
    "count": 41,
    "average": 4.8,
    "distribution": [ 0, 1, 1, 5, 34 ]
  },
  "reviews": [
    {
      "id": "clx…",
      "productId": "clx…",
      "productSlug": "lifetime-license",
      "productName": "Lifetime license",
      "orderId": null,
      "buyerEmail": "jo***",
      "rating": 5,
      "comment": "Delivered in seconds.",
      "verified": true,
      "visible": true,
      "source": "buyer",
      "editedAt": null,
      "sellerReply":
        "Thanks for the kind words!",
      "sellerRepliedAt":
        "2026-09-19T16:20:00.000Z",
      "createdAt": "2026-09-19T15:04:00.000Z",
      "updatedAt": "2026-09-19T16:20:00.000Z"
    }
  ],
  "nextCursor": null,
  "hasMore": false
}
```

## Recent sales.

### GET /public/recent-sales/{storeSlug}

The latest paid items, to show buyers that others buy here. Times are rounded to the hour. No buyer name or email is included; `country` is the buyer's two-letter country code, or null. Returns an empty list when the seller turned the recent-sales widget off. No key needed.

**Path**

| Path | Type | Description |
| --- | --- | --- |
| `storeSlug` (required) | string | The store's slug, as in its address. |

**Query parameters**

| Query parameters | Type | Description |
| --- | --- | --- |
| `limit` | 1..25 | Page size. Default 10. |

```bash
curl \
  "https://api.sellhidden.com/v1/public/recent-sales/my-store"
```

Response (200):

```json
{
  "ok": true,
  "store": {
    "slug": "my-store",
    "name": "My Store"
  },
  "sales": [
    {
      "product": {
        "slug": "lifetime-license",
        "name": "Lifetime license",
        "coverImage": null
      },
      "variationLabel": "1 device",
      "quantity": 1,
      "country": null,
      "at": "2026-09-26T10:00:00.000Z"
    }
  ]
}
```

## More

- [The API basics](https://docs.sellhidden.com/reference): Keys, scopes, errors and lists, for every call.
  - [Authentication](https://docs.sellhidden.com/reference#authentication)
  - [Scopes](https://docs.sellhidden.com/reference#scopes)
  - [Errors](https://docs.sellhidden.com/reference#responses)
  - [Pagination](https://docs.sellhidden.com/reference#pagination)
- [Sell with a Buy button](https://docs.sellhidden.com/buy-button): Two lines on any page, with the live price.
  - [Live price](https://docs.sellhidden.com/buy-button#embed-price)
  - [Checkout links](https://docs.sellhidden.com/buy-button#checkout-links)

**OpenAPI 3.1**

- the OpenAPI address: `https://api.sellhidden.com/v1/openapi.json`
