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 listing URLs, select the products they want to promote, generate Pinterest-ready 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 and listing titles.
- Select one product, several products, or the full imported product list.
- Generate 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 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 the Etsy Open API for full-catalog 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=...
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.
PinBuilds does not scrape Etsy pages, bypass Etsy protections, or use browser automation to retrieve Etsy data.
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 the Etsy Open API.
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.