Live stock, product data and tiered pricing from GSMPlus, straight into your own system: as JSON, XML, CSV or a ready-made Excel stock list.
One dataset, four formats. Pick whatever fits your environment: no functionality is lost between formats.
Full list, or a single item via ?sku=. For your own applications and scripts.
For systems that only read XML feeds.
Opens directly in Excel or imports into an ERP.
A formatted stock list, same layout as our regular export.
This is what the same data looks like in the live stock widget on gsmplus.nl. Via /v1/stock you get exactly these rows as JSON.
Every request to /v1/* requires your personal API key in the X-API-Key header. Without a valid key you'll get a 401 back.
# example: fetch the stock list curl https://api.gsmplus.nl/v1/stock \ -H "X-API-Key: your-api-key"
Four read-only endpoints on the same underlying stock, plus a health check that needs no authentication.
All items released for the API. Add ?sku=<sku> to get a single item back.
{
"products": [
{
"sku": "MUVV3ZM/A",
"ean": "0195949121296",
"title": "Apple 20W USB-C Power Adapter",
"brand": "Apple",
"category": "Chargers",
"price": 18.00,
"stock": 85,
"price 100+": 18.00,
"price 20+": 18.90,
"price 1+": 20.70
}
]
}
Same fields as /v1/stock, as an XML document. Field order matches the real response: price comes before stock, then the three tiers.
<?xml version='1.0' encoding='UTF-8'?>
<products>
<product>
<sku>MUVV3ZM/A</sku>
<ean>0195949121296</ean>
<title>Apple 20W USB-C Power Adapter</title>
<brand>Apple</brand>
<category>Chargers</category>
<price>18.0</price>
<stock>85</stock>
<price_100_>18.0</price_100_>
<price_20_>18.9</price_20_>
<price_1_>20.7</price_1_>
</product>
</products>
Same data, comma-separated. Opens directly in Excel or imports into an ERP package.
A formatted Excel stock list. May take a few seconds since the file is built per request.
Connectivity check, no API key needed. Returns {"status":"ok"}, a good first test.
Each item comes with the commercial fields, a base price and three tiered prices, never purchase prices or our internal IDs.
| Field | Type | Description |
|---|---|---|
| sku | string | Item number, the key for ?sku= |
| ean | string | EAN / barcode |
| title | string | Product name |
| brand | string | Brand |
| category | string | Product category |
| price | number | Base price, same value as price 100+ |
| stock | number | Current available quantity |
| price 100+ | number | Price when buying 100 units or more |
| price 20+ | number | Price when buying 20 to 99 units |
| price 1+ | number | Price when buying 1 to 19 units |
Standard is 60 requests per minute per API key. Need more? Get in touch, this is configurable per client.
| Tier | Limit | Who it's for |
|---|---|---|
| Standard | 60 / min | Every new client |
| Custom | by arrangement | High volume or real-time syncing |
| Status | Meaning | Action |
|---|---|---|
| 200 | OK | Request succeeded |
| 401 | Missing/invalid key | Check the X-API-Key header |
| 403 | Insufficient permissions | Get in touch to extend your key's scope |
| 404 | SKU not found | Item doesn't exist or isn't released for the API |
| 502 | Stock list service error | Only on /v1/stocklist.xlsx, retry or use /v1/stock.csv |
From request to first successful call in four steps.
Email it@gsmplus.nl to request access.
You'll get a personal key through a secure channel. It's shown once, so save it straight into your own password manager.
Start with /health (no key needed), then test /v1/stock with your key. See the examples above.
Pick the format that fits your system and pull the tiered pricing and stock into your own price list or webshop.
Questions about integrating, need a higher rate limit, lost your key, or want to request access to the Stock API? We're happy to help.