SStock Hunter

Vendor alerts

Put your stock drops directly in front of collectors.

Create a developer application, choose the exact category and region for each feed, then send a small JSON event whenever stock changes. Stock Hunter handles alert matching, push delivery, and inbox history for users who subscribed to that category.

1

Create app

Use Developer Community to get your client ID and secret.

2

Choose routing

Pick the category and region users will subscribe to.

3

Send events

POST simple JSON to the endpoint generated below.

Create an alert endpoint

One endpoint maps to one vendor, category, and region. Create multiple endpoints if you need separate routing for Pokemon AU, One Piece UK, Watches US, and so on.

Your vendor endpoints

Send stock events with Basic auth using `clientId:clientSecret`, or headers `x-client-id` and `x-client-secret`.

Sign in from the header to manage endpoints.

No vendor endpoints yet.

On-demand vendors

Submit a stock-check endpoint

On-demand endpoints are called when a user checks stock manually. They must respond quickly with product availability in the simple structure shown here. Approved vendors appear as selectable sources in the app.

On-demand response contract

We POST JSON containing `requestType`, `vendor`, `configuration`, and `items`. Return `results[]` where each result has `sku`, `itemName`, and `locations[]`. Empty `locations` means no stock found for that item.

Full docs
{
  "results": [
    {
      "sku": "example-booster-box",
      "itemName": "Pokemon TCG Example Booster Box",
      "locations": [
        {
          "storeName": "Online",
          "stockLevel": 24,
          "address": "https://your-store.example/products/example-booster-box"
        },
        {
          "storeName": "Melbourne CBD",
          "stockLevel": 6,
          "phoneNumber": "+61 3 9000 0000",
          "address": "123 Example St, Melbourne VIC",
          "coordinates": {
            "lat": -37.8136,
            "lng": 144.9631
          }
        }
      ]
    }
  ]
}

Your on-demand submissions

No on-demand vendor submissions yet.