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/pins | POST | Create a pin |
/v5/pins/{pin_id} | GET | Read pin data |
/v5/boards | GET | List boards |
/v5/boards | POST | Create a board |
OAuth2 Scopes Requested
| Scope | Purpose |
|---|---|
pins:read | Read pin performance data |
pins:write | Create pins |
boards:read | List existing boards |
boards:write | Create new boards |
user_accounts:read | Verify 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
- Email: scherbina.v@gmail.com
- Response time: Within 48 hours