Automate your listing mockups with the Scaylr API
Send one design, get back finished mockups on Scaylr's print-on-demand templates: T-shirts, hoodies, mugs, tumblers, posters, frames, totes and more. Made for Etsy and Shopify workflows, POD shops and the apps that serve them.
Free sandbox key · no card needed · same engine as the Scaylr studio
Who it's for
Automation freelancers
You build Make, Zapier or n8n workflows for Etsy and Shopify sellers. Add a step that turns each new design into a full set of listing mockups.
AI tools for sellers
Your app writes listings or makes designs for Etsy and Shopify sellers. Show your users their design on real product mockups, inside your app.
POD and personalised-gift shops
Many designs, many product types, many variants. One call puts a design on every template you sell, ready for your product pages.
Print shops
Show customers a preview of their upload on the product, with your own PSD templates or ours.
How it works
Get a key
Create a free Sandbox key in your Scaylr account. It works straight away.
Send a design and pick templates
Upload a PNG or JPEG (or give a link to it) and list up to 40 templates: library templates, your own PSDs, or a whole collection.
Get your mockups
Each template comes back as a JPEG link, usually within seconds. Poll the job or get a webhook when it is done, then send the images to your shop.
A short example
Two mockups from one design, in one request:
curl https://api.scaylr.io/api/batch/render \
-H "Authorization: Bearer $SCAYLR_KEY" \
-F design=@design.png \
-F 'request={"templates":["lib:white-mug-kitchen-counter",
"lib:white-tshirt-flat-lay-oak-floor"]}'
# then ask for the job until it is done:
curl https://api.scaylr.io/api/batch/jobs/JOB_ID \
-H "Authorization: Bearer $SCAYLR_KEY"
# → "status": "done", one "url" per template (JPEG, up to 2048 px)Examples in JavaScript and Python, every option and the webhook format are in the API docs.
What you get
- The studio's own engine. A mockup from the API looks exactly like the one the Scaylr studio makes, with mug and tumbler wraps, Fill / Fit / Stretch, size and position.
- Templates made for POD. The Scaylr library, plus your own uploaded PSDs and templates made with "Mockup from a photo", in the same API.
- Collections. Group templates in the studio once, then render the whole set with one id.
- Webhooks. Signed callbacks when a job is finished, on every plan except Sandbox.
- No surprise bills. When your renders run out, new jobs wait for next month or more credits. Failed renders are free.
Pricing
One render = one template with your design = one JPEG. On the monthly plans that is a fraction of a cent per render.
Sandbox
For testing. Watermark, at most 1,024 px, free library templates, 1 key.
API Starter
No watermark, every library template, webhooks, 2 keys.
API Growth
Everything in Starter, 5 keys, higher priority in the queue.
API Scale
Everything in Growth, 10 keys, the highest queue priority.
Pay as you go
No monthly fee: buy credits when you need them. Credits never expire and give clean renders on every library template.
| Credit pack | Price | Per render |
|---|---|---|
| 1,000 renders | $20 | 2 ¢ |
| 5,000 renders | $75 | 1.5 ¢ |
| 25,000 renders | $250 | 1 ¢ |
On a monthly plan, the plan's renders are used first, then your credits. Prices in US dollars.
FAQ
Can I use the mockups in my customers' listings?
Yes, on paid API plans and pay as you go. Mockups made with Scaylr library templates may be used in your own product listings and in your customers' product listings, shops, ads and social media. Your app must not let people download the template files or rebuild the template library, and the mockups may not be sold as stock images. The details are in the API terms.
Do I get the template files?
No. The API sends back finished JPEG mockups. Library template files are never handed out, and PSDs bought in the Scaylr shop can only be used by the account that bought them.
Can I use my own PSD templates?
Yes. PSDs you upload to My templates in the Scaylr studio, and templates you make with Mockup from a photo, can be rendered through the API. They stay private to your account. Own PSDs need an active Scaylr Starter or Pro studio plan. You are responsible for having the rights to the designs and PSDs you upload.
What is the Sandbox for?
Testing your integration. It is free, includes 100 renders a month on the free library templates, and puts a watermark on renders that are at most 1,024 px. Use a paid plan or credits for mockups you publish.
How long are the mockups kept?
30 days. Result links are deleted 30 days after the job was made, so copy the images to your shop or storage. Your uploaded design is deleted as soon as the job finishes.
Do failed renders count?
No. Only finished mockups count toward your renders. When your renders run out, new jobs are refused until next month or until you add credits, so there are no surprise bills.
Will every PSD work?
The API renders with Scaylr's own engine. If one of your own PSDs uses a Photoshop feature the engine doesn't support yet, that one mockup fails with a message saying so (and doesn't count), and the rest of the job still renders.
How do I get help?
Email info@scaylr.io (with the job id if it's about a render). We reply within 24 hours.