Your catalogue, wherever it needs to go.
Everything the interface does, the API does too. Catalogues, portals and shops read approved content per channel; ERPs and middleware write by SKU.
A public read API per channel.
Each channel is served to the integrations that hold it: only approved and published content, cut to the channel's attributes and languages, page by page.
- Access
- An API key of an integration that holds the channel
- Content
- Approved and published only, with each language's fallback applied
- Change feed
- Read only what changed since a cursor, so nothing is missed
- Contract
- Every operation is described in an OpenAPI contract
Webhooks that say what changed.
Instead of polling, your server is told when a channel changes, then reads the content from the feed.
- Signing
- Standard Webhooks, HMAC-SHA256, with secret rotation
- Content
- Up to 100 feed entries per call, never product values
- Retries
- For about 21 hours, then an email to the administrators
- Delivery log
- Seven days, with resend and the state of each channel
- Addresses
- HTTPS only; private and internal addresses are refused
Write by SKU from your ERP.
ERP systems and middleware write through the same API, with keys that carry their own roles.
- Batch write
- Up to 1,000 products and variants per request, with a result per item
- Safe retries
- An Idempotency-Key header makes a repeated request harmless
- Limits
- 120 requests a minute per key
- ERP connector
- In preparation
Files, when that is what you have.
Not every system speaks an API. Excel and CSV files come in and go out on a schedule.
- Upload address
- Another system sends files to an address with its own credential
- SFTP
- Files fetched from your server at set times, after its host key is confirmed
- Mapping profiles
- Saved once, applied to every file of the same shape
- Export
- Excel or CSV of any grid view
- ETIM and ECLASS, BMEcat
- In preparation
The public read API, path by path.
Every path is under one channel, so a key only ever reads what that channel publishes.
- GET
/The channel, its languages and its feed positionpublic/ v1/ channels/ {channel} - GET
/Published products, page by pagepublic/ v1/ channels/ {channel}/ products - GET
/One product by SKUpublic/ v1/ channels/ {channel}/ products/ {sku} - GET
/Product models and their variantspublic/ v1/ channels/ {channel}/ models - GET
/The category treepublic/ v1/ channels/ {channel}/ categories - GET
/Attributes and their optionspublic/ v1/ channels/ {channel}/ attributes - GET
/Reference entities, such as brandspublic/ v1/ channels/ {channel}/ records/ {type} - GET
/Images and documents with their linkspublic/ v1/ channels/ {channel}/ media/ {media} - GET
/The change feed, from a cursorpublic/ v1/ channels/ {channel}/ changes
Send us a spreadsheet. We'll show you what it's missing.
A 30-minute demo with a sample of your own catalogue, or a 30-day trial in a workspace of your own.
Or write to hello@itemspring.com
Priced by catalogue size, with every user, channel and language included. See pricing