---
title: "Pinterest Pin Generator API: 1000x1500 Vertical Pins"
description: "Render shoppable pins with the Pinterest pin generator API. POST title, eyebrow, and brand inputs as JSON, get back a 1000x1500 (2:3) PNG ready to publish."
url: "https://html2img.com/templates/pinterest-pin/"
---

# Pinterest Pin Generator API

Send title and metadata as JSON, get back a 1000x1500 (2:3) PNG sized for Pinterest standard pins.

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.

## At a glance

- **Template slug:** `pinterest-pin`
- **Category:** social
- **Endpoint:** `POST https://app.html2img.com/api/v1/templates/pinterest-pin`
- **Authentication:** `X-API-Key` header
- **Cost:** one credit per render, PNG or PDF
- **Page:** https://html2img.com/templates/pinterest-pin/

## Fields

| Field | Type | Required | Example |
| --- | --- | --- | --- |
| `title` | string | Yes | 15 cozy reading nooks for tiny apartments |
| `subtitle` | string | No | Maximize every square foot with these layouts. |
| `eyebrow` | string | No | HOME GUIDE |
| `site_name` | string | No | smallspaces.co |
| `background_image_url` | url | No | https://picsum.photos/seed/pinterest-pin/1000/1500 |
| `logo_url` | url | No |  |
| `background_color` | string | No | #FFF7ED |
| `accent_color` | string | No | #E11D48 |

## Defaults

| Field | Default |
| --- | --- |
| `width` | 1000 |
| `height` | 1500 |

## Example request

```bash
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"}'
```

## In your language

### PHP

```php
<?php
$response = \Illuminate\Support\Facades\Http::withHeaders([
    'X-API-Key' => 'YOUR_API_KEY',
])->post('https://app.html2img.com/api/v1/templates/pinterest-pin', ['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']);

$url = $response->json('url');
```

### Node.js

```javascript
const response = await fetch('https://app.html2img.com/api/v1/templates/pinterest-pin', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "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"
}),
});

const { url } = await response.json();
```

### Python

```python
import requests

response = requests.post(
    'https://app.html2img.com/api/v1/templates/pinterest-pin',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    json={'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'},
)

url = response.json()['url']
```

## What it is for

### E-commerce stores generating shoppable pins from catalog

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 sites pinning each post

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.

### Blogs creating pinnable graphics for every article

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.

### Course creators promoting modules

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.

### Real estate listings reaching home-search audiences

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.

## Output

- **Dimensions:** 1000x1500
- **Colour space:** sRGB
- **Transparency:** Not supported
- **Typical file size:** 80 KB to 280 KB
- **Platform specification:** [Pinterest standard pin specification (2:3)](https://help.pinterest.com/en/business/article/pinterest-product-specs)

## Common mistakes

### Square pins underperform compared to 2:3

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.

### Very tall pins truncate in feed

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.

### Text on busy backgrounds disappears

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.

## Questions

### 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.

## Preview

![Pinterest Pin Generator API example render](https://i.html2img.com/image-1777560101950-663894.png)

## Related templates

- [instagram-square-post](https://html2img.com/templates/instagram-square-post/)
- [open-graph-image](https://html2img.com/templates/open-graph-image/)
- [twitter-post](https://html2img.com/templates/twitter-post/)

## See also

- [Every template](https://html2img.com/templates/)
- [Templates API reference](https://html2img.com/docs/templates/)
- [OpenAPI specification](https://html2img.com/openapi.json)