A Pinterest pin generator is one vertical template filled once per product. jsontoimg places the product photo, title, and price on named layers and returns a PNG or JPG per row. It fits catalogs where the layout is constant and the data changes: shops, recipe sites, listings.
Layers that change per pin
title: the product or post namepriceortag: a short text such as “From $24” or “New”photo: a publichttpsimage URL ending in.png,.jpg,.jpeg, or.webpcta: constant text can stay in the design
One pin per row
{
"template": "<design-id>",
"format": "jpg",
"layers": {
"title": { "text": "Ceramic pour-over set" },
"price": { "text": "From $24" },
"photo": { "image_url": "https://example.com/products/pour-over.jpg" }
}
}Send up to 50 of these in one batch with POST /api/v1/renders/batch. A catalog of 1,000 products is twenty batches. Each job carries its own webhookUrl option if you want a callback per pin, and failed jobs do not use credits.
Sizing
Design the template in the vertical ratio Pinterest’s current guidelines name for your account and test a few pins before the full run. Specs change, so keep the size as a template property, not something hard-coded in your pipeline.
Refresh on a price change
When a price changes, send the new value and render again. A new payload produces a new image; identical values return the stored file, which saves credits on unchanged rows. The same catalog-to-image pattern is described on the product banners page.
What it does not do
jsontoimg does not publish pins. It returns a file or a signed URL, and you post it with your own tool or an automation such as n8n. It also does not write pin descriptions or choose keywords.
Related
FAQ
What is a Pinterest pin generator?
A tool that builds pin images from a template and per-product data. jsontoimg fills the title, price, and product photo on named layers and returns a PNG or JPG.
How do I generate pins for a whole catalog?
Send batches of 50 jobs to POST /api/v1/renders/batch, one job per product row. A 1,000-product catalog takes twenty batches.
Does jsontoimg publish to Pinterest?
No. It returns an image file or signed URL. Publish with your own script or an automation tool.
What happens when a product price changes?
Send the new price and render again. A changed payload produces a new image, while identical values return the stored file.