The term "Etsy" is a trademark of Etsy, Inc. This application uses the Etsy API but is not endorsed or certified by Etsy, Inc.
Etsy Product Workflows
PinBuilds helps Etsy sellers promote their own active listings on Pinterest. Sellers create an Etsy Shop profile, import public active listings through Etsy Open API v3 when available, select the products they want to promote, generate product-aware Pinterest pins, and schedule those pins to Pinterest.
PinBuilds is a seller marketing tool. It does not create, edit, or delete Etsy listings in the public PinBuilds workflow.
What Sellers Can Do
With an Etsy Shop profile, sellers can:
- Add an Etsy shop URL such as
https://www.etsy.com/shop/ShopName. - Import public active listing URLs, titles, listing metadata, and product context.
- Select one product, several products, or the full imported product list.
- Generate product-aware image pins optimized for Pinterest's 2:3 format.
- Use the profile's default pin count, image styles, and text overlay settings.
- Edit generated pin titles, descriptions, keywords, and destination URLs before scheduling.
- Schedule pins directly to connected Pinterest boards or export the generated content.
Shopify and Etsy product profiles use Image pins automatically because product listings usually need product-focused visuals rather than infographics.
Etsy Data PinBuilds Uses
PinBuilds uses only the listing data needed to build a product-selection workflow:
| Data | Purpose |
|---|---|
| Shop name and shop ID | Match the saved Etsy profile to the correct public shop |
| Active listing IDs | Build canonical Etsy listing URLs |
| Listing titles | Pre-fill product labels and pin overlay text |
| Listing descriptions, tags, materials, and personalization flags | Build product-specific pin copy and safe visual prompts |
| Listing images and image alt text | Preserve the real product as the reference for generated product visuals |
| Listing URLs | Send Pinterest traffic back to the selected Etsy listings |
| Listing update timestamps | Show freshness when available |
PinBuilds does not read buyer data, order data, receipts, transactions, buyer emails, private messages, or Etsy sales data.
How Product Import Works
PinBuilds uses Etsy Open API v3 for full active-listing imports when the platform Etsy API key is configured server-side.
The product importer uses:
GET /v3/application/shops?shop_name=...GET /v3/application/shops/{shop_id}/listings/active?limit=100&offset=...GET /v3/application/listings/{listing_id}?includes=Imageswhen selected products are generated
Imports are paginated in batches of up to 100 listings and capped at 1,000 product URLs per import. If the API is unavailable, PinBuilds falls back to Etsy's public shop RSS feed, which may only include a short recent-listing slice.
Dashboard imports are authenticated and rate limited to protect Etsy API quota. If Etsy returns a rate-limit, authorization, or temporary API error, the Dashboard reports the fallback path used.
PinBuilds does not scrape Etsy pages, bypass Etsy protections, or use browser automation to retrieve Etsy data. The only fallback for Etsy product discovery is the public shop RSS feed.
Product-Aware Generation
Etsy listings are not treated like blog articles. During generation, PinBuilds uses listing title, description, tags, materials, personalization/customization flags, and the primary listing image when available.
The product image is used as the reference identity so AI image generation keeps the actual product shape, material, color, and visible details while improving the scene for Pinterest. Product prompts are grouped into focused categories such as personalized gifts, wall art, jewelry, digital templates, Lightroom presets, handmade textiles, and artisan home decor.
PinBuilds avoids unsupported commerce claims in generated product prompts. It does not invent discounts, free shipping, review stars, scarcity claims, Etsy badges, or material/personalization claims that are not present in the listing metadata.
Required Seller Setup
- Go to Settings in PinBuilds.
- Create a profile with Profile Type set to Etsy Shop.
- Enter the shop URL, not an individual listing URL.
- Select the profile on the Dashboard.
- Click Find Products to import product URLs.
- Select products and generate image pins.
Individual Etsy listing URLs can be used during generation after the correct Etsy Shop profile is selected, but the profile itself must use the shop URL.
Pinterest Scheduling
Etsy product pins can be scheduled directly to Pinterest after the seller connects a Pinterest account in PinBuilds Settings. PinBuilds handles Pinterest OAuth, board selection, scheduling windows, and publishing retries through Pinterest's official API.
Etsy OAuth is not required for the public product import workflow because PinBuilds imports public active listing metadata through Etsy Open API v3 or the public RSS fallback.
Data Handling
Generated pins follow the same PinBuilds retention rules as all other content:
- Unscheduled generated history is retained for 7 days.
- Pending scheduled pins are retained until they publish, fail, or are cancelled.
- Completed scheduled records and stored generated images are cleaned up automatically.
- API credentials are stored server-side and are not exposed in the browser.
For details on the broader workflow, see Core Workflows. For API automation, see REST API.