Send title and metadata as JSON, get back a 1000x1500 (2:3) PNG sized for Pinterest standard pins.
Prefer to try it in your browser first? Open the Pinterest Pin tool.
E-commerce shops and content publishers use the Pinterest pin generator API to ship one branded pin per blog post, recipe, or product without designing each in Canva. The 2:3 portrait ratio is the format Pinterest documents and rewards in feed distribution. You post the title, eyebrow text, and brand inputs as JSON, and the response holds a PNG ready to upload via the Pinterest API or schedule with Tailwind.
curl -X POST https://app.html2img.com/api/v1/templates/pinterest-pin \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"title":"15 cozy reading nooks for tiny apartments","subtitle":"Maximize every square foot with these layouts.","eyebrow":"HOME GUIDE","site_name":"smallspaces.co","background_image_url":"https://picsum.photos/seed/pinterest-pin/1000/1500","background_color":"#FFF7ED","accent_color":"#E11D48"}'
A single cURL call to render a Pinterest Pin as a PNG. Add "format": "pdf" to the payload to get a PDF instead. For the full PHP, Node and Python equivalents, plus every input the template accepts, see the
Pinterest Pin API reference.
Setting up your key is covered in the
authentication guide.
View the Pinterest Pin API reference: inputs, defaults, error responses and cURL, PHP, Node and Python code samples. Read the docs.
Stores selling visually rich products (home decor, fashion, gifts) benefit from one pin per product with the price visible. Pull the catalog, render a pin per item with the product photo as background_image_url, and upload via the Pinterest API. Riverside Bakery's sister homewares brand pins 80 products per quarter through this flow, and the pins drive 3x more traffic than the previous era of pinning Instagram squares.
Recipe blogs perform exceptionally well on Pinterest, where users actively search for cooking inspiration. Render a pin per recipe with the dish title, prep time, and a hero food photo, post on publish, and the pin earns repins over months rather than dying in a week. Northwind Weekly's recipe section pins every post and the long-tail Pinterest traffic is now the second-largest organic source.
Lifestyle and how-to blogs pinning every published post benefit from consistent vertical artwork rather than borrowing the horizontal blog hero. Render a 2:3 pin per post with the article title and category badge, attach to the post via a "Pin this" widget, and visitors share at higher rates. Halberd Software's technical blog tested this on 60 posts and saw a 4x lift in Pinterest-sourced traffic.
Online course platforms reach a different audience on Pinterest than on LinkedIn or X, particularly for skills like graphic design or photography. Render a pin per course module with the module title and the course logo, schedule across the course launch window, and inbound enrollments climb from a previously underused channel. Linden & Co's photography course gained 240 students in the first month after rolling out Pinterest-specific pins.
Pinterest is a popular research surface for home buyers, particularly in the year before they purchase. Render a 2:3 pin per active listing with the price, the address, and a hero photo, and the listings reach a buyer audience that does not use Zillow or MLS sites. Wren Analytics' real estate clients pin every active listing and report measurable agent inquiries from Pinterest within 30 days.
Matches the spec at Pinterest standard pin specification (2:3).
These specifications describe the default PNG output. The template can also return a PDF document with selectable text through the HTML to PDF API: set format to pdf in the request. See the format parameter docs for how PDF output behaves.
POST to the template endpoint with the values you want rendered. Authenticate with your API key.
The template is rendered server-side as a 1000x1500 PNG, or as a PDF document if you set format to pdf.
Cache it, embed it in your page, attach it to an email.
Pinterest accepts 1:1 squares but the algorithm rewards 2:3 portrait with broader feed distribution. Stick to the 1000x1500 default rather than reusing a square Instagram graphic, since the platform deliberately favors the vertical format in its feed ranking.
Pins taller than 2:3 (for example 1000x2100) get truncated in the home feed and lose the bottom portion of the design. Stick to 1000x1500 unless you specifically design for the tall search-result variant, since most feed traffic comes through the standard surface.
Photographic backgrounds without an overlay reduce the readability of overlaid copy. The template applies a configurable overlay opacity over background_image_url, so titles read regardless of the photo. Tune the overlay if your photos are unusually dark or light.
A quick summary of what the Pinterest Pin template accepts. The full reference, with example values and array shapes, is in the docs.
| Name | Type | Required |
|---|---|---|
title | string | Required |
subtitle | string | Optional |
eyebrow | string | Optional |
site_name | string | Optional |
background_image_url | url | Optional |
logo_url | url | Optional |
background_color | string | Optional |
accent_color | string | Optional |
See the full inputs reference for descriptions, examples and validation rules.
Other templates in the social media category.
Bold share images sized for Facebook feed posts
Bold square images sized for the Instagram feed
Vertical 9:16 covers for Instagram and TikTok stories
Polished share images sized for LinkedIn feed posts
Render a tweet-style card from supplied data — avatar, body, image, metrics
Generate share-ready images sized for Twitter/X posts
High-contrast 16:9 thumbnails optimized for click-through
A starting point from each of the other two template categories.
See the full template gallery for every design grouped by category.
What size should a Pinterest pin be?
Use 1000x1500 (2:3 portrait). This is the format Pinterest documents and rewards in feed distribution. The template renders this size by default and the resulting file uploads cleanly via the Pinterest API. Client-facing mood boards can request format: "pdf" to get the pin as an A4 document; the Pinterest upload itself takes the PNG.
Are square pins supported?
Pinterest accepts square 1:1 pins but they perform worse than 2:3 portrait in feed distribution. The platform actively prefers vertical pins in its ranking algorithm. Stick to 2:3 unless you have a specific reason to depart.
What about Idea Pins?
Idea Pins are vertical 1080x1920 video-style content with multiple frames. This template renders single static pins. For Idea Pins, you render multiple frames separately and assemble them in the Pinterest creator tools.
Can Pinterest crawl the title and description?
Yes, set Pinterest-specific meta tags (or Open Graph tags) on the destination URL. Pinterest reads them when a user pins from your page. The pin image carries no metadata itself, so the destination page is where SEO and discoverability live.
Will rich pins work?
Rich pins read structured data (schema.org Product, Recipe, Article) from the destination URL, not from the pin image. Make sure your destination page has the correct structured data, and the pin will inherit the rich-pin treatment automatically.
Should I batch-pin?
Pinterest rate-limits aggressive posting and can flag accounts that pin hundreds of fresh items in one session. Use the official Pinterest API and respect their published rate limits. Most teams space pin uploads across the day with a scheduling tool like Tailwind.
25 renders a month on the free tier. See the pricing page for higher-volume plans.