API Integration

SynthSketchShop — Pinterest App Details

This page describes how SynthSketchShop interacts with Pinterest through the official Pinterest API v5.

App Name: SynthSketchShop Pin Publisher Scope: Single-account internal tool API: Pinterest API v5

SynthSketchShop — Pinterest App Details

This page describes how SynthSketchShop interacts with Pinterest through the official Pinterest API v5.

App Name

SynthSketchShop Pin Publisher

Purpose

SynthSketchShop uses the Pinterest API to promote digital art products from our Etsy shop by creating pins that link directly to Etsy listings.

This is a single-account tool used exclusively by the SynthSketchShop business account owner. It is not a multi-user platform or a service offered to other Pinterest users.

What the App Does

1. Creates Pins

For each published Etsy listing, the app creates a Pinterest pin containing:

  • Product image (2:3 ratio, 1000x1500px)
  • Keyword-optimized title and description
  • Direct link to the Etsy listing URL
  • Relevant hashtags (8-10 per pin)

2. Manages Boards

The app organizes pins into themed boards matching product categories:

  • "Botanical Wall Art"
  • "Minimalist Prints"
  • "Seasonal Decor"
  • And similar topic-based boards

3. Tracks Performance

The app reads basic pin analytics to understand which designs and keywords perform best:

  • Pin impressions
  • Click-through rates
  • Save counts

API Endpoints Used

Endpoint Method Purpose
/v5/pinsPOSTCreate a pin
/v5/pins/{pin_id}GETRead pin data
/v5/boardsGETList boards
/v5/boardsPOSTCreate a board

OAuth2 Scopes Requested

Scope Purpose
pins:readRead pin performance data
pins:writeCreate pins
boards:readList existing boards
boards:writeCreate new boards
user_accounts:readVerify account connection

Data Handling

Data We Access

  • Board names and IDs (to organize pins)
  • Pin metadata (titles, descriptions, image URLs)
  • Basic pin analytics (impressions, clicks, saves)

Data We Store

  • Pin IDs (to track which listings have been promoted)
  • Board IDs (to organize future pins)
  • API call logs (for debugging, retained 30 days)

Data We Do NOT Access

  • Private messages
  • Follower or following lists
  • Other users' account data
  • Pinterest account credentials (OAuth2 only)
  • User profile information beyond basic account verification

Posting Behavior

  • Frequency: 1-2 pins per day maximum
  • No bulk posting: Pins are spaced throughout the day
  • Natural cadence: Mimics organic user behavior
  • All pins link to real products: Every pin links to an active Etsy listing with a real product for sale
  • No clickbait: Titles and descriptions accurately represent the linked product

Workflow

1. Etsy Listing Published
   └─ New digital art listing is live on Etsy

2. Pin Image Prepared
   └─ Product image formatted for Pinterest (2:3 ratio)

3. Pin Content Generated
   └─ Title: keyword-optimized, 40-100 characters
   └─ Description: product details + relevant hashtags
   └─ Link: direct URL to Etsy listing

4. Pin Created
   └─ Pin posted to appropriate themed board via API

5. Performance Tracked
   └─ Analytics read periodically to optimize future pins

Compliance

  • Legitimate Links: All pins link to real, active Etsy listings
  • No Spam: Maximum 1-2 pins per day, naturally distributed
  • No Bot Behavior: No bulk actions, no automated engagement (no auto-follow, no auto-like, no auto-comment)
  • No Data Harvesting: We do not scrape, store, or resell Pinterest user data
  • No Misleading Content: Pin images and descriptions match the linked product exactly
  • Content Policy: All pinned content complies with Pinterest Community Guidelines
  • User Consent: Only the account owner authorizes API access; no actions taken on behalf of other users

Security

  • OAuth2 authentication — we never store Pinterest passwords
  • All API calls use HTTPS
  • Tokens are encrypted at rest
  • Access can be revoked at any time from Pinterest account settings

Support