Skip to main content

Pinterest API Guide

Create and schedule Pins to Pinterest boards. PostEverywhere handles pin creation, image uploads, and board targeting so you can publish visual content alongside your other social platforms in a single API call. For a general overview of all supported platforms, see the Introduction.

Supported Content Types​

Content TypeMedia RequiredDescription
Image PinImageStandard Pin with an image, title, description, and optional destination link.

Pinterest is an image-first platform. Every Pin requires at least one image attachment.

Platform-Specific Settings​

Use the platform_content.pinterest object to customise your Pin:

{
  "platform_content": {
    "pinterest": {
      "content": "Pin description with keywords",
      "settings": {
        "title": "Pin Title",
        "link": "https://example.com/page",
        "boardId": "board-id-from-your-account"
      }
    }
  }
}

Settings Reference​

SettingTypeDefaultDescription
contentstring—Pin description. Used for search discovery on Pinterest. Include relevant keywords naturally.
settings.titlestring—Pin title displayed above the image. Max 100 characters.
settings.linkstring—Destination URL. When users click the Pin, they are directed to this URL.
settings.boardIdstring—The Pinterest board to pin to. If omitted, the Pin is saved to your profile's default board.

Example: Create a Post​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Default text for other platforms",
    "account_ids": [2300],
    "media_ids": ["f2a3b4c5-d6e7-8901-2345-f01234567890"],
    "scheduled_at": "2026-04-16T09:00:00Z",
    "timezone": "America/New_York",
    "platform_content": {
      "pinterest": {
        "content": "10 social media scheduling tips for small businesses. Save this for later and visit our blog for the full guide.",
        "settings": {
          "title": "10 Social Media Scheduling Tips for 2026",
          "link": "https://example.com/blog/scheduling-tips"
        }
      }
    }
  }'

Schedule a Pin to a Specific Board​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "New recipe posted!",
    "account_ids": [2300],
    "media_ids": ["a3b4c5d6-e7f8-9012-3456-012345678901"],
    "scheduled_at": "2026-04-16T11:00:00Z",
    "timezone": "America/Los_Angeles",
    "platform_content": {
      "pinterest": {
        "content": "Easy 30-minute weeknight dinner recipe. Creamy garlic pasta with roasted vegetables. Perfect for busy families. Full recipe on the blog.",
        "settings": {
          "title": "30-Minute Creamy Garlic Pasta",
          "link": "https://example.com/recipes/garlic-pasta",
          "boardId": "your-recipes-board-id"
        }
      }
    }
  }'

Cross-Post to Pinterest and Instagram​

curl -X POST https://app.posteverywhere.ai/api/v1/posts \
  -H "Authorization: Bearer $POSTEVERYWHERE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "New product just dropped!",
    "account_ids": [2280, 2300],
    "media_ids": ["b4c5d6e7-f8a9-0123-4567-123456789012"],
    "scheduled_at": "2026-04-17T10:00:00Z",
    "timezone": "UTC",
    "platform_content": {
      "instagram": {
        "content": "NEW: Our spring collection just dropped! Link in bio 🛍\n\n#newcollection #spring2026 #fashion",
        "settings": {
          "firstComment": "#style #outfitinspo #shopnow #newarrivals"
        }
      },
      "pinterest": {
        "content": "Spring 2026 collection now available. Shop the latest styles with free shipping over $50.",
        "settings": {
          "title": "Spring 2026 Collection",
          "link": "https://example.com/shop/spring-2026"
        }
      }
    }
  }'

Requirements & Limits​

RequirementLimit
Pin description length500 characters
Pin title length100 characters
Image formatsJPEG, PNG, WebP
Image max file size20 MB
Recommended image ratio2:3 (1000x1500 px)
Minimum image width600 px
Maximum image ratio1:2.1 (very tall images may be cropped)
Link URLMust be a valid HTTPS URL

Tips​

  • Use 2:3 vertical images (1000x1500 px). Pinterest is a vertical-scrolling platform. Taller images take up more space in the feed, which means more visibility. The ideal ratio is 2:3 — wide or square images get less engagement.
  • Write keyword-rich descriptions. Pinterest functions as a visual search engine. Include relevant keywords naturally in your Pin description (not hashtags — Pinterest uses natural language search, not hashtag discovery). Think about what someone would search for to find your content.
  • Always include a destination link. Pinterest is one of the best platforms for driving website traffic. Every Pin should link to a relevant page — a blog post, product page, or landing page. Pins without links are missed opportunities for conversion.

Frequently Asked Questions​

How do I pin to a specific Pinterest board?​

Set settings.boardId in the platform_content.pinterest object when creating a post. If you omit boardId, the Pin is saved to your profile's default board. You can find board IDs by listing your connected Pinterest account's boards via the API.

Does Pinterest support video Pins via the API?​

Currently, the PostEverywhere API supports image Pins only for Pinterest. Upload an image (JPEG, PNG, or WebP, up to 20 MB) using the Upload Media endpoint. For best results, use vertical 2:3 images (1000x1500 px).

Should I use hashtags in Pinterest descriptions?​

No. Unlike Instagram or TikTok, Pinterest uses natural language search rather than hashtag discovery. Write keyword-rich descriptions that read naturally. Think about what someone would type into Pinterest search to find your content, and include those phrases in your description.

Can I cross-post the same image to Pinterest and Instagram in one API call?​

Yes. Include both account IDs in the account_ids array and use platform_content to customize the caption for each platform. See the cross-posting example above for a complete request that posts to both Instagram and Pinterest simultaneously.

  • Instagram -- visual-first platform ideal for cross-posting image content
  • Facebook -- image and link sharing for broader social reach
  • LinkedIn -- PDF carousels and image posts for professional audiences

Further Reading​