Developers
One API, and a sandbox to build against first
The Product Catalogue API publishes and maintains your products. It takes a flat product file with only a few mandatory fields, so you are not made to restructure your data before you can send it.
Send your catalogue in the shape it is already in.
Your shape, not ours
No imposed category tree and no product taxonomy to adopt. You publish against your own product identifier and MasterDB adds its own alongside it.
Sandbox first
Separate credentials for sandbox and live. The sandbox is an isolated product store, so you can build and test before your business is verified.
Batch upserts
Send changes as they happen, or send a batch. A batch upsert is a single request, and nothing is deleted unless you delete it.
Reference
The shape of it
| Method | Path | What it does |
|---|---|---|
| POST | /products | Create or update products. A batch counts as one request. |
| GET | /products | List the products you have published. |
| GET | /products/{id} | Retrieve one product by your own product identifier. |
| DELETE | /products/{id} | Remove one product from your published catalogue. |
| GET | /push-events | The record of what you sent, when, and what happened to it. |
Authentication
Every request carries a bearer token. You hold one credential for the sandbox and one for live, both managed in the Business Portal, where either can be regenerated. The live credential is inactive until your business is verified, because publishing with it makes your catalogue retrievable.
Rate limits
Requests are limited per credential. A batch upsert counts as one request, so publishing a large catalogue is a small number of large requests rather than the reverse.
Push activity
Everything you send is recorded: what arrived, what was created, what was updated, and what was rejected and why. That record is readable through the API and visible in the portal, so a failed publish is never silent.
If you would rather not write code
You do not have to use the API at all. A catalogue can be imported from a file, with your own column layout saved for the next import, or products can be entered directly in the portal.
Full documentation
The complete reference, with request and response bodies, the product schema, error codes and a quickstart, is published at docs.masterdb.ai and opens with the closed beta.
Ensure AI users receive accurate authorised information about your business, your brand and your products & services.
MasterDB opens to a closed group of businesses first. Publishing is completely free. Apply now and we will be in touch with your access.