Skip to content

: one store's catalogue for any site.

Code in .

Change a violet word: every block below follows.

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.

Products of a store.

GET/public/products/{storeSlug}No key

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.

products.mjsshellproducts.pyproducts.php
const res = await fetch("https://api.sellhidden.com/v1/public/products/my-store");const data = await res.json();
curl \  "https://api.sellhidden.com/v1/public/products/my-store"
import requestsres = requests.get("https://api.sellhidden.com/v1/public/products/my-store")data = res.json()
<?php$ch = curl_init('https://api.sellhidden.com/v1/public/products/my-store');curl_setopt_array($ch, [  CURLOPT_RETURNTRANSFER => true,]);$data = json_decode(curl_exec($ch), true);

Path and query · 4 fields

storeSlugstring · required

The store's slug, as in its address.

In the path

categorySlugstring · optional

Only products in this category.

limit1..100 · optional

Page size. Default 50.

cursorstring · optional

nextCursor from the previous page.

{
"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}No key

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

product.mjsshellproduct.pyproduct.php
const res = await fetch("https://api.sellhidden.com/v1/public/products/my-store/lifetime-license");const data = await res.json();
curl \  "https://api.sellhidden.com/v1/public/products/my-store/lifetime-license"
import requestsres = requests.get("https://api.sellhidden.com/v1/public/products/my-store/lifetime-license")data = res.json()
<?php$ch = curl_init('https://api.sellhidden.com/v1/public/products/my-store/lifetime-license');curl_setopt_array($ch, [  CURLOPT_RETURNTRANSFER => true,]);$data = json_decode(curl_exec($ch), true);

Path · 2 fields

storeSlugstring · required

The store's slug, as in its address.

In the path

slugstring · required

The product's slug.

In the path

{
"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}No key

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

categories.mjsshellcategories.pycategories.php
const res = await fetch("https://api.sellhidden.com/v1/public/categories/my-store");const data = await res.json();
curl \  "https://api.sellhidden.com/v1/public/categories/my-store"
import requestsres = requests.get("https://api.sellhidden.com/v1/public/categories/my-store")data = res.json()
<?php$ch = curl_init('https://api.sellhidden.com/v1/public/categories/my-store');curl_setopt_array($ch, [  CURLOPT_RETURNTRANSFER => true,]);$data = json_decode(curl_exec($ch), true);

Path · 1 field

storeSlugstring · required

The store's slug, as in its address.

In the path

{
"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}No key

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.

reviews.mjsshellreviews.pyreviews.php
const res = await fetch("https://api.sellhidden.com/v1/public/reviews/my-store");const data = await res.json();
curl "https://api.sellhidden.com/v1/public/reviews/my-store"
import requestsres = requests.get("https://api.sellhidden.com/v1/public/reviews/my-store")data = res.json()
<?php$ch = curl_init('https://api.sellhidden.com/v1/public/reviews/my-store');curl_setopt_array($ch, [  CURLOPT_RETURNTRANSFER => true,]);$data = json_decode(curl_exec($ch), true);

Path and query · 5 fields

storeSlugstring · required

The store's slug, as in its address.

In the path

productSlugstring · optional

Only reviews of this product.

rating1..5 · optional

Only this star rating.

limit1..100 · optional

Page size. Default 20.

cursorstring · optional

nextCursor from the previous page.

{
"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}No key

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.

recent-sales.mjsshellrecent-sales.pyrecent-sales.php
const res = await fetch("https://api.sellhidden.com/v1/public/recent-sales/my-store");const data = await res.json();
curl \  "https://api.sellhidden.com/v1/public/recent-sales/my-store"
import requestsres = requests.get("https://api.sellhidden.com/v1/public/recent-sales/my-store")data = res.json()
<?php$ch = curl_init('https://api.sellhidden.com/v1/public/recent-sales/my-store');curl_setopt_array($ch, [  CURLOPT_RETURNTRANSFER => true,]);$data = json_decode(curl_exec($ch), true);

Path and query · 2 fields

storeSlugstring · required

The store's slug, as in its address.

In the path

limit1..25 · optional

Page size. Default 10.

{
"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"
}
]
}
The API basicsKeys, scopes, errors and lists, for every call.AuthenticationScopesErrorsPagination
Sell with a Buy buttonTwo lines on any page, with the live price.Live priceCheckout links

OpenAPI 3.1

https://api.sellhidden.com/v1/openapi.json