SynthSketchShop — Etsy App Details
This page describes how SynthSketchShop interacts with the Etsy marketplace through the official Etsy Open API v3.
App Name
SynthSketchShop Listing Manager
Purpose
SynthSketchShop is a listing management tool for our own Etsy shop. It automates the creation and publishing of digital art listings from AI image generation through SEO optimization to final publication.
This is a single-shop tool used exclusively by the SynthSketchShop store owner to manage their own listings. It is not a multi-tenant platform or a service offered to other Etsy sellers.
What the App Does
1. Creates Listing Drafts
The app generates complete listing drafts including:
- SEO-optimized titles (keyword-researched)
- 13 searchable tags per listing
- Detailed descriptions with AI disclosure
- Pricing and category assignment
- Digital download configuration
2. Uploads Images
For each listing, the app uploads:
- Up to 7 product preview images (room mockups, size previews)
- One ZIP archive containing all digital files for buyer download
3. Publishes Listings
The app transitions drafts to active listings through the Etsy API, setting the listing type to "digital download" with instant delivery.
4. Reads Listing Data
The app reads existing listings to:
- Verify successful publication
- Avoid duplicate listings
- Track listing status (draft, active, sold)
API Endpoints Used
| Endpoint | Method | Purpose |
|---|---|---|
/v3/application/shops/{shop_id}/listings |
POST | Create listing draft |
/v3/application/shops/{shop_id}/listings/{id} |
PATCH | Update listing |
/v3/application/shops/{shop_id}/listings/{id}/images |
POST | Upload preview images |
/v3/application/shops/{shop_id}/listings/{id}/files |
POST | Upload digital file (ZIP) |
/v3/application/shops/{shop_id}/listings |
GET | Read listings |
OAuth2 Scopes Requested
| Scope | Purpose |
|---|---|
listings_r | Read listings for verification |
listings_w | Create and update listings |
listings_d | Delete listings if needed |
Data Handling
Data We Access
- Shop ID (to identify our shop)
- Listing metadata (titles, tags, descriptions, prices, status)
- Image URLs (uploaded by us)
Data We Store
- Listing IDs and metadata (for tracking and audit)
- API call logs (for debugging, retained 30 days)
Data We Do NOT Access
- Customer names, emails, or addresses
- Transaction or payment details
- Private messages or conversations
- Other sellers' data
- Etsy account credentials (OAuth2 only)
Workflow
1. Trend Research
└─ Discover trending keywords from public sources
2. Image Generation
└─ Generate AI artwork from original prompts (DALL-E)
3. Quality Control
└─ Review, curate, and refine images
4. Package Creation
└─ Export to multiple print sizes (5x7 through 20x30)
└─ Generate JPG + PDF for each size
└─ Create room mockups for preview
└─ Package all files into ZIP archive
5. Listing Draft
└─ Generate title, tags, description via SEO analysis
└─ Create draft via Etsy API
6. Upload Files
└─ Upload preview images via Etsy API
└─ Upload ZIP digital file via Etsy API
7. Publish
└─ Set listing type to "digital download"
└─ Transition from draft to activeCompliance
- AI Disclosure: Every listing includes disclosure that artwork was created with AI assistance, per Etsy's Creativity Standards
- Original Content: All prompts are written by us, never copied or purchased from third parties
- No Spam: Listings are published at a natural cadence (1-2 per day), never bulk-uploaded
- No Scraping: All data access goes through the official API
- Rate Limits: The app respects all Etsy API rate limits
- Single Shop: This app manages only the SynthSketchShop store
Security
- OAuth2 authentication — we never store Etsy passwords
- All API calls use HTTPS
- Tokens are encrypted at rest
- Access can be revoked at any time from Etsy account settings
Support
- Email: scherbina.v@gmail.com
- Response time: Within 48 hours